Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Summary►                                   ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The strxfrm function transforms the string pointed to by <string2>
     into the array pointed to by <string1>. The transformation is such
     that a call to strcmp with two transformed strings yields results
     identical to a call to strcoll applied to the original two
     strings.
 
     No more than <count> number of characters (including the null
     character) are transformed and placed into the resulting string.
 
     The value of the following expression is the size of the array
     needed to hold the transformation of the source string:
 
          1 + strxfrm( NULL, string, 0 )
 
     Currently, the C libraries support the "C" locale only. Thus,
     strxfrm is equivalent to the following:
 
          strncpy( string1, string2, count );
          return( strlen( string2 ) );
 
     Return Value
 
     The strxfrm function returns the length of the transformed string,
     excluding the terminating null character. If the return value is
     greater than or equal to <count>, the contents of <string1> are
     unpredictable.
                                    -♦-