[Plugin] Pawn.Regex - full support of regular expressions

[YourShadow]

Pawn.Regex 1.1.2

Description:
Pawn.Regex is a plugin that allows you to work with regular expressions.

Why is it better than others plugins? Because it gives you an opportunity to get match results.

Natives:

PHP Code:

native Regex:Regex_New(const pattern[], E_REGEX_FLAG:flags = REGEX_DEFAULT, E_REGEX_GRAMMAR:grammar = REGEX_ECMASCRIPT);
native Regex_Delete(&Regex:r);

native Regex_Check(const str[], Regex:r, E_MATCH_FLAG:flags = MATCH_DEFAULT);
native Regex_Match(const str[], Regex:r, &RegexMatch:m, E_MATCH_FLAG:flags = MATCH_DEFAULT);
native Regex_Search(const str[], Regex:r, &RegexMatch:m, &pos, startpos = 0, E_MATCH_FLAG:flags = MATCH_DEFAULT);
native Regex_Replace(const str[], Regex:r, const fmt[], dest[], E_MATCH_FLAG:flags = MATCH_DEFAULT, size = sizeof dest);

native Match_GetGroup(RegexMatch:m, index, dest[], &length, size = sizeof dest);
native Match_Free(&RegexMatch:m); 


Examples:

PHP Code:

#include <Pawn.Regex>

stock IsRpNickname(nickname[])
{
    new Regex:r = Regex_New("[A-Z][a-z]+_[A-Z][a-z]+");

    new check = Regex_Check(nickname, r);

    Regex_Delete(r);

    return check;
}

public OnPlayerCommandText(playerid, cmdtext[])
{
    new
        Regex:r = Regex_New("^\\/([\\w]+)\\s*(.+?)?\\s*$"),
        RegexMatch:m,
        cmd[16], params[256],
        cmd_length, params_length;

    if (Regex_Match(cmdtext, r, m))
    {
        Match_GetGroup(m, 1, cmd, cmd_length);
        Match_GetGroup(m, 2, params, params_length);

        Match_Free(m);
    }

    printf("cmd '%s' (%d), params '%s' (%d)", cmd, cmd_length, params, params_length);

    Regex_Delete(r);

    return 1;
}

stock SplitAndPrint(str[])
{
    new Regex:r = Regex_New("[^\\s]+");

    if (r)
    {
        new RegexMatch:m;
        new startpos, pos;

        while (Regex_Search(str, r, m, pos, startpos))
        {
            new word[128], length;

            if (!Match_GetGroup(m, 0, word, length))
            {
                break;
            }

            printf("word: %s", word);

            startpos += pos + length;

            Match_Free(m);
        }

        Regex_Delete(r);
    }
}

stock ReplaceString(const str[], const regexp[], const fmt[], dest[], size = sizeof dest)
{
    new Regex:r = Regex_New(regexp);

    if (r)
    {
        Regex_Replace(str, r, fmt, dest, MATCH_DEFAULT, size);

        Regex_Delete(r);
    }
}

main()
{
    new str[128];

    ReplaceString("Pawn.CMD", "CMD", "Regex", str);

    printf("%s", str);

    SplitAndPrint("4 8 15 16 23 42");

    OnPlayerCommandText(-1, "/ban 42");
    OnPlayerCommandText(-1, "/kill");

    printf("%d %d", IsRpNickname("Your_Shadow"), IsRpNickname("urShadow"));
} 


Changelog:
1.0:
- First release
1.1:
- Fixed bugs
- Changed native "match_get_group"
1.1.1:
- Fixed error "File or function is not found"
1.1.2:
- Changed naming conventions
- Added pawn.json
- Improved OnPlayerCommandText example

Download binaries:
https://github.com/urShadow/Pawn.Regex/releases

Source code:
https://github.com/urShadow/Pawn.Regex

[Max_Andolini]

You are Incredible

[Roozevelt]

Such wonderrful plugin , good job mate

[FuNkYTheGreat]

Another Awesome Release by You,
YourShadow.

[YourShadow]

Originally Posted by Ralfie

Are we supposed to regex_search to detect occurrences in the middle of strings?

Yes.

Originally Posted by Ralfie

Can't we simply use regex_check?

The entire target sequence must match the regular expression for this function to return true (i.e., without any additional characters before or after the match).

[Gasman]

i can check Valid Email string with this?

[YourShadow]

Originally Posted by Gasman

i can check Valid Email string with this?

Of course.

[YourShadow]

Pawn.Regex was updated to version 1.1.

- Fixed bugs.
- Changed native "match_get_group"

[Luicy.]

Nice I guess, But what makes this so much better than strfind? All difference I can see are it's cleaner.

[Arturo226]

I've downloaded 1.1, however I get the following on server launch:

Plugin::AmxLoad: .inc-file version does not equal the plugin's version
Run time error 19: "File or function not found"

I am running this on a Windows server.