PregReplace: Difference between revisions

Revision as of 07:47, 11 January 2014

ADDED/UPDATED IN VERSION 1.3.5 :

This function performs a regular expression search and replace and returns the replaced string.

Syntax

string pregReplace ( string subject, string pattern, string replacement )

Required Arguments

subject: The input string.
pattern: The pattern string to search for in the input string.
replacement: The replacement string to replace all matches within the input string.

Returns

Returns the replaced string, or bool false otherwise.

Example

Click to collapse [-]

Shared ( client and server )

Some examples:

addCommandHandler( 'examples',
	function( )
                -- Replace doh with done
		outputDebugString( pregReplace( 'I doh this, guys.', 'doh', 'done' ) or 'not replaced' ) -- Result: I done this, guys
                -- Remove all uppercase alphabetic characters
                outputDebugString( pregReplace( 'AaaBbbZzz', '[A-Z]{1,}', '' ) or 'not replaced' ) -- Result: aabbzz
	end
)

Requirements

Minimum server version	1.3.5-9.06056
Minimum client version	1.3.5-9.06056

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.3.5-9.06056" client="1.3.5-9.06056" />

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{Server client function}}
-{{New feature/item|4.0140|1.4|5106|
+{{New items|4.0135|1.3.5|
 This function performs a regular expression search and replace and returns the replaced string.
 }}
@@ Line 34: / Line 34: @@
 ==Requirements==
-{{Requirements|1.4-9.05106|1.4-9.05106|}}
+{{Requirements|1.3.5-9.06056|1.3.5-9.06056|}}
 ==See Also==
 {{Utility_functions}}