This section contains an OCI locale-mapping function.
Table 21-4 OCI Locale-Mapping Function
Function/Page | Purpose |
---|---|
Maps Oracle character set names, language names, and territory names to and from Internet Assigned Numbers Authority (IANA) and International Organization for Standardization (ISO) names. |
Maps Oracle character set names, language names, and territory names to and from Internet Assigned Numbers Authority (IANA) and International Organization for Standardization (ISO) names.
sword OCINlsNameMap ( dvoid *hndl, oratext *buf, size_t buflen, CONST oratext *srcbuf, uword flag );
OCI environment or session handle. If the handle is invalid, then the function returns OCI_INVALID_HANDLE
.
Points to the destination buffer. If the function returns OCI_SUCCESS
, then the parameter contains a NULL
-terminated string for the requested name.
The size of the destination buffer. The recommended size is OCI_NLS_MAXBUFSZ
to guarantee storage of a globalization support name. If the size of the destination buffer is smaller than the length of the name, then the function returns OCI_ERROR
.
Pointer to a NULL
-terminated globalization support name. If it is not a valid name, then the function returns OCI_ERROR
.
It specifies the direction of the name mapping and can take the following values:
OCI_NLS_CS_IANA_TO_ORA
: Map character set name from IANA to OracleOCI_NLS_CS_ORA_TO_IANA
: Map character set name from Oracle to IANA.OCI_NLS_LANG_ISO_TO_ORA
: Map language name from ISO to OracleOCI_NLS_LANG_ORA_TO_ISO
: Map language name from Oracle to ISOOCI_NLS_TERR_ISO_TO_ORA
: Map territory name from ISO to OracleOCI_NLS_TERR_ORA_TO_ISO
: Map territory name from Oracle to ISOOCI_NLS_TERR_ISO3_TO_ORA
: Map territory name from 3-letter ISO abbreviation to Oracle
OCI_NLS_TERR_ORA_TO_ISO3
: Map territory name from Oracle to 3-letter ISO abbreviation
OCI_SUCCESS
, OCI_INVALID_HANDLE
, or OCI_ERROR
.