Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for xmstringgetnextcomponent (redhat section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

XmStringGetNextComponent(library call)			   XmStringGetNextComponent(library call)

       XmStringGetNextComponent  -- A compound string function that returns the type and value of
       the next component in a compound string

       #include <Xm/Xm.h>
       XmStringComponentType XmStringGetNextComponent(
       XmStringContext context,
       char **text,
       XmStringTag *tag,
       XmStringDirection *direction,
       XmStringComponentType *unknown_tag,
       unsigned short *unknown_length,
       unsigned char **unknown_value);

       This function is obsolete and exists for  compatibility	with  previous	releases.  It  is
       replaced by XmStringGetNextTriple.  XmStringGetNextComponent returns the type and value of
       the next component in the compound string identified by context.  Components are  returned
       one  at	a  time.  On return, only some output parameters will be valid; which ones can be
       determined by examining the returned component type.  The following  table  describes  the
       valid returns for each component type.

       |Valid Fields	     | Component Type			|
       |tag		     | XmSTRING_COMPONENT_LOCALE,	|
       |		     | XmSTRING_COMPONENT_TAG		|
       |text		     | XmSTRING_COMPONENT_LOCALE_TEXT,	|
       |		     | XmSTRING_COMPONENT_TEXT, 	|
       |direction	     | XmSTRING_COMPONENT_DIRECTION	|
       |unknown_tag,	     | XmSTRING_COMPONENT_LAYOUT_POP,	|
       |unknown_length,      | XmSTRING_COMPONENT_LAYOUT_PUSH,	|
       |unknown_value	     | XmSTRING_COMPONENT_TAB,		|
       |		     | XmSTRING_COMPONENT_RENDI-	|
       |		     | TION_BEGIN,	XmSTRING_COMPO- |
       |		     | NENT_RENDITION_END		|
       |no valid field	     | XmSTRING_COMPONENT_SEPARATOR,	|
       |		     | XmSTRING_COMPONENT_END,		|
       Note  that  several  components	produce a return value of XmSTRING_COMPONENT_UNKNOWN. The
       data returned by these components is returned  in  the  unknown_tag,  unknown_length,  and
       unknown_value fields. This apparent inconsistency is designed to accomodate older applica-
       tions that may not be equipped to handle the newer component types of  Motif  version  2.0
       and  beyond.  Consequently, the use of this procedure is not recommended. Instead, use the
       XmStringGetNextTriple procedure, which provides	all  the  functionality  of  XmStringGet-
       NextComponent, and is fully compatible with the newer component types.

       If the function return value is XmSTRING_COMPONENT_LOCALE_TEXT or XmSTRING_COMPONENT_TEXT,
       the the function allocates space to hold the returned text.  If the function return  value
       allocates space to hold the returned tag.  The application is responsible for managing the
       allocated space.  The application can recover the allocated space by calling XtFree.

       context	 Specifies  the  string context structure that was allocated by the XmStringInit-
		 Context function.

       text	 Specifies a pointer to a NULL terminated string.

       tag	 Specifies a pointer to the tag component associated with  the	text.  The  value
		 XmFONTLIST_DEFAULT_TAG identifies a locale text segment.

       direction Specifies a pointer to the direction of the text.

		 Specifies a pointer to the tag of an unknown component.

		 Specifies a pointer to the length of an unknown component.

		 Specifies a pointer to the value of an unknown component.

       Returns the type of component found.  Refer to the XmStringComponentType(3) reference page
       for a list of component types.

       XmStringComponentType(3), XmStringCreate(3), and XmStringInitContext(3).

							   XmStringGetNextComponent(library call)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 12:05 PM.