XmeNamesAreEqual(3X) UNIX System V XmeNamesAreEqual(3X)
NAME
XmeNamesAreEqual - Compares two strings for equality
SYNOPSIS
#include <Xm/XmP.h>
Boolean XmeNamesAreEqual(
char *in_str,
char *test_str);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmeNamesAreEqual compares in_str to test_strand returns True
if they are equivalent. Typically, in_strholds some Motif
constant, such as "Xm1000TH_INCHES" and test_str holds a
normalized version of a constant, such as "1000th_inches".
The case of letters in in_str is irrelevant. For comparison
purposes, XmeNamesAreEqual automatically converts all
letters in in_str to lowercase. By contrast, all letters in
test_str must be lowercase. If any letter in test_str is
uppercase, then XmeNamesAreEqual automatically returns
False.
For example, if in_str contains "Goodbye" and test_str
contains "goodbye", XmeNamesAreEqual returns True (because
the function converts "Goodbye" to "goodbye"). However, if
in_str contains "Goodbye" and test_str contains "Goodbye",
XmeNamesAreEqual returns False (because of the uppercase "G"
in test_str).
XmeNamesAreEqual treats the following prefixes specially:
XM, Xm, xM, and xm. If one of these prefixes appears in
in_str, XmeNamesAreEqual skips over it and begins the
comparison at the third character in in_str. For example,
if in_str contains "XMhello" and test_strcontains "hello",
then XmeNamesAreEqual returns True. However,
XmeNamesAreEqual provides no special treatment if one of
these prefixes appears in test_str. For example, if in_str
contains "XMhello" and test_strcontains "xmhello", then
XmeNamesAreEqual returns False.
When the strings to be compared are enumerated values, then
you should probably consider using the representation type
facility of Motif instead of XmeNamesAreEqual. The
representation type facility of Motif obeys the same string
comparison rules as XmeNamesAreEqual.
XmeNamesAreEqual is used primarily by programmers writing
their own resource converters.
Page 1 (printed 7/20/06)
XmeNamesAreEqual(3X) UNIX System V XmeNamesAreEqual(3X)
in_str Specifies one of the two strings to compare. A
prefix of XM, Xm, xM, or xm is ignored, as is the
case of letters appearing in the string.
test_str Specifies the other string to compare. This
string should not start with the prefix XM, Xm,
xM, or xm. Also, all letters in the string must
be lowercase letters.
RETURN
Returns True if the strings match. Otherwise, it returns
False.
RELATED
XmRepTypeRegister(3).
Page 2 (printed 7/20/06)