


     mbstowcs(XPG4.os/stRelease	4.4.1 (UniSoftmbstowcs(XPG4.os/string)



     NAME
	  XPG4.os/string/mbstowcs - convert multibyte character	string
	  to wide character string.

     DESCRIPTION
	  Mbstowcs tests the mbstowcs()	subroutine call	interface for
	  conformance to the XSI System	Interface Page:mbstowcs()

     TESTS
     Compliance
	  1    When s points to	a string of valid multibyte
	       characters, then	a call to mbstowcs(pwcs,s,n) places
	       the wide	character values associated with each
	       multibyte character in s	into the wide character	array
	       pointed to by pwcs, stopping after either n wide
	       characters have been stored or a	wide character with
	       value (wchar_t) 0 has been stored and returns the
	       number of wide characters stored	excluding the
	       terminating (wchar_t) 0,	if any.

	  2    When pwcs is a null pointer, then a call	to
	       mbstowcs(pwcs,s,n) returns the number of	wide
	       characters required to store the	converted string,
	       excluding the terminating (wchar_t) 0.

	  3    When s points to	a sequence of n	bytes which contain an
	       invalid multibyte character, then a call	to
	       mbstowcs(pwcs,s,n) returns (size_t) -1.

	  4    When s points to	a null byte, then a call to
	       mbstowcs(pwcs,s,n) places the value (wchar_t) 0 in the
	       object pointed to by pwcs and returns a value of	zero.

     OUTPUTS
     Tests:
	  1-4  Pass/Fail indication - Failure information includes
	       expected	and actual return values

     RELEASE
	  4.4.1	(06/09/97)















     Page 1					    (printed 2/21/103)



