string.Explode

From Garry's Mod
Jump to: navigation, search
 string.Explode( )

Contents

Description

Splits a string up wherever it finds the given separator.

This is the reverse of string.Implode.

Arguments

string separator

The string will be separated wherever this sequence is found.

Arguments

string str

The string to split up.

Arguments

boolean use_patterns

Set this to true if your separator is a pattern.

Returns

table

Exploded string as a numerical sequential table.

Examples

Example

Splits a sentence into a table of the words in it.

local sentence = "hello there my name is Player1"
local words = string.Explode( " ", sentence )
PrintTable( words )

Output:

1 = hello
2 = there
3 = my
4 = name
5 = is
6 = Player1

Examples

Example

Uses Explode to sort through words that a player says.

hook.Add( "PlayerSay", "GiveHealth", function( ply, text )
	local playerInput = string.Explode( " ", text )

	if ( playerInput[1] == "!givehealth" ) then 

		if ( tonumber( playerInput[2] ) ) then

			ply:SetHealth( tonumber( playerInput[2] ) )

			print( ply:Nick() .. " set their health to " .. playerInput[2] )

		end

	end

end)

Output:

Player1 set their health to 100.
Personal tools
Navigation