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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmStringByteCompare  --  A  compound string function that indicates the re-
     sults of a byte-by-byte comparison

SYNOPSIS
     #include <Xm/Xm.h>
     Boolean XmStringByteCompare(
     XmString s1,
     XmString s2);

DESCRIPTION
     This function is obsolete and exists for compatibility  with  previous  re-
     leases. It is replaced by XmStringCompare.

     XmStringByteCompare  returns a Boolean indicating the results of a byte-by-
     byte comparison of two compound strings.

     In general, if two compound strings are created  with  the  same  (char  *)
     string  using XmStringCreateLocalized in the same language environment, the
     compound strings compare as equal.  If two  compound  strings  are  created
     with  the same (char *) string and the same font list element tag set other
     than XmFONTLIST_DEFAULT_TAG using XmStringCreate, the  strings  compare  as
     equal.

     In  some cases, once a compound string is put into a widget, that string is
     converted into an internal form to allow faster  processing.  Part  of  the
     conversion  process  strips out unnecessary or redundant information. If an
     application then does an XtGetValues to retrieve a compound string  from  a
     widget  (specifically,  Label and all of its subclasses), it is not guaran-
     teed that the compound string returned is byte-for-byte  the  same  as  the
     string given to the widget originally.

     s1        Specifies a compound string to be compared with s2

     s2        Specifies a compound string to be compared with s1

RETURN
     Returns True if two compound strings are identical byte-by-byte.

RELATED
     XmStringCreate(3) and XmStringCreateLocalized(3).

							  XmStringByteCompare(3)

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

home | help