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

From DikuMUD Wiki
Jump to navigation Jump to search
(XML import)
 
(corrected from the DIL keyword tests (T029-T043))
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
= strcmp() =
 +
'''Function''' (integer). Compares two strings, minding upper and lower case.
  
 +
strcmp(s1 : string, s2 : string)
  
−
<span id="bfstrcmp"></span>
+
DIL's <code>==</code> and <code>!=</code> on strings ignore case (<code>"Sofa" == "sofa"</code> 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.
  
−
'''Function:'''  <i><!--CODE-->integer strcmp( s1:string, s2:string) ;</i><!--ENDCODE-->
+
== Parameters ==
 +
{| class="wikitable"
 +
! Name !! Type !! Meaning
 +
|-
 +
| s1 || string || The first string.
 +
|-
 +
| s2 || string || The second string.
 +
|}
  
−
<!--TERM--> '''s1'''
+
== Returns ==
−
<!--DEFINITION-->         first string
+
Integer: 0 when the strings are the same, less than 0 when <code>s1</code> sorts before
−
<!--TERM--> '''s2'''
+
<code>s2</code>, more than 0 when after. Test the sign only: the value need not be -1 or 1.
−
<!--DEFINITION-->        second string
 
  
−
  '''returns'''
+
A string variable that was never set counts as <code>""</code>. It fails when an argument is a
−
<!--TERM--> '''-1'''
+
failed value.
−
<!--DEFINITION-->         if s1 &lt; s2
 
−
<!--TERM-->  '''0'''
 
−
<!--DEFINITION-->        if s1 = s2
 
−
<!--TERM-->  '''1'''
 
−
<!--DEFINITION-->        if s1 &gt; s2
 
  
 +
== Notes ==
 +
* Capitals sort before small letters: <code>strcmp("Z", "a")</code> is less than 0.
 +
* 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.
  
−
This allows you to compare strings with case sensitivity in place.  If
+
== Example ==
−
you don't care about the case of the string use the normal '==' '&gt;',
+
<pre>
−
'&lt;', '&lt;=', '&gt;=', symbols.
+
dilbegin integer same_pwd(first : string, second : string);
−
'''example:'''
+
code
−
<i><!--CODE-->
+
{
−
---~---~---~---~---~---~---~---~---
+
  return (strcmp(first, second) == 0);
 +
}
 +
dilend
 +
</pre>
 +
Tells whether a password was typed the same way twice, capitals included, as the password
 +
change in commands.zon checks with <code>excmdstr_case</code>.
  
−
if (strcmp("I Care about Capitals",s2)==0))
+
== See also ==
−
        {
+
* [[Manual:DIL Manual/strncmp()|strncmp()]]
−
        sendtext ("You care I can see.&amp;n",self);
+
* [[Manual:DIL Manual/excmdstr case|excmdstr_case]]
−
        quit;
+
* [[Manual:DIL Manual/tolower()|tolower()]]
−
        }
+
* [[Manual:DIL Manual/Operators|Operators]]
−
 
 
−
 
 
−
 
 
−
---~---~---~---~---~---~---~---~---
 
−
 
 
−
</i><!--ENDCODE-->
 

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