Copyright Digital Equipment Corp. All rights reserved.

Return_Values

   x                  The number of bytes that comprise the
                      multibyte character, if the next n or fewer
                      bytes form a valid character.
   0                  If s is NULL or a pointer to the NULL
                      character.
   -1                 Indicates an error. The function sets errno to
                      EILSEQ - Invalid character detected.