


     wctomb(XPG4.os/striRelease	4.4.1 (UniSoft Lwctomb(XPG4.os/string)



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

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

     TESTS
     Compliance
	  1    When s is not null and wchar corresponds	to a multibyte
	       character, then a call to wctomb(s,wchar) places	the
	       multibyte character in the array	pointed	to by s	and
	       returns the number of bytes in that multibyte
	       character.

	  2    When s is a null	pointer, and multibyte character
	       encodings do not	have state dependent encodings in the
	       current locale, then a call to wctomb(s,wchar) returns
	       a value of zero.

	  3    When s is a null	pointer, and the LC_CTYPE category of
	       the current locale is set to the	'C' locale, then a
	       call to wctomb(s,wchar) returns a value of zero.

	  4    If an invalid wchar_t value exists for the
	       implementation:
		   When	s is not null and wchar	does not correspond to
		   a multibyte character, then a call to
		   wctomb(s,wchar) returns -1.

     Untestable	Aspects
	  1    When s is a null	pointer, and multibyte character
	       encodings have state dependent encodings	in the current
	       locale, then a call to wctomb(s,wchar) returns a	value
	       which is	not zero.
	       Reason for omission:
	       The testing of state dependent encodings	is beyond the
	       scope of	VSX4.

     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)



