regexFind: Difference between revisions

Latest revision as of 19:48, 3 September 2024

2.06

Hover & click on the images for description

Description

Description:: Searches in a string with a regular expression.
ⓘ
See Arma 3: Regular Expressions.
Groups:: Strings - Regular Expression

Syntax

Syntax:

haystack regexFind [pattern, startOffset]

Parameters:

haystack: String

pattern: String - format regex pattern

startOffset: Number - (Optional, default 0) has to be in range from 0 to count haystack (haystack's length)

Return Value:

Array of nested arrays. Each lowest level array in format:

0: String - match
1: Number - offset of given match relative to haystack beginning (the provided offset is ignored)

Examples

Example 1:: "wooKie boOkie cookie" regexFind [".ookie/gio"]; // [[["wooKie", 0]], [["boOkie", 7]], [["cookie", 14]]]
Example 2:: "wooKie boOkie cookie" regexFind [".ookie/i"]; // [[["wooKie",0]]]
Example 3:: "wooKie boOkie cookie" regexFind [".ookie/"]; // [[["cookie", 14]]]
Example 4:: Multiline example:
"co1kie2 co2kie" regexFind ["^co.kie$"]; // [[["co2kie",9]]]
Example 5:: "I'm a cookie clicker" regexFind ["c(.*?)k(.*?)e/i"]; // [[["cookie",6], ["oo", 7], ["i", 10]]]
Example 6:: "I'm a cookie clicker" regexFind ["c(.*?)k(.*?)e"]; // [[["cookie", 6], ["oo", 7], ["i", 10]], [["clicke", 13], ["lic", 14], ["", 18]]]

Additional Information

See also:: regexMatch regexReplace

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

@@ Line 15: / Line 15: @@
 |p2= pattern: [[String]] - format [[Arma 3: Regular Expressions|regex pattern]]
-|p3= offset: [[Number]] - (Optional, default: 0) has to be in range from 0 to {{ic|[[count]] ''haystack''}} (''haystack length'')
+|p3= startOffset: [[Number]] - (Optional, default 0) has to be in range from 0 to <sqf inline>count haystack</sqf> (''haystack''<nowiki/>'s length)
 |r1= [[Array]] of nested arrays. Each lowest level array in format:
@@ Line 21: / Line 21: @@
 * 1: [[Number]]  - offset of given match relative to ''haystack'' beginning (the provided ''offset'' is ignored)
-|x1= <code>"wooKie boOkie cookie" [[regexFind]] [".ookie/gio"]; {{cc|<nowiki>[[["wooKie", 0]], [["boOkie", 7]], [["cookie", 14]]]</nowiki>}}</code>
+|x1= <sqf>"wooKie boOkie cookie" regexFind [".ookie/gio"]; // [[["wooKie", 0]], [<nowiki/>["boOkie", 7]], [<nowiki/>["cookie", 14]]]</sqf>
-|x2= <code>"wooKie boOkie cookie" [[regexFind]] [".ookie/i"]; {{cc|<nowiki>[[["wooKie",0]]]</nowiki>}}</code>
+|x2= <sqf>"wooKie boOkie cookie" regexFind [".ookie/i"]; // [[["wooKie",0]]]</sqf>
-|x3= <code>"wooKie boOkie cookie" [[regexFind]] [".ookie/"]; {{cc|<nowiki>[[["cookie", 14]]]</nowiki>}}</code>
+|x3= <sqf>"wooKie boOkie cookie" regexFind [".ookie/"]; // [[["cookie", 14]]]</sqf>
 |x4= Multiline example:
-<code>"co1kie2
+<sqf>
-co2kie" [[regexFind]] ["^co.kie$"]; {{cc|<nowiki>[[["co2kie",9]]]</nowiki>}}</code>
+"co1kie2
+co2kie" regexFind ["^co.kie$"]; // [[["co2kie",9]]]</sqf>
-|x5= <code>"I'm a cookie clicker" [[regexFind]] ["c(.*?)k(.*?)e/i"]; {{cc|<nowiki>[[["cookie",6], ["oo", 7], ["i", 10]]]</nowiki>}}</code>
+|x5= <sqf>
+"I'm a cookie clicker" regexFind ["c(.*?)k(.*?)e/i"]; // [[["cookie",6], ["oo", 7], ["i", 10]]]
+</sqf>
-|x6= <code>"I'm a cookie clicker" [[regexFind]] ["c(.*?)k(.*?)e"]; {{cc|<nowiki>[[["cookie", 6], ["oo", 7], ["i", 10]], [["clicke", 13], ["lic", 14], ["", 18]]]</nowiki>}}</code>
+|x6= <sqf>"I'm a cookie clicker" regexFind ["c(.*?)k(.*?)e"]; // [[["cookie", 6], ["oo", 7], ["i", 10]], [["clicke", 13], ["lic", 14], ["", 18]]]</sqf>
 |seealso= [[regexMatch]] [[regexReplace]]
 }}