Copyright Digital Equipment Corp. All rights reserved.

Return_Values

   x                  The number of bytes that comprise the valid
                      character pointed to by s.
   0                  If s is either a NULL pointer or a pointer to
                      the null byte.
   -1                 Indicates an error. The function sets errno to
                      EILSEQ - Invalid character detected.