# $str.match

Matches a fixed string against a wildcard expression

Usage

    $str.match(<expression>,<string>[,<flags>[,<case>]])

Description

Returns 1 if the fixed <string> matches the <expression>, 0 otherwise.
If <flags> contains the flag 'r' then <expression> is treated as a full regular expression otherwise it is treated as a simple wildcard expression containing the classic wildcards '*' and '?'.
If <flags> contains the flag 'e' then only an exact match is considered (e.g. the full <string> is exactly matched by <expression>), otherwise partial matches are allowed too (e.g. <expression> is found inside <string>).
If the third parameter is set to true, then the match is case sensitive.

Syntax Specification

    <bool> $str.match(<expression:string>,<string:string>[,<flags:string>[,<case:bool>]])

Examples

        %test = "Hello! My nickname is Pragma"
        if($str.match(Pragma*,%test))echo "Matches Pragma*"
        if($str.match(*Pragma,%test))echo "Matches *Pragma"
        if($str.match(H*y*i?k*a,%test))echo "Matches H*y*i?k*a"
        if($str.match(H*y*i?K*a,%test))echo "Matches H*y*i?K*a"

See also
$str.contains(),$str.equal()

Index, Functions

KVIrc 4.2.0.6190 Documentation
Generated by root at Sun Jul 21 22:14:44 2013