Chapter Contents

Previous

Next
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

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.