Difference between revisions of "Manual:DIL Manual/string"
Jump to navigation
Jump to search
(XML import) |
(string ordering ignores case too; DIL Examples link text) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | = string = | |
| − | + | '''Type.''' A piece of text. | |
| − | + | var | |
| − | + | s : string; | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | 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>. | |
| − | |||
| − | |||
| − | + | == 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> and <code>!=</code> ignore case: <code>"Sword" == "sword"</code> is true. So do <code>< > <= >=</code>: <code>"B" > "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>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"). | ||
| − | + | == Notes == | |
| + | * A <code>"</code> can't be written inside a string: vmc stops at <code>\"</code>. Use single quotes in the text. | ||
| + | * 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><br/></code>. | ||
| + | * String variables keep their value through waits and are saved with the unit. | ||
| − | + | == Example == | |
| + | <pre> | ||
| + | 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 | ||
| + | </pre> | ||
| + | A command that refuses some words, gives the text a capital letter and shows it to the room. | ||
| − | + | == See also == | |
| − | + | * [[Manual:DIL Manual/stringlist|stringlist]] | |
| − | + | * [[Manual:DIL Manual/length()|length()]] | |
| − | + | * [[Manual:DIL Manual/itoa()|itoa()]] | |
| − | + | * [[Manual:DIL Manual/atoi()|atoi()]] | |
| − | + | * [[Manual:DIL Manual/in|in]] | |
| − | + | * [[Manual:DIL Manual/left()|left()]] | |
| − | + | * [[Manual:DIL Manual/right()|right()]] | |
| − | + | * [[Manual:DIL Manual/mid()|mid()]] | |
| − | + | * [[Manual:DIL Manual/replace()|replace()]] | |
| − | + | * [[Manual:DIL Manual/getword()|getword()]] | |
| − | + | * [[Manual:DIL Manual/split()|split()]] | |
| − | + | * [[Manual:DIL Manual/strcmp()|strcmp()]] | |
| − | + | * [[Manual:DIL Manual/Operators|Operators]] | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
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 throughitoa().==and!=ignore case:"Sword" == "sword"is true. So do< > <= >=:"B" > "a"is true.strcmp()andstrncmp()compare exactly."key" in stells whether the first string occurs anywhere in the second, ignoring case (1 or 0).s.[i]is the character at positioni(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; checklength(s)first. - If any part of a
+fails (a field of a null unit, say), the whole result fails, and asendtext()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.