====== strcmp ======

===== Description =====

Compare two strings, as with the [[http://msdn.microsoft.com/en-us/library/e0z9k731(VS.80).aspx|strcmp function in C]].

===== Function prototype =====

<code>
int strcmp <string:str1> <string:str2>
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //str1//  |  string  | The first of the strings to be compared. |
|  //str2//  |  string  | The second of the strings to be compared. |

===== Return value =====

  * 0 if the strings are identical,
  * <0 if //str1// is lexicographically less than //str2//, or;
  * >0 if //str1// is lexicographically greater than //str2//.

===== Example =====

<code>
string s1
string s2

set s1 "hello"
set s2 "hi"

echo <zs:strcmp s1 s2>
</code>

... the output of which is written to the event log by [[plugins:general:zeoscript:reference:functions:echo]] as:

<file>
-1
</file>

===== Comments =====

None.

===== See also =====

  * [[plugins:general:zeoscript:reference:functions:iseq]]