Copyright Digital Equipment Corp. All rights reserved.

Return_Values

   x                  The number of bytes stored in the resulting
                      array, not including the terminating null (if
                      any).
   -1                 Indicates an encoding error-a character that
                      does not correspond to a valid multibyte
                      character was encountered; errno is set to
                      EILSEQ; the conversion state is undefined.