XDefaultString
Syntax
char *XDefaultString()
Description
The
XDefaultString()
function returns the default string used by Xlib for text conversion
(for example, in
XmbTextPropertyToTextList()).
The default string is the string in the current locale that is output
when an unconvertible character is found during text conversion.
If the string returned by
XDefaultString()
is the empty string (""),
no character is output in the converted text.
XDefaultString()
does not return NULL.
The string returned by
XDefaultString()
is independent of the default string for text drawing;
see
XCreateFontSet()
to obtain the default string for an
XFontSet.
The behavior when an invalid codepoint is supplied to any Xlib function is
undefined.
The returned string is null-terminated.
It is owned by Xlib and should not be modified or freed by the client.
It may be freed after the current locale is changed.
Until freed, it will not be modified by Xlib.
See also
XmbTextListToTextProperty(),
XwcTextListToTextProperty(),
XmbTextPropertyToTextList(),
XwcTextPropertyToTextList(),
XwcFreeStringList(),
XSetTextProperty(),
XStringListToTextProperty(),
"Converting String Lists".
Christophe Tronche, ch@tronche.com