Standards / Extensions | C or C++ | Dependencies |
---|---|---|
z/OS® UNIX |
both | z/OS V1R2 |
#include <_Nascii.h>
__argument_t __ae_correstbl_query(void *search_argument, int src_arg_type,
_AE_correstbl_t **ebcdic_entry_ptr,
_AE_correstbl_t **ascii_entry_ptr);
The __ae_correstbl_query() function is a method by which the user can obtain coded character set id (CCSID), type, and correspondence information from the EBCDIC/ASCII Correspondence and CCSID/Codeset Name Lookup Table, CEL4CTBL.
The function will then populate the supplied pointers with the address of _AE_correstbl_t structures containing the requested codeset's table entry as well as the address of the corresponding codeset's entry. However, not every EBCDIC codeset in the table has a corresponding ASCII encoding and vice versa. When a corresponding codeset does not exist, the pointer value returned in that argument is zero.
For consistency, the first _AE_correstbl_t pointer address argument will be populated with the EBCDIC entry address, and the second _AE_correstbl_t pointer will be populated with the ASCII entry address, regardless of which was the requested codeset and which was the corresponding codeset.
The __argument_t return value for __ae_correstbl_query() indicates the EBCDIC or ASCII type of the provided codeset.
If unsuccessful, because the correspondence table cannot be loaded or the provided Codeset Name or CCSID is not valid, __ae_correstbl_query() returns _AE_UNKNOWN_TYPE.