Gettok: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string gettok ( string text, int tokenNumber, int seperatingCharacter )
string gettok ( string text, int tokenNumber, int separatingCharacter )
</syntaxhighlight>  
</syntaxhighlight>  


Line 11: Line 11:
*'''text:''' The string that should be split
*'''text:''' The string that should be split
*'''tokenNumber:''' Which token should be returned (1 for the first, 2 for the second, ..)
*'''tokenNumber:''' Which token should be returned (1 for the first, 2 for the second, ..)
*'''seperatingCharacter:''' The ASCII number of the character that seperates the strings (for example 44 for ',')
*'''separatingCharacter:''' The ASCII number of the character that seperates the strings (for example 44 for ',')


===Returns===
===Returns===
Returns ''string'' with the token if it exists, ''false'' otherwise.
Returns the token if it exists, ''false'' otherwise.


==Example==  
==Example==  
Line 26: Line 26:
local endskin = gettok ( skins, 2, 44 )
local endskin = gettok ( skins, 2, 44 )
-- Get a random skin of the range
-- Get a random skin of the range
local skin = randInt(tonumber(startskin),tonumber(endskin))
local skin = randInt ( tonumber(startskin), tonumber(endskin) )
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>

Revision as of 18:20, 17 August 2007

This function splits a string using the given seperating character and returns one part as a string.

Syntax

string gettok ( string text, int tokenNumber, int separatingCharacter )

Required Arguments

  • text: The string that should be split
  • tokenNumber: Which token should be returned (1 for the first, 2 for the second, ..)
  • separatingCharacter: The ASCII number of the character that seperates the strings (for example 44 for ',')

Returns

Returns the token if it exists, false otherwise.

Example

Click to collapse [-]
Server

This example retrieves the startskin and endskin for spawning a player

-- Put the string with the skins in a variable. Normally you would read it from a .map file or something.
local skins = "20,30"
-- Get the startskin and endskin (20 and 30)
local startskin = gettok ( skins, 1, 44 )
local endskin = gettok ( skins, 2, 44 )
-- Get a random skin of the range
local skin = randInt ( tonumber(startskin), tonumber(endskin) )

See Also