Difference between revisions of "Manual:DIL Manual/string"

From DikuMUD Wiki
Jump to navigation Jump to search
(checked against the compiler and the interpreter; example compiles)
(string ordering ignores case too; DIL Examples link text)
 
Line 9: Line 9:
 
== Operators ==
 
== Operators ==
 
* <code>+</code> joins strings: <code>"You have " + itoa(n) + " coins."</code>. Both sides must be strings; numbers go through <code>itoa()</code>.
 
* <code>+</code> joins strings: <code>"You have " + itoa(n) + " coins."</code>. Both sides must be strings; numbers go through <code>itoa()</code>.
−
* <code>==</code> and <code>!=</code> ignore case: <code>"Sword" == "sword"</code> is true. <code>&lt; &gt; &lt;= &gt;=</code> do not ignore case. <code>strcmp()</code> and <code>strncmp()</code> compare exactly.
+
* <code>==</code> and <code>!=</code> ignore case: <code>"Sword" == "sword"</code> is true. So do <code>&lt; &gt; &lt;= &gt;=</code>: <code>"B" &gt; "a"</code> is true. <code>strcmp()</code> and <code>strncmp()</code> compare exactly.
 
* <code>"key" in s</code> tells whether the first string occurs anywhere in the second, ignoring case (1 or 0).
 
* <code>"key" in s</code> tells whether the first string occurs anywhere in the second, ignoring case (1 or 0).
 
* <code>s.[i]</code> is the character at position <code>i</code> (from 0) as a one-letter string. It can be read but not assigned (<code>s.[1] := "x"</code> is "Illegal lvalue").
 
* <code>s.[i]</code> is the character at position <code>i</code> (from 0) as a one-letter string. It can be read but not assigned (<code>s.[1] := "x"</code> is "Illegal lvalue").

Latest revision as of 23:54, 14 November 2026

string

Type. A piece of text.

var
   s : string;

Strings are written between double quotes: "Hello there". A string variable holds a copy of its text: assigning one string variable to another, or passing a string to a template, copies it. An unset string variable is the empty string "".

Operators

  • + joins strings: "You have " + itoa(n) + " coins.". Both sides must be strings; numbers go through itoa().
  • == and != ignore case: "Sword" == "sword" is true. So do < > <= >=: "B" > "a" is true. strcmp() and strncmp() compare exactly.
  • "key" in s tells whether the first string occurs anywhere in the second, ignoring case (1 or 0).
  • s.[i] is the character at position i (from 0) as a one-letter string. It can be read but not assigned (s.[1] := "x" is "Illegal lvalue").

Notes

  • A " can't be written inside a string: vmc stops at \". Use single quotes in the text.
  • A ^ inside a string ends the program early (see dilend).
  • Reading s.[i] past the end fails and writes "index of stringlist out of bounds" to the zone log; check length(s) first.
  • If any part of a + fails (a field of a null unit, say), the whole result fails, and a sendtext() or assignment with it does nothing.
  • Text sent to players is HTML: lines end with <br/>.
  • String variables keep their value through waits and are saved with the unit.

Example

dilbegin do_shout2(arg : string);
var
   s : string;
code
{
   if (arg == "")
   {
      sendtext("Shout what?<br/>", self);
      quit;
   }
   if ("password" in arg)
   {
      sendtext("Better not.<br/>", self);
      quit;
   }
   s := toupper(arg.[0]) + right(arg, length(arg) - 1);
   act("$1n bellows, '$2t!'", A_ALWAYS, self, s, null, TO_ALL);
   quit;
}
dilend

A command that refuses some words, gives the text a capital letter and shows it to the room.

See also