


XmStringByteCompare(3X)				      XmStringByteCompare(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSttrriinnggBByytteeCCoommppaarree -	A compound string function that	indicates the results
  of a byte-by-byte comparison

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  BBoooolleeaann XXmmSSttrriinnggBByytteeCCoommppaarree ((_s_1, _s_2))
       XXmmSSttrriinngg	 _s_1;;
       XXmmSSttrriinngg	 _s_2;;

DESCRIPTION
  XXmmSSttrriinnggBByytteeCCoommppaarree 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 XXmmSSttrriinnggCCrreeaatteeLLooccaalliizzeedd 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 XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG using XXmmSSttrriinnggCCrreeaattee, 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 XXttGGeettVVaalluueess 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.

  _s_1	 Specifies a compound string to	be compared with _s_2

  _s_2	 Specifies a compound string to	be compared with _s_1

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

RELATED	INFORMATION
  XXmmSSttrriinnggCCrreeaattee((33XX)) and XXmmSSttrriinnggCCrreeaatteeLLooccaalliizzeedd((33XX)).


















