strord(3C)																strord(3C)

NAME

       strord - convert string data order

SYNOPSIS

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.

       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
       number 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 alternative 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 ALSO

       forder(1), nljust(1), setlocale(3C), environ(5), thread_safety(5).

								  TO BE OBSOLETED							strord(3C)