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)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

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

home | help