strord(3C)strord(3C)NAMEstrord - convert string data order
SYNOPSISDESCRIPTION
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.
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).
returns s1.
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
The mode argument can have two possible values: and
If the mode argument is the text orientation is left-to-right, and all
non-Latin sub-strings are reversed. Non-Latin sub-strings are any num‐
ber of contiguous right-to-left language characters. Non-Latin sub-
strings are delimited by ASCII characters.
Similarly, if the mode argument is 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 category determines whether a right-to-left language has alterna‐
tive numbers.
International Code Set Support
Single-byte character code sets are supported.
WARNINGS
does not check for overflow of the array pointed to by s1.
Obsolescent Interfaces
is to be obsoleted at a future date.
AUTHOR
was developed by HP.
SEE ALSOforder(1), nljust(1), setlocale(3C), environ(5), thread_safety(5).
TO BE OBSOLETED strord(3C)