Apache Portable Runtime
|
Macros | |
#define | APR_DEFAULT_CHARSET (const char *)0 |
#define | APR_LOCALE_CHARSET (const char *)1 |
Typedefs | |
typedef struct apr_xlate_t | apr_xlate_t |
Functions | |
apr_status_t | apr_xlate_open (apr_xlate_t **convset, const char *topage, const char *frompage, apr_pool_t *pool) |
apr_status_t | apr_xlate_sb_get (apr_xlate_t *convset, int *onoff) |
apr_status_t | apr_xlate_conv_buffer (apr_xlate_t *convset, const char *inbuf, apr_size_t *inbytes_left, char *outbuf, apr_size_t *outbytes_left) |
apr_int32_t | apr_xlate_conv_byte (apr_xlate_t *convset, unsigned char inchar) |
apr_status_t | apr_xlate_close (apr_xlate_t *convset) |
#define APR_DEFAULT_CHARSET (const char *)0 |
This is to indicate the charset of the sourcecode at compile time names to indicate the charset of the source code at compile time. This is useful if there are literal strings in the source code which must be translated according to the charset of the source code.
#define APR_LOCALE_CHARSET (const char *)1 |
To indicate charset names of the current locale
typedef struct apr_xlate_t apr_xlate_t |
Opaque translation buffer
apr_status_t apr_xlate_close | ( | apr_xlate_t * | convset | ) |
Close a codepage translation handle.
convset | The codepage translation handle to close |
apr_status_t apr_xlate_conv_buffer | ( | apr_xlate_t * | convset, |
const char * | inbuf, | ||
apr_size_t * | inbytes_left, | ||
char * | outbuf, | ||
apr_size_t * | outbytes_left | ||
) |
Convert a buffer of text from one codepage to another.
convset | The handle allocated by apr_xlate_open, specifying the parameters of conversion |
inbuf | The address of the source buffer |
inbytes_left | Input: the amount of input data to be translated Output: the amount of input data not yet translated |
outbuf | The address of the destination buffer |
outbytes_left | Input: the size of the output buffer Output: the amount of the output buffer not yet used |
To correctly terminate the output buffer for some multi-byte character set encodings, a final call must be made to this function after the complete input string has been converted, passing the inbuf and inbytes_left parameters as NULL. (Note that this mode only works from version 1.1.0 onwards)
apr_int32_t apr_xlate_conv_byte | ( | apr_xlate_t * | convset, |
unsigned char | inchar | ||
) |
Convert a single-byte character from one charset to another.
convset | The handle allocated by apr_xlate_open, specifying the parameters of conversion |
inchar | The single-byte character to convert. |
apr_status_t apr_xlate_open | ( | apr_xlate_t ** | convset, |
const char * | topage, | ||
const char * | frompage, | ||
apr_pool_t * | pool | ||
) |
Set up for converting text from one charset to another.
convset | The handle to be filled in by this function |
topage | The name of the target charset |
frompage | The name of the source charset |
pool | The pool to use |
apr_status_t apr_xlate_sb_get | ( | apr_xlate_t * | convset, |
int * | onoff | ||
) |
Find out whether or not the specified conversion is single-byte-only.
convset | The handle allocated by apr_xlate_open, specifying the parameters of conversion |
onoff | Output: whether or not the conversion is single-byte-only |