Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmStringGetNextSegment(3)  Library Functions Manual  XmStringGetNextSegment(3)

NAME
       XmStringGetNextSegment  --  A compound string function that fetches the
       bytes in	the next segment of a compound string

SYNOPSIS
       #include	<Xm/Xm.h>
       Boolean XmStringGetNextSegment(
       XmStringContext context,
       char **text,
       XmStringTag *tag,
       XmStringDirection *direction,
       Boolean *separator);

DESCRIPTION
       This routine is obsolete	and exists for compatibility with previous re-
       leases. To read the contents of a compound string, read each  component
       of  the	string	with XmStringGetNextTriple. This XmString function re-
       turns the type, length, and value of the	next component in the compound
       string.	XmStringGetNextSegment fetches the bytes in the	next  segment;
       repeated	 calls fetch sequential	segments. The text, tag, and direction
       of the fetched segment are returned each	time. A	Boolean	status is  re-
       turned to indicate whether a valid segment was successfully parsed.

       If the function returns True, then the function allocates space to hold
       the  returned text and 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	which was allocated by
		 the XmStringInitContext function

       text	 Specifies a pointer to	a NULL-terminated string

       tag	 Specifies a pointer to	the font list element  tag  associated
		 with the text

       direction Specifies a pointer to	the direction of the text

       separator Specifies  whether  the next component	of the compound	string
		 is a separator

RETURN
       Returns True if a valid segment is found.

RELATED
       XmStringCreate(3) and XmStringInitContext(3).

						     XmStringGetNextSegment(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmStringGetNextSegment&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help