strord(3C)

NAME

strord − convert string data order

SYNOPSIS

#include <nl_types.h>

char *strord(char *s1, const char *s2, nl_mode m);

DESCRIPTION

The text orientation (mode) of a file can be right-to-left (non-Latin) or left-to-right (Latin). This text orientation can affect the way data is arranged in the file. The data arrangements that result are called screen order and keyboard order (see hpnls(5) for more details).

strord() converts the order of characters in s2 from screen to keyboard order or vice versa and places the result in s1. The arguments s1 and s2 point to strings (arrays of characters terminated by a null character). strord() returns s1.

strord() performs the conversion based on mode information indicated by the argument m. The argument m is of type nl_mode found in the header file <nl_types.h>. The mode argument can have two possible values: NL_LATIN and NL_NONLATIN.

If the mode argument is NL_LATIN, the text orientation is left-to-right, and all non-Latin sub-strings are reversed. Non-Latin sub-strings are any number of contiguous right-to-left language characters. Non-Latin sub-strings are delimited by ASCII characters.

Similarly, if the mode argument is NL_NONLATIN, the text orientation is right-to-left and all Latin sub-strings are reversed. Latin sub-strings are any number of contiguous printable ASCII characters. Latin sub-strings are delimited by right-to-left language characters and ASCII control codes.

Some right-to-left languages have a duplicate set of digits called alternative numbers. Alternative numbers always have a left-to-right orientation.

EXTERNAL INFLUENCES

Locale

The LC_NUMERIC category determines whether a right-to-left language has alternative numbers.

International Code Set Support

Single-byte character code sets are supported.

WARNINGS

strord() does not check for overflow of the array pointed to by s1.

AUTHOR

strord() was developed by HP.

Museum

Related Articles