PregReplace: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 7: Line 7:
==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string pregReplace ( string subject, string pattern, string replacement )
string pregReplace ( string subject, string pattern, string replacement, uint = 0 )
</syntaxhighlight>
</syntaxhighlight>


Line 14: Line 14:
*'''pattern:''' The pattern [[string]] to search for in 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]].
*'''replacement:''' The replacement [[string]] to replace all matches within the input [[string]].
===Optional Arguments===
*'''flags:''' Conjuncted value that contains flags ( 1 - ignorecase, 2 - multiline, 4 - dotall, 8 - extented ).


===Returns===
===Returns===

Revision as of 16:19, 19 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, uint = 0 )

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.

Optional Arguments

  • flags: Conjuncted value that contains flags ( 1 - ignorecase, 2 - multiline, 4 - dotall, 8 - extented ).

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

This template will be deleted.

See Also