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 returns 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 returned 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+15.1.quarterly>

home | help