__a2e_s() — Convert string from ASCII to EBCDIC

Standards

Standards / Extensions	C or C++	Dependencies
	both	z/OS V1R2

Format

#include <unistd.h>

size_t  __a2e_s(char  *string)

General description

The __a2e_s() function converts a string from ASCII to EBCIDIC, returning the string length if successful or -1 if not. Conversion occurs in place in the string. __a2e_s() is not sensitive to the locale, and only converts between ISO8859-1 and IBM-1047.

Note: This function is valid for applications compiled XPLINK only.

Returned value

If successful, __a2e_s() returns the string length.

If unsuccessful, __a2e_s() returns -1 and sets errno to the following value:

Error Code: Description
EINVAL: The pointer to string is NULL.

Related information

unistd.h
__a2e_l() — Convert characters from ASCII to EBCDIC
__e2a_l() — Convert characters from EBCDIC to ASCII
__e2a_s() — Convert string from EBCDIC to ASCII