Difference between revisions of "Manual:DIL Manual/strcmp()"

From DikuMUD Wiki
Jump to navigation Jump to search
(checked against the compiler and the interpreter; example compiles)
(corrected from the DIL keyword tests (T029-T043))
 
Line 26: Line 26:
 
== Notes ==
 
== Notes ==
 
* Capitals sort before small letters: <code>strcmp("Z", "a")</code> is less than 0.
 
* Capitals sort before small letters: <code>strcmp("Z", "a")</code> is less than 0.
−
* The old manual said <code>&lt;</code> and <code>&gt;</code> ignore case; only <code>==</code>
+
* All of DIL's string comparisons ignore case: <code>==</code>, <code>!=</code>, <code>&lt;</code>, <code>&gt;</code>, <code>&lt;=</code> and <code>&gt;=</code>. Only strcmp() and strncmp() mind it.
−
  and <code>!=</code> do.
 
  
 
== Example ==
 
== Example ==

Latest revision as of 07:21, 15 November 2026

strcmp()

Function (integer). Compares two strings, minding upper and lower case.

strcmp(s1 : string, s2 : string)

DIL's == and != on strings ignore case ("Sofa" == "sofa" is true). Use strcmp() when case matters, as with passwords: it compares the two strings byte by byte, as the C function of that name does.

Parameters

Name Type Meaning
s1 string The first string.
s2 string The second string.

Returns

Integer: 0 when the strings are the same, less than 0 when s1 sorts before s2, more than 0 when after. Test the sign only: the value need not be -1 or 1.

A string variable that was never set counts as "". It fails when an argument is a failed value.

Notes

  • Capitals sort before small letters: strcmp("Z", "a") is less than 0.
  • All of DIL's string comparisons ignore case: ==, !=, <, >, <= and >=. Only strcmp() and strncmp() mind it.

Example

dilbegin integer same_pwd(first : string, second : string);
code
{
   return (strcmp(first, second) == 0);
}
dilend

Tells whether a password was typed the same way twice, capitals included, as the password change in commands.zon checks with excmdstr_case.

See also