Overview | Module | Use | Devguide | Index

Methods' Summary | Attributes' Summary | Methods' Details | Attributes' Details

:: com :: sun :: star :: util ::
interface XURLTransformer
Description supports parsing and assembling of URLs See also URL, URLTransformer

Methods' Summary
parseStrict | parses the string in URL::Complete which should contain a syntactically complete URL.
parseSmart | parses the string in URL::Complete, which may contain a syntactically complete URL or is specified by the provided protocol
assemble | assembles the parts of the URL specified by aURL and stores it into URL::Complete
getPresentation | returns a representation of the URL for UI purposes only

Methods' Details
parseStrict
boolean
parseStrict( | [inout] URL | aURL );
Description parses the string in URL::Complete which should contain a syntactically complete URL. The implementation is allowed to correct minor failures in URL::Complete if the meaning of the URL remain unchanged. Parts of the URL are stored in the other fields of aURL. Parameter aURL the URL which include the complete string notation and will contain all parsed parts of it after finishing this call. URL::Complete can be overwritten if the implementation corrected minor failures. Returns true if parsing was successfully (means if given URL was syntactically correct) or false otherwise.
parseSmart
boolean
parseSmart( | [inout] URL | aURL,
| [in] string | sSmartProtocol );
Description parses the string in URL::Complete, which may contain a syntactically complete URL or is specified by the provided protocol The implementation can use smart functions to correct or interpret URL::Complete if it is not a syntactically complete URL. The parts of the URL are stored in the other fields of aURL. Parameter aURL the URL which include the string notation and will contain all parsed parts of it after finishing this call. This includes URL::Complete. Parameter sSmartProtocol optional information which protocol specification should be used to parse memberURL::Complete. If empty the implementation can use a protocol which fit best. Returns true if parsing was successful (means if URL::Complete could be syntactically correct) or false otherwise.
assemble
boolean
assemble( | [inout] URL | aURL );
Description assembles the parts of the URL specified by aURL and stores it into URL::Complete Parameter aURL the URL which contains alls necessary information in a structured form. The member URL::Complete contains the URL in string notation after the operation finished successfully. Otherwise the content of URL::complete is not defined. Returns true if assembling was successfully or false otherwise.
getPresentation
string
getPresentation( | [in] URL | aURL,
| [in] boolean | bWithPassword );
Description returns a representation of the URL for UI purposes only Sometimes it can be useful to show an URL on an user interface in a more "human readable" form. Such URL can't be used on any API call, but make it easier for the user to understand it. Parameter aURL URL in structured form which should be shown at the UI Parameter bWithPassword specifies whether the password will be included in the encoding or not. Usually passwords should never be shown at the user interface. Returns a string representing the aURL if it is syntactically correct. A empty string if aURL is not syntactically correct.

Top of Page

Copyright © 2000, 2014 LibreOffice contributors and/or their affiliates. All rights reserved.

LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.

The Document Foundation acknowledges all community members, please find more info at our website.

Privacy Policy | Impressum (Legal Info) | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (LGPLv3). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.