__toCSName() — Convert coded character set ID to codeset name
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
z/OS® UNIX |
both | z/OS V1R2 |
Format
#include <_Ccsid.h>
int __toCSName(__ccsid_t Ccsid, char *codesetName);
General description
The __toCSName() function returns the codeset name, corresponding to coded character codeset ID, Ccsid, in codesetName.
Returned value
If successful, __toCSName() returns 0 and stores the codeset name in codesetName, when a corresponding codeset name exists for Ccsid.
If unsuccessful, __toCSName() returns -1.
If __toCSName() returns
-1 for a reason other than no corresponding codeset name exists,
it sets errno to one of the following values:
- Error Code
- Description
- EINVAL
- The corresponding codesetName length is greater than _CSNAME_LEN_MAX as defined in header <_Ccsid.h>.