Overview | Namespace | Class | Index | Help |
rtl_UriCharClass | eCharClass ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
eCharClass | Any valid member of rtl_UriCharClass. |
rtl_uString * | pBaseUriRef, |
rtl_uString * | pRelUriRef, |
rtl_uString * * | pResult, |
rtl_uString * * | pException ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pBaseUriRef | An absolute, hierarchical URI reference that serves as the base URI. If it has to be inspected (i.e., pRelUriRef is not an absolute URI already), and if it either is not an absolute URI (i.e., does not begin with a |
pRelUriRef | An URI reference that may be either absolute or relative. If it is absolute, it will be returned unmodified (and it need not be hierarchical then). |
pResult | Returns an absolute URI reference. Must itself not be null, and must point to either null or a valid string. If an exception is signalled, it is left unchanged. |
pException | Returns an explanatory message in case an exception is signalled. Must itself not be null, and must point to either null or a valid string. If no exception is signalled, it is left unchanged. |
rtl_uString * | pText, |
rtl_UriDecodeMechanism | eMechanism, |
rtl_TextEncoding | eCharset, |
rtl_uString * * | pResult ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pText | Any Unicode string. Must not be null. (If the input is indeed part of a valid URI, this string will only contain a subset of the ASCII characters, but this function also handles other Unicode characters properly.) |
eMechanism | The mechanism describing how the input text is translated into a Unicode string. |
eCharset | When the decode mechanism is rtl_UriDecodeWithCharset, all escape sequences in the input text are interpreted as characters from this charset. Those characters are translated to Unicode characters in the resulting output, if possible. When the decode mechanism is rtl_UriDecodeNone or rtl_UriDecodeToIuri, this parameter is ignored (and is best specified as RTL_TEXTENCODING_UTF8). |
pResult | Returns a decoded representation of the input text. Must itself not be null, and must point to either null or a valid string. If the decode mechanism is rtl_UriDecodeStrict, and pText cannot be converted to eCharset because it contains (encodings of) unmappable characters (which implies that pText is not empty), then an empty string is returned. |
rtl_uString * | pText, |
const sal_Bool * | pCharClass, |
rtl_UriEncodeMechanism | eMechanism, |
rtl_TextEncoding | eCharset, |
rtl_uString * * | pResult ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pText | Any Unicode string. Must not be null. |
pCharClass | A char class, represented as an array of 128 booleans (true means keep the corresponding ASCII character unencoded, false means encode it). Must not be null, and the boolean corresponding to the percent sign (0x25) must be false. (See rtl_getUriCharClass() for a function mapping from rtl_UriCharClass to such arrays.) |
eMechanism | The mechanism describing how escape sequences in the input text are handled. |
eCharset | When Unicode characters from the input text have to be written using escape sequences (because they are either outside the ASCII range or do not belong to the given char class), they are first translated into this charset before being encoded using escape sequences. Also, if the encode mechanism is rtl_UriEncodeCheckEscapes, all escape sequences already present in the input text are interpreted as characters from this charset. |
pResult | Returns an encoded representation of the input text. Must itself not be null, and must point to either null or a valid string. If the encode mechanism is rtl_UriEncodeStrict, and pText cannot be converted to eCharset because it contains unmappable characters (which implies that pText is not empty), then an empty string is returned. |
Copyright © 1995, 2012, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.