1XmStringByteCompare(library call)            XmStringByteCompare(library call)
2
3
4

NAME

6       XmStringByteCompare  —  A  compound  string function that indicates the
7       results of a byte-by-byte comparison
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       Boolean XmStringByteCompare(
12       XmString s1,
13       XmString s2);
14

DESCRIPTION

16       This function is obsolete and exists for  compatibility  with  previous
17       releases.  XmStringByteCompare returns a Boolean indicating the results
18       of a byte-by-byte comparison of two compound strings.
19
20       In general, if two compound strings are created with the same (char  *)
21       string  using XmStringCreateLocalized in the same language environment,
22       the compound strings compare as equal.  If  two  compound  strings  are
23       created  with  the  same (char *) string and the same font list element
24       tag set other than  XmFONTLIST_DEFAULT_TAG  using  XmStringCreate,  the
25       strings compare as equal.
26
27       In some cases, once a compound string is put into a widget, that string
28       is converted into an internal form to allow faster processing. Part  of
29       the conversion process strips out unnecessary or redundant information.
30       If an application then does  an  XtGetValues  to  retrieve  a  compound
31       string  from  a widget (specifically, Label and all of its subclasses),
32       it is not guaranteed that the compound string returned is byte-for-byte
33       the same as the string given to the widget originally.
34
35       s1        Specifies a compound string to be compared with s2
36
37       s2        Specifies a compound string to be compared with s1
38

RETURN

40       Returns True if two compound strings are identical byte-by-byte.
41
43       XmStringCreate(3) and XmStringCreateLocalized(3).
44
45
46
47                                             XmStringByteCompare(library call)
Impressum