U_CAPI void U_EXPORT2 ucnv_toUnicode (UConverter * converter, UChar ** target, const UChar * targetLimit, const char **source, const char *sourceLimit, int32_t* offsets, bool_t flush, UErrorCode * err)

Converts an array of codepage characters into an array of unicode characters

Documentation

Converts an array of codepage characters into an array of unicode characters. The source pointer is an I/O parameter, it starts out pointing at the place to begin translating, and ends up pointing after the first sequence of the bytes that it encounters that are semantically invalid. if ucnv_setFromUCallBack is called with an action other than STOP before a call is made to this API, consumed and source should point to the same place (unless target ends with an imcomplete sequence of bytes and flush is FALSE).
Parameters:
converter - the Unicode converter
target - : I/O parameter. Input : Points to the beginning of the buffer to copy Unicode characters to. Output : points to after the last UChar copied to target.
targetLimit - the pointer to the end of the target array
source - the source codepage character array
sourceLimit - the pointer to the end of the source array
offsets - if NULL is passed, nothing will happen to it, otherwise it needs to have the same number of allocated cells as target. Will fill in offsets from target to source pointer e.g: offsets[3] is equal to 6, it means that the target[3] was a result of transcoding source[6] For output data carried across calls -1 will be placed for offsets.
flush - TRUE if the buffer is the last buffer and the conversion will finish in this call, FALSE otherwise.
err - the error code status U_ILLEGAL_ARGUMENT_ERROR will be returned if the converter is NULL, or if targetLimit and sourceLimit are misaligned.
See Also:
ucnv_toUChars
ucnv_getNextUChar
ucnv_convert
ucnv_setFromUCallBack

alphabetic index hierarchy of classes

this page has been generated automatically by doc++

(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de