


     wcstombs(XPG4.os/stRelease	4.4.1 (UniSoftwcstombs(XPG4.os/string)



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

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

     TESTS
     Compliance
	  1    When s is not a null pointer, and pwcs is not a null
	       pointer,	then a call to wcstombs(s,pwcs,n) stores in
	       the array pointed to by s the multibyte character
	       representations of the sequence of codes	in the array
	       pointed to by pwcs stopping if either a null byte is
	       stored or the representation of a code would cause more
	       than n bytes to be stored, and returns the number of
	       bytes stored in s excluding the terminating null	byte,
	       if any.

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

	  3    When s is a null	pointer, then a	call to
	       wcstombs(s,pwcs,n) returns the number of	bytes required
	       to store	the converted string, excluding	the
	       terminating null	byte.

	  4    If an invalid wchar_t value exists for the
	       implementation:
		   When	there is no valid multibyte character
		   representation for a	code in	the array pointed to
		   by pwcs which would otherwise be stored in the
		   array pointed to by s, then a call to
		   wcstombs(s,pwcs,n) returns (size_t) -1.

     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)



