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►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The strxfrm function transforms the string pointed to by
     <src> into a new collated form that is stored in <dest>.
     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> characters (including the null character) are
     transformed and placed into the resulting string.
 
     The transformation is made using the locale-specific information
     set by the setlocale function. After the transformation, a call to
     strcmp with the two transformed strings will yield identical
     results to a call to strcoll applied to the original two strings.
 
     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 run-time library supports the "C" locale only.
     Thus, strxfrm is equivalent to the following:
 
          strncpy( dest, src, count );
          return( strlen( dest ) );
 
     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 <dest> are
     unpredictable.
                                    -♦-