Museum

 XmStringByteCompare(Xm)        6 January 1993        XmStringByteCompare(Xm)


 Name

    XmStringByteCompare - a compound string function that indicates the
    results of a byte-by-byte comparison

 Syntax


    #include <Xm/Xm.h>

    Boolean XmStringByteCompare (s1, s2)
    XmString s1;
    XmString s2;


 Description

    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 cre-
    ated with the same (char *) string and the same font list element tag set
    other than XmFONTLISTDEFAULTTAG using XmStringCreate, the strings com-
    pare 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
    guaranteed 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 value

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

 See also

    XmStringCreate(Xm) and XmStringCreateLocalized(Xm).