Copyright Digital Equipment Corp. All rights reserved.

Return_Value

   x                  Length of the resulting string pointed to
                      by s1, not including the terminating null
                      character.

                      No return value is reserved for error
                      indication. However, the function can set
                      errno to EINVAL - The string pointed to by s2
                      contains characters outside the domain of the
                      collating sequence.