Command: compare
  
Syntax: 
  i = compare(x1, x2)
  
Description: 
  Return 0 if objects x1 and x2 are identical, 1 if x1 is greater 
  than x2, -1 if x1 is less than x2. Atoms are considered to be 
  less than sequences. Sequences are compared "alphabetically" 
  starting with the first element until a difference is found. 
  
Example 1: 
   x = compare({1,2,{3,{4}},5}, {2-1,1+1,{3,{4}},6-1})
       -- identical, x is 0
       
Example 2: 
   if compare("ABC", "ABCD") < 0 then   -- -1
 -- will be true: ABC is "less" because it is shorter
       end if

Example 3: 
   x = compare({12345, 99999, -1, 700, 2},
                          {12345, 99999, -1, 699, 3, 0})
              -- x will be 1 because 700 > 699
                          
See Also: 
  equals (=) operator in refman.doc
  
