File: Basic.em
Description: Functions for converting and manipulating number,
character, and string values.
Last Modified: 10/27/2007
Bin(number) | |
---|---|
Parameters: | |
Name | Type |
number | The number to convert |
Explanation | |
Returns the binary coded value of 'number' | |
Return values | |
A binary coded number |
CAsc(string) | |
---|---|
Parameters: | |
Name | Type |
string | String to convert |
Explanation | |
Converts the first character of string to an ASCII code | |
Return values | |
ASCII code |
CAscZ(string) | |
---|---|
Parameters: | |
Name | Type |
string | String to convert |
Explanation | |
Converts the string to an array of the character's ASCII codes | |
Return values | |
Array of ASCII values |
CChr(integer) | |
---|---|
Parameters: | |
Name | Type |
number | Integer to convert |
Explanation | |
Converts an ASCII value to a string consisting of one character. | |
Return values | |
A character |
CChrZ(array) | |
---|---|
Parameters: | |
Name | Type |
array | Array of ASCII values |
Explanation | |
Converts an array of ASCII values to a string | |
Return values | |
A string |
CDbl(variable) | |
---|---|
Parameters: | |
Name | Type |
variable | A variable Int or String |
Explanation | |
Converts a string or int to a real. Only strings containing digits and '.' will return a predicatable result. Ints will be expanded. | |
Return values | |
A Real |
CInt(variable) | |
---|---|
Parameters: | |
Name | Type |
variable | A variable Real or String |
Explanation | |
Converts a string or real to an integer. Only strings containing digits and '.' will return a predicatable result. Doubles will be truncated. | |
Return values | |
An Int |
CStr(variable) | |
---|---|
Parameters: | |
Name | Type |
variable | A variable Int or Real |
Explanation | |
Converts a real or int to a string. | |
Return values | |
A String |
Find(string, search, start) | |
---|---|
Parameters: | |
Name | Type |
string | The string to search in |
search | The string to search for |
start | The index to start searching at |
Explanation | |
Returns the index of the first occurance of 'search' after 'start' within 'string' | |
Return values | |
An int |
Hex(number) | |
---|---|
Parameters: | |
Name | Type |
number | The number to convert |
Explanation | |
Returns the hexidecimal value of 'number' | |
Return values | |
A hexidecimal |
Len(string|array) | |
---|---|
Parameters: | |
Name | Type |
string|array | A string or array |
Explanation | |
For strings, returns string length. For arrays, returns number of elements. Does not work for structs or dictionaries, use .size() for those. | |
Return values | |
An Int |
Lower(string) | |
---|---|
Parameters: | |
Name | Type |
string | A string to convert |
Explanation | |
Converts 'string' to lowercase (doesn't work with high-ascii characters or unicode) | |
Return values | |
A string |
Pack(object) | |
---|---|
Parameters: | |
Name | Type |
object | An object to pack |
Explanation | |
Packs a variable into POL's packed data string format. Note that object references CANNOT be saved with the world, but may be passed to other running scripts, or with an event. | |
Return values | |
A string |
print(anything) | |
---|---|
Parameters: | |
Name | Type |
anything | Any object, or primitive. |
Explanation | |
Prints 'anything' to the console. If it's a string or number, it will show the value. If it's an array, struct or dictionary, it will show the contents of the structure fairly nicely. On Packets it will show the content. Else, it shows the type of object, i.e. 'ItemRef'. | |
Return values | |
Nothing |
SizeOf(expression) | |
---|---|
Parameters: | |
Name | Type |
expression | An expression to evaluate |
Explanation | |
Returns an estimate of the memory used | |
Return values | |
An int |
SplitWords( str, delimiter := " " ) | |
---|---|
Parameters: | |
Name | Type |
string | The string to split |
delimiter | The delimiter to use |
Explanation | |
Returns an array of words contained in 'string'. Words are separated by the delimiter. | |
Return values | |
An array |
SubStr(string, start, length) | |
---|---|
Parameters: | |
Name | Type |
string | The string to search within |
start | The index to start getting the substring from |
length | The length of the substring |
Explanation | |
Returns the substring of 'string' beginning at 'start' for 'length'. This functions the same as virtual Substrings within eScript such as String[4,6] | |
Return values | |
A String |
TypeOf(variable) | |
---|---|
Parameters: | |
Name | Type |
variable | a script var |
Explanation | |
Returns a string, depending on the variable type of the parameter. Is one of: "Dictionary", "AccountRef", "ConfigFileRef", "ConfigElemRef", "DataFileRef", "DataElemRef", "ScriptExRef", "GuildRef", "BoundingBox", "DebugContext", "Package", "MenuRef", "MobileRef", "OfflineMobileRef", "ItemRef", "BoatRef", "MultiRef", "Unknown", "Uninit", "String", "Integer", "Double", "Array", "ApplicPtr", "ApplicObj", "Error", "Struct", "Packet". | |
Return values | |
A string |
Unpack(string) | |
---|---|
Parameters: | |
Name | Type |
string | A string to unpack |
Explanation | |
Unpacks a "packed data string" into the variable it represents. See Pack(). | |
Return values | |
A variable |
Upper(string) | |
---|---|
Parameters: | |
Name | Type |
string | A string to convert |
Explanation | |
Converts 'string' to uppercase (doesn't work with high-ascii characters or unicode) | |
Return values | |
A string |
If you know if any information is incorrect on these pages, mail your corrections to polteam@polserver.com
Copyright ©2003-2006 David Carpman and POL Development Team, all rights reserved. DO NOT REPRODUCE, MIRROR, ALTER, SPINDLE, MUTILATE, OR SIT ON.