>># 
>># Copyright 1990, 1991 by the Massachusetts Institute of Technology and
>># UniSoft Group Limited.
>># 
>># Permission to use, copy, modify, distribute, and sell this software and
>># its documentation for any purpose is hereby granted without fee,
>># provided that the above copyright notice appear in all copies and that
>># both that copyright notice and this permission notice appear in
>># supporting documentation, and that the names of MIT and UniSoft not be
>># used in advertising or publicity pertaining to distribution of the
>># software without specific, written prior permission.  MIT and UniSoft
>># make no representations about the suitability of this software for any
>># purpose.  It is provided "as is" without express or implied warranty.
>># 
>># $XConsortium: strlstttxt.m,v 1.8 92/06/11 17:30:30 rws Exp $
>># 
>># 
>>#
>>TITLE XStringListToTextProperty CH09
>>ASSERTION A XStringListToTextProperty-1
A call to XStringListToTextProperty sets the XTextProperty
structure named by the text_prop_return argument such that
the format component is 8, the encoding component is STRING,
the value component is the null-separated concatenation of
count of the character strings specified by the list
argument and terminated with an ASCII nul, the nitems
component is the total number of characters and separating
nulls and returns non-zero.
>>STRATEGY
Create a window using XCreateWindow.
Create a XTextPropertyStructure using XStringListToTextProperty with three strings.
Verify that the call did not return zero.
Verify that the format component is 8.
Verify that the encoding component is STRING.
Verify that the value field is correctly set
Verify that the nitems field is correctly set.
Set the property WM_NAME to the returned XTextProperty using XSetTextProperty.
Verify that no error occurred.
Create a XTextPropertyStructure using XStringListToTextProperty no strings.
Verify that the call did not return zero.
Set the property WM_NAME to the returned XTextProperty using XSetTextProperty.
Verify that no error occurred.
>>ASSERTION B XStringListToTextProperty-2
When insufficient memory is available for the new value
string, then a call to XStringListToTextProperty does not
set any fields in the XTextProperty structure and returns
zero.
>>STRATEGY
Report UNTESTED
>>ASSERTION A XStringListToTextProperty-3
The new value string returned by a call to
XStringListToTextProperty can be freed with XFree.
>>STRATEGY
Create a XTextProperty structure using XStringListToTextProperty.
Verify that the call did not return zero.
Release the allocated memory using XFree.
