pSOSystem System Calls - Read

strxfrm pREPC+ System Calls
strxfrm Transforms a string so that it can be used by the strcmp() function.
#include
size_t strxfrm (
char *s1, /* destination string */
const char *s2 /* source string */
size_t n /* destination string length */
)
Description
Arguments
Return Value
Error Codes
The strxfrm() function transforms the string pointed to by s2 and places the
resulting string into the array pointed to by s1. The transformation is such that if
the strcmp() function is applied to two transformed strings, it returns a value
greater than, equal to, or less than zero, corresponding to the result of the
strcoll() function applied to the same two original strings. No more than n
characters are placed into the resulting array pointed to by s1, including the
terminating null character. If n is zero, s1 is permitted to be a null pointer. If
copying takes place between objects that overlap, the behavior is undefined.
The main use for this function is in foreign language environments that do not use
the ASCII collating sequence.
s1 Points to the array where strxfrm() places the resulting string.
s2 Points to the string to be transformed.
n Specifies the number of characters to be placed in s1.
The strxfrm() function returns the length of the transformed string (not including
the terminating null character.) If the value is n or more, the contents of the array
pointed to by s1 are indeterminate.
None.
3-172 pSOSystem System Calls