strord.3c (2010 09)

strord(3C) strord(3C)

(TO BE OBSOLETED)

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 ﬁle can be right-to-left (non-Latin) or left-to-right (Latin). This text

orientation can affect the way data is arranged in the ﬁle. The data arrangements that result are called

screen order and keyboard order.

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 argu-

ment m is of type nl_mode found in the header ﬁle <

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 overﬂow of the array pointed to by s1.

Obsolescent Interfaces

strord() is to be obsoleted at a future date.

AUTHOR

strord() was developed by HP.

PAGE 1
strord(3C) strord(3C) (TO BE OBSOLETED) NAME strord - convert string data order SYNOPSIS #include 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.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010