View source for Functions List

The following functions are available in Dark Signs Online:

== String Functions ==

<code>
'''[[ASC|ASC]]''' Get the ASCII value of the specified text character

'''[[CHR|CHR]]''' Get the character of the given ASCII value

'''[[GETKEY|GETKEY]]''' Retruns the key value of the next key pressed.

'''[[GETASCII|GETASCII]]''' Returns the ascii value of the next key pressed.

'''[[INSTR|INSTR]]''' If string 2 is contained within string 1, return its starting character position, otherwise return 0. Parameters in this function should be surrounded in double quotes.

'''[[INPUT|INPUT]]''' Get input from the user, ask the specified message.

'''[[LCASE|LCASE]]''' Return the string in lower case characters.

'''[[LEFT|LEFT]]''' Extract the specified number of characters (len) from the string, starting from the left side.

'''[[LEN|LEN]]''' Get the length of the string as an integer.

'''[[MID|MID]]''' Extract the specified part of the string, starting at startpos.

'''[[RANDOM|RANDOM]]''' Get a random number between the specific lower and higher number.

'''[[REPLACE|REPLACE]]''' Replace the specified text with the specified text if it exists in the string. Parameters in this function should be surrounded in double quotes.

'''[[REVERSE|REVERSE]]''' What this function does will depend on the data you pass to it. If you send it 'true' it will return 'false', if you send it 'false' it will return 'true'. If you send it a text string, the text string will be reversed. '1' and '0' will also alternate.

'''[[TRIM|TRIM]]''' Return the string without surrounding spaces.

'''[[UCASE|UCASE]]''' Return the string in upper case characters.

'''[[RIGHT|RIGHT]]''' Extract the specified number of characters (len) from the string, starting from the right side.

'''[[URLENCODE|URLENCODE]]''' Urlencodes the given string.
</code>

== File Functions ==

<code>
'''[[FILE|FILE]]''' Return text data from a file, starting at the specified line.
</code>

== Connection Functions ==

<code>
'''[[DOWNLOAD|DOWNLOAD]]''' Download data from an *external* server on the *real* internet. The HTML or data will be returned into the variable. This is a [[Remote_function|remote function]].

'''[[GETDOMAIN|GETDOMAIN]]''' Get the domain name of the server. The server can be a domain name (in which case the data will not be modified) or an IP address. The function will return 0 if the server is not found. This is a [[Remote_function|remote function]].

'''[[GETIP|GETIP]]''' Get the IP address of the server. The server can be a domain name or an IP address (in which case the data will not be modified). The function will return 0 if the server is not found. This is a [[Remote_function|remote function]].

'''[[PING|PING]]''' Return 1 if the specified server exists, or 0 if it is not found. This is a [[Remote_function|remote function]].

'''[[PINGPORT|PINGPORT]]''' Return 1 if a script is running on the specified server and port, or 0 if no script is detected. This is a [[Remote_function|remote function]].

'''[[TIME|TIME]]''' Get the server time in a unix style timestamp.

'''[[SERVERTOKEN|SERVERTOKEN]]''' Return a short-lived token to verify a user's identity outside of DSO (used with '''[[DOWNLOAD|DOWNLOAD]]''').  This is a [[Remote_function|remote function]].
</code>

== Misc. Functions ==

<code>
'''[[RUN|RUN]]''' Return the output of the specified command, instead of printing it directly to the console. WARNING - The RUN function can be imperfect at times.
</code>

== Usage ==

Generally functions are used like this:

<code> $var = functionname(parameters) </code>

However, you may use multiple functions on a single line.

<code> $var = chr(65)chr(66)chr(67)chr(68) </code>

The above code will put &quot;ABCD&quot; inside $var.

Functions marked as [[Remote_function|remote functions]], and the INPUT function, can not be used multiple times on one line.