Multiplayer Interactive-Fiction Game-Design Blog



Download 8.87 Mb.
Page136/151
Date02.02.2017
Size8.87 Mb.
#15199
1   ...   132   133   134   135   136   137   138   139   ...   151

Constructor2


Automatically run immediately after an object is reloaded.

If an object supports the Constructor2() method then when the object is reloaded from a saved session (NOT created), the Constructor2() method will automtically be called.

If an object has one or more superclasses with Constructor2()'s the superclass's constructors will be called first, working its way up the chain to the object's Constructor2().

NOTE: The object should NOT delete itself in its own Constructor2().



Parameter Name

Description

Return value description

None

Overrides: Call all the methods, from lowest to highest priority – don’t stop

Common to all objects


ContainedInGet


Returns the object that contains this object.

This returns the object that contains the current object.

For example: If the "money" object is contained within the "wallet" object it will return the wallet object.

Parameter Name

Description

Return value description

The object that contains this object, or NULL if it isn't contained.

Overrides: Call only the highest priority method

Common to all objects


ContainedInSet


Moves the object into another object.

This moves the object so it's contained by another object.

For example:

money.ContainedInSet (wallet);

return money.ContainedInGet();

This resturns "wallet".



Parameter Name

Description

MoveTo

The object to move this one into. This can either be an object or NULL (which will cause the object to not be contained in any other object.)

Return value description

TRUE is the move succedes, FALSE if it fails (perhaps because the container object no longer exists.)

Overrides: Call only the highest priority method

Common to all objects


ContainsEnum


Returns a list of objects that this object contains.

This returns a list of objects that are contained by this object.

For example:

money.ContainedInSet (wallet);

return wallet.ContainsEnum();

This returns [money].



Parameter Name

Description

Return value description

List of objects that this object contains. The list may be empty if the object contains nothing.

Overrides: Call only the highest priority method

Common to all objects


DeleteWithContents


Deletes the object along with all its contained objects.

This deletes the object along with all the object it contains, and the ones they contain.

If you just with to delete the object by itself (and leave the contained objects around) then call "delete ".

Parameter Name

Description

Return value description

TRUE is deleting succeded, FALSE if it failed.

Overrides: Call only the highest priority method

Common to all objects


Destructor


Automatically run immediately before the object is destroyed.

If an object supports the Destructor() method then when the object is deleted, the Destructor() method will automtically be called.

If an object has one or more superclasses with Destructor()'s the object's destructor will be called first, working its way down to the superclasses.

When an application is quickly shut down, the destructors of the remaining objects may not be called (to speed up shutdown.)

NOTE: The object should NOT delete itself in its own Destructor().

Parameter Name

Description

Return value description

None

Overrides: Call all the methods, from highest to lowest priority – don’t stop

NOT Common to all objects


LayerAdd


Adds a new layer to an object.

This adds a new layer to an object. The index of the layer (for purposes of LayerGet(), etc.) will depend upon the priority.

Adding a new layer will add all of the methods of the class to the object. It will NOT add the properties of the class, although if the class provides any property get/set code, that will be added.

Example:


Object.LayerAdd ("LayerName", "LayerClass", 43.54);

Parameter Name

Description

LayerName

String to identify the layer. The name is only to make it easier for the application to monitor the layers.

LayerClass

String representation of the layer class. If the class isn't valid the layer will not be created.

LayerPriority

Priority for the layer. Layers are ordered such that the ones with the highest priorities have their methods take precedence over the others.

Return value description

TRUE if it succedes. FALSE if there's an error (such as a bad layer class).

Overrides: Call only the highest priority method

Common to all objects


LayerGet


Gets information about a layer.

This returns information about a layer: its name, class, and priority.

Example:

return Object.LayerGet (0);

Returns ["LayerName", "LayerClass", 43.54].

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

Return value description

This returns a list. List[0] is the layer name. List[1] is the layer's class, as a string. List[2] is the layer's rank; higher ranks will always appear first on the list.

Overrides: Call only the highest priority method

Common to all objects


LayerMethodAdd


Adds an individual method to a layer.

This adds an individual method to a layer. Applications can use this to dynamically create methods for objects.

Example:

Object.LayerMethodAdd (0, "MyNewMethod", Trace);

This adds a new method to layer 0, called "MyNewMethod". When the method is called, it really calls into the code of the function, "Trace".

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

NewMethodName

The name of the new method. This must be a string (with a valid method name) or a method.

CallThis

This is the code that will be run when the method is called. It must either be the name of an existing function or method. If it's a method, the method must exist in the object; it can come from another object if "Object.Method" is used to specify the object.

Return value description

TRUE if the method was added, FALSE if there's an error.

Overrides: Call only the highest priority method

Common to all objects


LayerMethodEnum


Returns a list of methods in the layer.

This returns a list of methods in the layer.

If it is enumerating class-defined methods then it only enumerates the public ones. If enumerating invidually added methods then it enumerates all of them.

Example:


return Object.LayerMethodEnum(0, TRUE);

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

EnumClass

If TRUE then enumerate all the public methods from the layer's class. If FALSE then enumerate all individually added methods (using LayerMethodAdd()).

Return value description

List of methods, or NULL if an error occurs.

Overrides: Call only the highest priority method

Common to all objects


LayerMethodRemove


Removes an individual method to a layer.

This removes an individual method to a layer. Applications can use this to dynamically remove methods for objects.

Example:

Object.LayerMethodRemove (0, "MyNewMethod");

The removes "MyNewMethod" which was added by calling LayerMethodAdd().

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

RemoveMethodName

This removes an individual method to a layer. Applications can use this to dynamically remove methods for objects.

Example:


Object.LayerMethodRemove (0, "MyNewMethod");

The removes "MyNewMethod" which was added by calling LayerMethodAdd().



Return value description

TRUE if the method was removed, FALSE if there's an error.

Overrides: Call only the highest priority method

Common to all objects


LayerNumber


Returns the number of layers in an object.

This returns the number of layers in an object.



Parameter Name

Description

Return value description

The number of layers in an object.

Overrides: Call only the highest priority method

Common to all objects


LayerPropGetSetAdd


Adds code for getting or setting a property to a layer.

This adds code for getting or setting an individual property to a layer. Applications can use this to dynamically create code to intercept property get and set for an object. (If no code exists then the property is accessed directly.)

Example:

Object.PropertySet ("MyNewProp", 0);

Object.LayerPropGetSetAdd (0, "MyNewProp", GetFunc, SetFunc);

After this is called, any attempts to change "MyNewProp" will be passed to SetFunc(), and any attemps to get the value will be passed to GetFunc().



Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

PropertyName

The name of the property. This must be a string.

If the method already exists in the layer's individual methods then an error will be returned.



GetCode

This is the code that will be run when the property is read from. It must either be the name of an existing function or method. If it's a method, the method must exist in the object; it can come from another object if "Object.Method" is used to specify the object.

If this is NULL the property will be accessed directly when it's read.



SetCode

This is the code that will be run when the property is set. It must either be the name of an existing function or method. If it's a method, the method must exist in the object; it can come from another object if "Object.Method" is used to specify the object.

If this is NULL the property will be accessed directly when it's written.



Return value description

The number of layers in an object.

Overrides: Call only the highest priority method

Common to all objects


LayerPropGetSetEnum


Returns a list of properties supported by the layer.

This returns a list of properties supported by the layer.

If it is enumerating class-defined properties then it only enumerates the public ones. If enumerating invidually added properties then it enumerates all of them.

Example:


return Object.LayerPropGetSetEnum(0, TRUE);

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

EnumClass

If TRUE then enumerate all the public properties from the layer's class. If FALSE then enumerate all individually added properties (using LayerPropGetSetAdd()).

Return value description

List of properties (as strings), or NULL if an error occurs.

Overrides: Call only the highest priority method

Common to all objects


LayerPropGetSetRemove


Removes an individual property from a layer.

This removes an individual property from a layer. Applications can use this to dynamically remove property get/set code for objects.

Example:

Object.LayerPropGetSetRemove (0, "MyNewProp");

The removes "MyNewProp" which was added by calling LayerPropGetSetAdd().

Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

PropertyName

The name of the property to remove. This must be a string.

Return value description

TRUE if the property was removed, FALSE if there's an error.

Overrides: Call only the highest priority method

Common to all objects


LayerRemove


Removes a layer from an object.

This removes a layer from an object. Removing the layer will also remove methods provided for in that layer.



Parameter Name

Description

LayerNum

Layer number, from 0 to LayerNumber()-1.

Return value description

TRUE if the layer was removed, FALSE if there was an error.

Overrides: Call only the highest priority method

Common to all objects


ListAppend


Appends a list to the end of another.

This appends a list's elements to the end of the current list. Replacement is IN PLACE, causing the original list to be modified.

Example:

list = [1,2,3,[5,6]];

string.ListAppend ([8,9]);

The resulting list is [1,2,3,[5,6],8,9]



Parameter Name

Description

Insert

(Optional) What to append.

Return value description

The list.

Overrides: Call only the highest priority method

Common to all objects


ListConcat


Appends one or items to the end of the string list.

This concatenates one or more items onto the end of the current list. Any lists added are created as sub-lists. The current list is modified in place.

Example:

var list = [1,2,3];

list.ListConcat (4, [5,6]);

results in:

list = [1,2,3,4,[5,6]]

Parameter Name

Description

Concat

First tiem to concatenate to the list. More than one item can be added.

Return value description

The list.

Overrides: Call only the highest priority method

Common to all objects


ListInsert


Inserts a list before the element of another.

This inserts a list's elements before an element in the current list. Replacement is IN PLACE, causing the original list to be modified.

Example:

list = [1,2,3,[5,6]];

string.ListInsert ([8,9], 1);

The resulting list is [1,8,9,2,3,[5,6]]

If AddSubLists is TRUE then the result would be: [1,[8,9],2,3,[5,6]]

Parameter Name

Description

Insert

(Optional) What to insert.

StartIndex

(Optional) Element to insert before. If not specified then this will be 0.

AddSubLists

(Optional) If this is TRUE then if the Insert parameter is a list the list will be added as a sublist. If FALSE (or undefined) then if Insert is a list its individual elements will be added.

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListMerge


Merges the second list onto the first.

This merges a second list onto the end of the first. The current list is modified in place.

Example:

var list = [1,2,3];

list.ListConcat ([5,6]);

results in:

list = [1,2,3,5,6]

Parameter Name

Description

Concat

List that gets merged onto the end of the current list. If this is not a list then the item will be merged into the list.

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListNumber


Returns the number of items in the list.

This returns the number of items in the list.

Example:

var list = [1,2,3,[5,6]];

return list.ListNumber();

Returns 4.



Parameter Name

Description

Return value description

The number of items in the list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListPrepend


Prepends a list to the beginning of another.

This prepends a list's elements to the start of the current list. Replacement is IN PLACE, causing the original list to be modified.

Example:

list = [1,2,3,[5,6]];

string.ListPrepend ([8,9]);

The resulting list is [8,9,1,2,3,[5,6]]



Parameter Name

Description

Insert

(Optional) What to prepend.

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListRandomize


Randomizes the orders of the elements in the list.

This randomizes the order of the elements in the list. The list is modified in place.

NOTE: This uses the Random() function for generating the random numbers. If your code has been relying on a random seed this will change the seed.

Example:


var list = [1,2,3,[5,6]];

list.ListRandomize();



Parameter Name

Description

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListRemove


Removes one or more items from the list.

This removes one or more items from the list. The current list is modified in place.

Example:

var list = ["a", "hello", "c", "e"];

list.ListRemove (1, 3);

results in:

list = ["a", "e"];

Parameter Name

Description

StartIndex

First item (by index) to remove from the list.

EndIndex

(Optional) One more than the last item to remove from the list. If this is left blank then EndIndex is set to StartIndex+1, which causes it to only delete StartIndex.

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListReplace


Replaces a portion of one list with another.

This replaces a portion of the current list with another. Replacement is IN PLACE, causing the original list to be modified.

Example:

list = [1,2,3,[5,6]];

string.ListReplace ([8,9], 1, 2);

The resulting list is [1,8,9,3,[5,6]]



Parameter Name

Description

ReplaceWith

(Optional) What to replace the range with.

StartIndex

(Optional) Starting index to replace. If not specified then this will be 0.

EndIndex

(Optional) Ending index to replace. If not specified this will be the end of the list.

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListReverse


Reverses the elements in the list.

This reverses the elements in the list. The list is modified in place.

Example:

var list = [1,2,3,[5,6]];

list.ListReverse();

Results:


list = [[5,6],3,2,1]

Parameter Name

Description

Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListSearch


Searches through a sorted list for an element.

This searches through a sorted list for an element. It returns the index to the element, or -1 if it can't be found.

The list have been sorted using ListSort() with the same SortingFunction that's passed in.

Example:


list = ["a", "e", g", "z"];

return string.ListSearch ("e");

This returns 1.

Parameter Name

Description

SearchFor

The element to look for.

SortingFunction

(Optional) This is a function or method that will sort the elements. The function or method accepts two parameters, A and B. It should return a negative number it A appears before B in the list, 0 if A is the same as B, and 1 if A appears after B in the list.

If no sorting function is passed then the list will be sorted alphabetically or numerically. Make sure that all the elements are the same type; don't mix numbers with strings, etc.



Return value description

If the element is found, this is an index into the list. If more than one element matches than an arbitrary one will be returned. If an element isn't found then -1 is returnd.

Overrides: Call only the highest priority method

NOT Common to all objects


ListSearchToInsert


Searches through a sorted list for an element to insert before.

This searches through a sorted list for an element to insert before. It can be used to keep the sorted even when inserting new items.

Example:

list = ["a", "e", "g", "z"];

list.ListInsert ("h", list.ListSearchToInsert("h"));

The new list will be ["a", "e", "g", "h", "z"];



Parameter Name

Description

SearchFor

The element to look for.

SortingFunction

(Optional) This is a function or method that will sort the elements. The function or method accepts two parameters, A and B. It should return a negative number it A appears before B in the list, 0 if A is the same as B, and 1 if A appears after B in the list.

If no sorting function is passed then the list will be sorted alphabetically or numerically. Make sure that all the elements are the same type; don't mix numbers with strings, etc.



Return value description

Index in the list to insert before in order to keep the list sorted.

Overrides: Call only the highest priority method

NOT Common to all objects


ListSlice


Copies a portion of the list into a new list.

This copies a portion of the list into a new list.

Example:

list = [1,2,3,[5,6]];

return list.ListSlice (1, -1);

Returns [2,3].



Parameter Name

Description

StartIndex

The index into the list that will become the start of the new list. If this is negative, this is the index from the end of the list. (ListNumber() + StartIndex).

EndIndex

(Optional) The index into the list beyond the end of the list. This must always be 0 or a negative value, with 0 keeping from StartIndex to the end of the list, -1 discarding the last element, -2 discarding the last two, etc. If this isn't specified then 0 (the end of the list) will be used.

Return value description

The sliced out list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListSort


Sorts the list.

This sorts the list. Sorting is in place, so the current list is changed.

Example:

list = [6,2,3,1,4];

string.ListSort();

The resulting list is [1,2,3,4,6]



Parameter Name

Description

SortingFunction

(Optional) This is a function or method that will sort the elements. The function or method accepts two parameters, A and B. It should return a negative number it A appears before B in the list, 0 if A is the same as B, and 1 if A appears after B in the list.

If no sorting function is passed then the list will be sorted alphabetically or numerically. Make sure that all the elements are the same type; don't mix numbers with strings, etc.



Return value description

The list.

Overrides: Call only the highest priority method

NOT Common to all objects


ListSubList


Copies a portion of the list into a new list.

This copies a portion of the list into a new list.

Example:

list = [1,2,3,[5,6]];

return list.ListSubList(1,3);

Returns [2,3].



Parameter Name

Description

StartIndex

The index into the list that will become the start of the new list.

EndIndex

(Optional) The index into the list that will become end of the new list. If this isn't specified then the end of the list will be used.

Return value description

The sliced out list.

Overrides: Call only the highest priority method

NOT Common to all objects


MethodCall


Calls a method in an object.

This calls a method in an object. It can be used to call methods using a string instead of the method.

NOTE: This only calls public methods.

For example:

return AnObject.MethodCall ("AMethod", 3, 5);

Parameter Name

Description

Method

Method name. This is either a method name or a string.

Param1

Parameters passed into the method.

Return value description

Whatever the method returns, or Undefined if the method doesn't exist.

Overrides: Call only the highest priority method

Common to all objects


MethodEnum


Returns a list of the methods supported by the object.

This returns a list of methods supported by the object.

NOTE: This only returns public methods.

For example:

return AnObject.MethodEnum ();

Returns [Method1, Method2, etc.]



Parameter Name

Description

Return value description

List of the methods supported. This does not include automatic methods, such as MethodEnum(). If no methods are supported by the object it returns an empty list.

Overrides: Call only the highest priority method

Common to all objects


MethodQuery


Returns TRUE if the object supports the method.

This checks to see if an object supports a method and returns TRUE if it exists.

NOTE: This only checks public methods.

For example:

return AnObject.MethodQuery ("AMethod");

Parameter Name

Description

Method

Method name. This is either a method name or a string.

Return value description

TRUE if the method exists, FALSE if it doesn't.

Overrides: Call only the highest priority method

Common to all objects


Name


Returns the name of an object.

This returns the name of an object. It can called by any function or method.

It is automatically called when an object is concatenated to a string so that a proper name can be concatenated. If unsupported, the class that the object was originally created from will be used as the name.

Parameter Name

Description

Return value description

Should return a string for the name of the object.

Overrides: Call only the highest priority method

Common to all objects


PropertyEnum


Returns a list of the properties supported by the object.

This returns a list of the properties supported by the object.

NOTE: This only returns public properties.

For example:

return AnObject.PropertyEnum ();

Returns ["AProperty", "Property2", etc.]



Parameter Name

Description

Return value description

List of the properties supported. If no properties are supported by the object it returns an empty list.

Overrides: Call only the highest priority method

Common to all objects


PropertyGet


Gets an object's property using a string for the property name.

The gets and object's property, using a string for a property name.

NOTE: This only gets public properties.

For example:

AnObject.AProperty = 5;

return AnObject.PropertyGet ("AProperty");

Returns 5.

Parameter Name

Description

Property

Property name. This must be a string.

Return value description

Value of the property, or Undefined if it wasn't supported by the object.

Overrides: Call only the highest priority method

Common to all objects


PropertyQuery


Returns TRUE if the object supports the property.

This checks to see if an object supports a property and returns TRUE if it exists.

NOTE: This only checks public properties.

For example:

AnObject.AProperty = 5;

AnObject.PropertyRemove ("AProperty");

return AnObject.PropertyQuery ("AProperty");

Returns FALSE.



Parameter Name

Description

Property

Property name. This must be a string.

Return value description

TRUE if the property exists, FALSE if it doesn't.

Overrides: Call only the highest priority method

Common to all objects


PropertyRemove


Removes an object's property.

The deletes the object's property, using a string for a property name.

NOTE: This only removes public properties.

For example:

AnObject.AProperty = 5;

AnObject.PropertyRemove ("AProperty");

Results: AProperty is removed from the object.

Parameter Name

Description

Property

Property name. This must be a string.

Return value description

TRUE if the property is removed, FALSE if it isn't found.

Overrides: Call only the highest priority method

Common to all objects


PropertySet


Sets an object's property using a string for the property name.

The sets and object's property, using a string for a property name. If the property doesn't already exist in the object it's created.

NOTE: This only sets public properties.

For example:

AnObject.PropertySet ("AProperty", 5);

return AnObject.AProperty;

Returns 5.

Parameter Name

Description

Property

Property name. This must be a string.

Value

What value to set the property as.

Return value description

Value of the property, or undefined if there is an error (such as the property name already used by a different class of identifier).

Overrides: Call only the highest priority method

Common to all objects


StringAppend


Appends a string to the current one.

This appends the Insert string at the end of the current string. Insertion is IN PLACE, causing the original string to be modified.

Example:

string = "Hello";

string.StringAppend (" ! ");

The resulting string is "Hello ! ".



Parameter Name

Description

Insert

The string to append.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringCompare


Compares two strings.

This compares the string with the Compare string. It returns 0 if the two strings are the same, a negative value if the string (this) should be placed before Compare, and a positive value if it should be placed after Comapre.

Example:

string = "abacus";

return string.StringCompare ("zebra");

Returns a negative number.



Parameter Name

Description

Compare

String to compare against.

CaseSensative

(Optional) If TRUE is passed then the comparison will be case sensative; if FALSE it's case insensative. If not specified then the comparison is case sensative.

Return value description

It returns 0 if the two strings are the same, a negative value if the string (this) should be placed before Compare, and a positive value if it should be placed after Comapre.

Overrides: Call only the highest priority method

NOT Common to all objects


StringConcat


Appends one or more strings to the end of the string object.

This concatenates one or strings onto the end of the current string. The current string is modified in place.

Example:

var string = "Hello";

string.StringConcat (" there ", 534, ".");

results in:

string == "Hello there 543."

Parameter Name

Description

Concat

First string (or other value) to concatenate. More than one string can be added.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringFormat


Replaces %1, %2, etc. in the string.

This searches through the string for "%1", "%2", ... "%9" and replaces them with the 1st, 2nd, ... 9th parameter in the StringFormat() call.

StringFormat() is extremely useful for fill-in-the-blank strings.

Example:


var string = "My %2 is %1.";

return string.StringFomat ("Mike", "name");

return "My name is Mike."

Parameter Name

Description

Param1

If %1 is found, it is replaced by Param1.

Param2

If %2 is found, it is replaced by Param2.

Return value description

New string that includes the replacements.

Overrides: Call only the highest priority method

NOT Common to all objects


StringFromChar


Creates a string from one or more characters or character codes.

This creates a string from one or more characters ('a', 'b', etc.) or character codes (numbers).

Example:

var string;

string = string.StringFromCar (163, '2', '0', '0', '4');

results in, the Pound-sterling symbol followed by "2004"



Parameter Name

Description

char

The first character or chracter value to be placed in the string. More than one character can be used.

Return value description

New string that includes the replacements.

Overrides: Call only the highest priority method

NOT Common to all objects


StringInsert


Inserts one string into another.

This inserts the Insert string into the current string. Insertion is IN PLACE, causing the original string to be modified.

Example:

string = "Hello";

string.StringInsert (" ! ", 1);

The resulting string is "H ! ello".



Parameter Name

Description

Insert

(Optional) The string to insert.

StartIndex

(Optional) Character index to insert before. If not specified then this will be 0.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringLength


Returns the number of characters in the string.

This returns the number of characters in the string.

Example:

string = "Hi there!";

return string.StringLength();

Returns 9.



Parameter Name

Description

Return value description

Number of characters in the string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringPrepend


Inserts a string at the beginning.

This inserts the Insert string at the beginning of the current string. Insertion is IN PLACE, causing the original string to be modified.

Example:

string = "Hello";

string.StringPrepend (" ! ");

The resulting string is " ! Hello".



Parameter Name

Description

insert

The string to insert.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringReplace


Replaces a portion of one string with another.

This replaces a portion of the current string with another. Replacement is IN PLACE, causing the original string to be modified.

Example:

string = "Hello";

string.StringReplace (" ! ", 1, 2);

The resulting string is "H ! llo".



Parameter Name

Description

ReplaceWith

(Optional) What to replace the range with.

StartIndex

(Optional) Starting character to replace. If not specified then this will be 0.

EndIndex

(Optional) Ending character to replace. If not specified this will be the end of the string.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringSearch


Finds an occurence of one string inside another.

This searches for the substring within the original string. If it's found then it returns the index into the original string where the substring begins, or -1 if it can't be found.

Example:

string = "Hi there!";

return string.StringSearch ("there");

Returns 3.



Parameter Name

Description

SubString

The string to search for.

StartIndex

(Optional) The character index, within SubString, to search from. If this isn't specified then 0 will be used.

CaseSensative

(Optional) If TRUE is passed then the comparison will be case sensative; if FALSE it's case insensative. If not specified then the comparison is case sensative.

Return value description

The index into the string where SubString appears. If SubString is not found then -1 is returned.

Overrides: Call only the highest priority method

NOT Common to all objects


StringSlice


Copies a portion of the string into a new string.

This copies a portion of the stirng into a new string.

Example:

string = "Hi there!";

return stirng.StringSlice (3,-1);

Returns "there".



Parameter Name

Description

StartIndex

The index into the string that will become the start of the new string. If this is negative, this is the index from the end of the string. (StringLength() + StartIndex).

EndIndex

(Optional) The index into the string beyond the end of the string. This must always be 0 or a negative value, with 0 keeping from StartIndex to the end of the string, -1 discarding the last character, -2 discarding the last two, etc. If this isn't specified then 0 (the end of the string) will be used.

Return value description

The sliced out string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringSplit


Splits the string into multiple strings based on the delimiter.

This splits the string into multiple strings based on the delimiter (such as ',' or ' '). The new strings are added to a list, which is returned.

Example:

string = "1,2,3,,,5,6,7";

return string.StringSplit (',');

Returns ["1", "2", "3", "", "", "5", "6", "7"].



Parameter Name

Description

Delimiter

The string or character used to separate the entries.

Return value description

The list containing the split-up string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringSubString


Copies a portion of the string into a new string.

This copies a portion of the stirng into a new string.

Example:

string = "Hi there!";

return stirng.StringSubString (3,8);

Returns "there".



Parameter Name

Description

StartIndex

The index into the string that will become the start of the new string.

EndIndex

(Optional) The index into the string that will become end of the new string. If this isn't specified then the end of the string will be used.

Return value description

The sliced out string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringToLower


Converts the string to lower case.

Converts the string to lower case.

Example:

string = "Hello Mike!";

return string.StringToLower();

Returns"hello mike!".



Parameter Name

Description

Return value description

Lower case version of the string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringToUpper


Converts the string to upper case.

Converts the string to upper case.

Example:

string = "Hello Mike!";

return string.StringToUpper();

Returns"HELLO MIKE!".



Parameter Name

Description

Return value description

Upper case version of the string.

Overrides: Call only the highest priority method

NOT Common to all objects


StringTrim


Trims whitespace from the beginning and end of the string.

This trims the whitespace from the beginning and end of the string.

Example:

string = " Hello Mike! ";

string.Trim();

String's new value is "Hello Mike!"



Parameter Name

Description

TrimOnlyLeft

(Optional) This this isn't specified then whitespace on the left and right sides of the string is cleared. If TRUE then only the left whitespace is cleared. If FALSE then only the right whitespace is cleared.

Return value description

The string.

Overrides: Call only the highest priority method

NOT Common to all objects


TimerAdd


Adds a new timer to the object.

This adds a new timer to the object. If the timers in the object are suspended then this timer will be added in a suspended state too.

Example:

Object.TimerAdd ("MyTimer", TRUE, 1.5, MyMethod, Param1, Param2);



Parameter Name

Description

Name

The name of the timer. Usually this is a string, but it can be any value. If the name is already used for a timer then this call will fail and return FALSE. (NOTE: Name comparisons are CASE SENSATIVE.)

Repeat

If TRUE then the timer keeps repeating until it is removed using TimerRemove(). If FALSE then the timer only runs once before it is automatically removed.

Interval

The number of seconds (or fraction) before the timer goes off. If this is a repeating timer then this is also the number of seconds between repetitions.

Call

This is the function or method to call when the timer goes off.

CallParams

(Optional) Zero or more parameters passed into the function (or method) when the timer goes off.

Return value description

TRUE if the timer was added, FALSE if an error occured.

Overrides: Call only the highest priority method

Common to all objects


TimerEnum


Enumerates all the timers in an object.

This enumerates all the timers in an object. It returns a list with the timers names.

Example:

Object.TimerAdd ("MyTimer", TRUE, 1.5, MyMethod, Param1, Param2);

return Object.TimerEnum();

Returns ["MyTimer"].



Parameter Name

Description

Return value description

List of all the timers in the object. This may be an empty list if there are no timers.

Overrides: Call only the highest priority method

Common to all objects


TimerQuery


Deletes a timer from an object.

This deletes a timer from an object.

Example:

Object.TimerAdd ("MyTimer", TRUE, 1.5, MyMethod, Param1, Param2);

Object.TimerRemove ("MyTimer");

Parameter Name

Description

Name

The name of the timer, as passed into TimerAdd(). This is a CASE SENSATIVE compare.

Return value description

TRUE if the timer was found and removed. FALSE if the timer wasn't found.

Overrides: Call only the highest priority method

Common to all objects


TimerRemove


Deletes a timer from an object.

This deletes a timer from an object.

Example:

Object.TimerAdd ("MyTimer", TRUE, 1.5, MyMethod, Param1, Param2);

Object.TimerRemove ("MyTimer");

Parameter Name

Description

Name

The name of the timer, as passed into TimerAdd(). This is a CASE SENSATIVE compare.

Return value description

TRUE if the timer was found and removed. FALSE if the timer wasn't found.

Overrides: Call only the highest priority method

Common to all objects


TimerSuspendGet


Returns 0.0 if the object's timers are suspended, 1.0 if they're active, or different values if they're slowed down.

Returns 0.0 if the object's timers are suspended.

Returns 1.0 if the object's timers are active.

The object's timers might also be slowed down (a value between 0.0 and 1.0) or sped up (above 1.0).

See also TimerSuspendedSet().

Parameter Name

Description

Return value description

Returns TRUE if the object's timers are suspended, FALSE if they are active.

Overrides: Call only the highest priority method

Common to all objects


TimerSuspendSet


Suspends, resumes, or changes the speed of an object's timers.

This suspends, resumes, or changes the speed of an object's timers.

An application can use this to quickly and easily suspend timers for an object when the object is inactive. Or, the object's timers can be slowed down when it doesn't need accurate timing.

Parameter Name

Description

TimerSpeed

(Optional) If 0.0 then all the object's timers will be suspended. If 1.0 then any suspended timers will be resumed. If not specified then it will suspend the object (with 0.0 value).

If between 0.0 and 1.0, the timers will be activated, but at a slower pace. If above 1.0, the timers will be activated at an accelerated pace.



SuspendContains

(Optional) If TRUE this will suspend all the objects contained by this object, and whatever they contain. If FALSE then only this object will be suspended (or resumed). If not specified then only this object will be affected.

Return value description

None.

Overrides: Call only the highest priority method

Common to all objects



Download 8.87 Mb.

Share with your friends:
1   ...   132   133   134   135   136   137   138   139   ...   151




The database is protected by copyright ©ininet.org 2024
send message

    Main page