Difference between revisions of "String.match"

From GiderosMobile
m (remove language stuff)
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 +
'''Class:''' [[string]]<br/>
 +
 
=== Description ===
 
=== Description ===
Find the first match of the regular expression "pattern" in "str", starting at position "index".
+
Finds the first match of the regular expression "pattern" in "str", starting at position "index". The starting position (index) is optional, and defaults to 1 (the start of the string).
  
The starting position (index) is optional, and defaults to 1 (the start of the string).
+
If found, returns any captures in the pattern. If no captures were specified the entire matching string is returned. If not found, returns nil.
 
+
<source lang="lua">
If found, returns any captures in the pattern. If no captures were specified the entire matching string is returned.
+
(string) = string.match(string,pattern)
 
+
</source>
If not found, returns nil.
+
'''note''': this is similar to string.find, except that the starting and ending index are not returned.
  
This is similar to string.find, except that the starting and ending index are not returned.
+
=== Parameters ===
 +
'''string''': (String) any string<br/>
 +
'''pattern''': (String) specifies the pattern to match<br/>
  
 +
=== Return values ===
 +
'''Returns''' (string) string matching pattern<br/>
  
print (string.match ("You see dogs and cats", "s..")) --> see
+
=== Example ===
 
<source lang="lua">
 
<source lang="lua">
(string) = string.match(string,pattern)
+
print (string.match ("You see dogs and cats", "s..")) -- see
 
</source>
 
</source>
'''string''': (String) Any string. ''''''<br/>
+
 
'''pattern''': (String) Specifies the pattern to match. ''''''<br/>
+
{{String}}
'''Returns''' (string) String matching pattern.<br/>
 

Revision as of 04:45, 24 February 2021

Available since: Gideros 2011.6
Class: string

Description

Finds the first match of the regular expression "pattern" in "str", starting at position "index". The starting position (index) is optional, and defaults to 1 (the start of the string).

If found, returns any captures in the pattern. If no captures were specified the entire matching string is returned. If not found, returns nil.

(string) = string.match(string,pattern)

note: this is similar to string.find, except that the starting and ending index are not returned.

Parameters

string: (String) any string
pattern: (String) specifies the pattern to match

Return values

Returns (string) string matching pattern

Example

print (string.match ("You see dogs and cats", "s..")) -- see