ntohcs

ntohcs

Converts ASCII Characters to EBCDIC

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
PORTABILITY
IMPLEMENTATION
RELATED FUNCTIONS

SYNOPSIS

#include <lclib.h>

int ntohcs(int netchar);

The synopsis for network use is as follows:

#include <sys/types.h>
#include <netinet/in.h>

int ntohcs(int netchar);

DESCRIPTION

ntohcs converts a network ASCII character netchar to a host EBCDIC character. High-order bits will be ignored in input parameters. The name of this function, an abbreviation of "network to host character set," is analogous to the names of the ntohl and ntohs functions. ASCII is the standard character set for text on TCP/IP networks, while EBCDIC is the standard character set for text on OS/390 and CMS systems.

The ntohcs function is provided to facilitate the writing of TCP/IP programs on OS/390 and CMS systems. You may find that other ASCII-to-EBCDIC translation routines are better suited to your requirements.

RETURN VALUE

ntohcs returns the EBCDIC character corresponding to netchar interpreted as an ASCII character.

PORTABILITY

ntohcs is not portable; character set translation is seldom required in other environments.

IMPLEMENTATION

Refer to member L$USKCS in SASC.SOURCE (OS/390) or LSU MACLIB (CMS) for the translate table. This routine may be modified by the user.

RELATED FUNCTIONS

htoncs , htonl , htons , ntohl , ntohs

Chapter Contents
Previous
Next
Top of Page