xmstringcreate(3) [redhat man page]

XmStringCreate(library call)											      XmStringCreate(library call)

NAME

       XmStringCreate -- A compound string function that creates a compound string

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringCreate(
       char *text,
       char *tag);

DESCRIPTION

       XmStringCreate  creates	a compound string with two components: text and a font list element tag.  The function will allocate space to hold
       the returned compound string.  When the application no longer needs the returned compound string, the application should call XmStringFree.

       text	 Specifies a NULL-terminated string to be used as the text component of the compound string.

       tag	 Specifies the tag component to be associated with the given text. The value XmFONTLIST_DEFAULT_TAG identifies a locale text  seg-
		 ment.

RETURN

       Returns a new compound string.

RELATED

       XmFontList(3),  XmFontListAdd(3), XmFontListAppendEntry(3), XmFontListCopy(3), XmFontListCreate(3), XmFontListEntryCreate(3), XmFontListEn-
       tryFree(3), XmFontListEntryGetFont(3), XmFontListEntryGetTag(3), XmFontListEntryLoad(3),  XmFontListFree(3),  XmFontListFreeFontContext(3),
       XmFontListGetNextFont(3), XmFontListInitFontContext(3), XmFontListNextEntry(3), XmFontListRemoveEntry(3), XmString(3), XmStringBaseline(3),
       XmStringByteCompare(3),	XmStringCompare(3),   XmStringConcat(3),   XmStringCopy(3),   XmStringCreateLocalized(3),   XmStringCreateLtoR(3),
       XmStringCreateSimple(3), XmStringDirection(3), XmStringDirectionCreate(3), XmStringDraw(3), XmStringDrawImage(3), XmStringDrawUnderline(3),
       XmStringEmpty(3), XmStringExtent(3), XmStringFree(3), XmStringFreeContext(3), XmStringGetLtoR(3), XmStringGetNextComponent(3), XmStringGet-
       NextSegment(3),	XmStringHasSubstring(3), XmStringHeight(3), XmStringInitContext(3), XmStringLength(3), XmStringLineCount(3), XmStringNCon-
       cat(3),	XmStringNCopy(3),  XmStringPeekNextComponent(3),  XmStringSegmentCreate(3),  XmStringSeparatorCreate(3),   XmStringTable(3),   and
       XmStringWidth(3).

														      XmStringCreate(library call)

XmStringGenerate(library call)											    XmStringGenerate(library call)

NAME

       XmStringGenerate -- A convenience function that generates a compound string

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringGenerate(
       XtPointer text,
       XmStringTag tag,
       XmTextType type,
       XmStringTag rendition);

DESCRIPTION

       XmStringGenerate  calls the XmStringParseText function with a default parse table of entries consisting of '', which maps to Separator, and
       '', which maps to Tab.  Matching RENDITION_BEGIN and  RENDITION_END  components	containing  rendition  are  placed  around  the  resulting
       XmString.

       text	 Specifies a NULL-terminated string containing characters of a type determined by type.

       tag	 Specifies the tag to be used in creating the result. The type of tag created (charset or locale) depends on the text type and the
		 value given. If specified value is NULL, and type indicates that a charset tag should be created, then  the  tag  will  have  the
		 value	of  XmFONTLIST_DEFAULT_TAG.   If  tag  is  NULL,  and  type  indicates	a  locale tag, then the tag will have the value of
		 _MOTIF_DEFAULT_LOCALE.

       type	 Specifies the type of text to be passed in, and the tag type.	If a locale tag should be created, then type has a value of either
		 XmMULTIBYTE_TEXT or XmWIDECHAR_TEXT. If a charset should be created, type has a value of XmCHARSET_TEXT.

       rendition Specifies  the  rendition  tag to be used in an XmSTRING_COMPONENT_RENDITION_BEGIN component which will begin the returned string
		 and in an XmSTRING_COMPONENT_RENDITION_END component which will end it.  If rendition is NULL, no rendition tag is placed.

RETURN

       Returns a new compound string.  The function will allocate space to hold the returned compound string.	When  the  application	no  longer
       needs the returned compound string, the application should call XmStringFree.

RELATED

       XmString(3) and XmStringFree(3).

														    XmStringGenerate(library call)