Initializing help system before first use

XNLSconvbufto

XNLSconvbufto

Purpose
Convert a text buffer from UTF-8 to a given encoding.
Synopsis
int XNLSconvbufto(int eid, char **srcstart, char *srcend, char **dststart, char *dstend, int flags);
Arguments
eid 
Encoding ID of the destination
srcstart 
Reference to a pointer at the beginning of the input buffer
srcend 
Pointer to the character after the end of the input buffer
dststart 
Reference to a pointer at the beginning of the output buffer
dstend 
Pointer to the character after the end of the output buffer
flags 
Conversion flags (can be combined):
XNLS_UTF_FLAG_STRICT 
Fail in case of invalid sequence (otherwise skip it)
XNLS_UTF_FLAG_PARTIAL 
Stop and return XNLS_CONV_PARTIAL buffer ends on an incomplete sequence (instead of failing)
Return value
XNLS_CONV_OK 
Function executed sucessfully
XNLS_CONV_PARTIAL 
Input buffer terminates on an incomplete sequence (process stopped at the beginning of the sequence)
XNLS_CONV_DSTOUT 
Output buffer not large enough
XNLS_CONV_FAIL 
Process stopped at an invalid sequence
Further information
The arguments srcstart and dststart are updated such that they point to the byte following the decoded sequence (input buffer) or the first unused byte (output buffer) after the function returns.
Related topics
XNLSconvbuffrom, XNLSconvstrto.

Parent Topic Buffer and string encoding conversion

© 2001-2020 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.