__toCcsid() — Convert codeset name to coded character set ID

Standards

Standards / Extensions C or C++ Dependencies

z/OS® UNIX

both z/OS V1R2

Format

#include <_Ccsid.h>

__ccsid_t __toCcsid(char *codesetName);

General description

The __toCcsid() function returns the coded character set ID corresponding to the provided codesetName argument.

Returned value

If successful, __toCcsid() returns the corresponding CCSID for codesetName, if one exists. The returned __ccsid_t type is defined in <_Ccsid.h> as an unsigned short.

If unsuccessful, __toCcsid() returns 0 and sets errno to one of the following values:
Error Code
Description
EINVAL
The length of the codesetName argument is greater than _CSNAME_LEN_MAX as defined in header <_Ccsid.h>.

Related information