__e2a_l() — Convert characters from EBCDIC to ASCII

Standards

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

Format

#include <unistd.h>

size_t  __e2a_l(char  *bufptr, size_t  szLen)

General description

The __e2a_l() function converts szLen characters in bufptr between IBM-1047 and ISO8859-1, returning the number of characters converted if successful or -1 if not. Conversion occurs in place in the buffer. __e2a_l() 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, __e2a_l() returns the number of characters converted.

If unsuccessful, __e2a_l() returns -1 and sets errno to the following value:
Error Code
Description
EINVAL
The pointer to bufptr is NULL or szLen is a negative value.