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

From DikuMUD Wiki
Jump to navigation Jump to search
(XML import of LLM wiki pages)
(string ordering ignores case too; DIL Examples link text)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
= string =
 +
'''Type.''' A piece of text.
  
 +
var
 +
    s : string;
  
−
<span id="str"></span>
+
Strings are written between double quotes: <code>"Hello there"</code>. 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 <code>""</code>.
−
'''String:'''
 
  
−
    A string is some text. They are used for a lot of things such as command
+
== Operators ==
−
arguments, room descriptions etc. String variables are automatically resized and
+
* <code>+</code> joins strings: <code>"You have " + itoa(n) + " coins."</code>. Both sides must be strings; numbers go through <code>itoa()</code>.
−
allocated when you assign them, so you do not have to worry about the string
+
* <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.
−
length nor allocation in your DIL programs. Strings may be compared either with
+
* <code>"key" in s</code> tells whether the first string occurs anywhere in the second, ignoring case (1 or 0).
−
'==' (equal to),
+
* <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").
−
'!=' (not equal),
 
−
'<=' (less than or equal to),
 
−
'>=' (greater than or equal to)
 
−
'<' (less than),
 
−
  '>' (greater than.
 
  
−
  Static strings are defined just as in the rest of the zone, within double
+
== Notes ==
−
quotations.  Strings may be searched easily with the 'in' operator. Variables
+
* A <code>"</code> can't be written inside a string: vmc stops at <code>\"</code>. Use single quotes in the text.
−
of type string are saved with DIL programs, if attached to a saved unit.
+
* A <code>^</code> inside a string ends the program early (see [[Manual:DIL Manual/dilend|dilend]]).
 +
* Reading <code>s.[i]</code> past the end fails and writes "index of stringlist out of bounds" to the zone log; check <code>length(s)</code> first.
 +
* If any part of a <code>+</code> fails (a field of a null unit, say), the whole result fails, and a <code>sendtext()</code> or assignment with it does nothing.
 +
* Text sent to players is HTML: lines end with <code>&lt;br/&gt;</code>.
 +
* String variables keep their value through waits and are saved with the unit.
  
−
'''Example:'''
+
== Example ==
−
 
+
<pre>
−
   "This is a static string"
+
dilbegin do_shout2(arg : string);
−
 
+
var
−
Strings may also be added to each other, in an expression.
+
   s : string;
−
 
+
code
−
'''Example:'''
+
{
−
 
+
   if (arg == "")
−
   "say "+itoa(42)+" is the answer!"
+
  {
−
 
+
      sendtext("Shout what?<br/>", self);
−
'''Example:'''
+
      quit;
−
 
+
   }
−
  if (self.name == self.names.[1]) ...
+
   if ("password" in arg)
−
 
 
−
  Elements of the string can also be accessed by referencing them by their position.
 
−
 
 
−
   '''Example'''
 
−
   if (str.[3]==f])
 
 
   {
 
   {
−
  exec ("say The 4th element is a F.",self);
+
      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
 +
</pre>
 +
A command that refuses some words, gives the text a capital letter and shows it to the room.
  
−
  '''Note'''
+
== See also ==
−
  Currently you can only access the single elements of a string you can not set
+
* [[Manual:DIL Manual/stringlist|stringlist]]
−
them.  In the future this will be possible.  You can still accomplish this by
+
* [[Manual:DIL Manual/length()|length()]]
−
copying one string to the other one element at a time and changing any that you
+
* [[Manual:DIL Manual/itoa()|itoa()]]
−
want something like this.
+
* [[Manual:DIL Manual/atoi()|atoi()]]
−
 
+
* [[Manual:DIL Manual/in|in]]
−
'''Example'''
+
* [[Manual:DIL Manual/left()|left()]]
−
i:=0;
+
* [[Manual:DIL Manual/right()|right()]]
−
ln:=length (str);
+
* [[Manual:DIL Manual/mid()|mid()]]
−
while (str.[i]<ln)
+
* [[Manual:DIL Manual/replace()|replace()]]
−
{
+
* [[Manual:DIL Manual/getword()|getword()]]
−
if (str.[i]=="f")
+
* [[Manual:DIL Manual/split()|split()]]
−
newstr.[i]:="b";
+
* [[Manual:DIL Manual/strcmp()|strcmp()]]
−
else
+
* [[Manual:DIL Manual/Operators|Operators]]
−
newstr:=str.[i];
 
−
i:=i+1;
 
−
}
 
−
str:=newstr;
 
−
 
 
−
  This snip of Dil would replace any 'f' in a string with a 'b' remember dil is
 
−
not case sensitive so it will also replace an 'F'.
 
−
 
 
−
---~---~---~---~---~---~---~---~---
 

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