Regular Expression

Header file

#include "mln_regexp.h"

Module

regexp

Functions/Macros

mln_reg_match

int mln_reg_match(mln_string_t *exp, mln_string_t *text, mln_reg_match_result_t *matches);

Description: match the text by expression exp, and store the matched string results in matches. matches is created by the mln_reg_match_result_new function.

Note: The match result matches is an array, where each element is of type string mln_string_t. The memory pointed to by the data member of the string is the memory of text that is directly referenced, so the memory of text should not be released before the matching results are used.

Return value:

0 an exact match
>0 Number of matching results
<0 Execution error failed, possibly due to insufficient memory.

mln_reg_equal

int mln_reg_equal(mln_string_t *exp, mln_string_t *text);

Description: Determine whether text completely matches the regular expression exp.

Return value: Returns non-0 if there is a complete match, otherwise returns 0

mln_reg_match_result_new

mln_reg_match_result_new(prealloc)；

Description: Create an array of matching results. prealloc preallocates the number of elements for the array.

Return value:

Success - mln_reg_match_result_t pointer
Failure - NULL

mln_reg_match_result_free

mln_reg_match_result_free(res);

Description: Release the match result returned by mln_reg_match.

Return value: None

mln_reg_match_result_get

mln_reg_match_result_get(res)

Description: Get the starting address of the matching result array.

Return value: mln_string_t pointer

Example

#include <stdio.h>
#include "mln_regexp.h"

int main(int argc, char *argv[])
{
    mln_reg_match_result_t *res = NULL;
    mln_string_t text = mln_string("dabcde");
    mln_string_t exp = mln_string("a.c.*e");
    mln_string_t *s;
    int i, n;

    if ((res = mln_reg_match_result_new(1)) == NULL) {
        fprintf(stderr, "new match result failed.\n");
        return -1;
    }

    n = mln_reg_match(&exp, &text, res);
    printf("matched: %d\n", n);

    s = mln_reg_match_result_get(res);
    for (i = 0; i < n; ++i) {
        write(STDOUT_FILENO, s[i].data, s[i].len);
        write(STDOUT_FILENO, "\n", 1);
    }

    mln_reg_match_result_free(res);

    n = mln_reg_equal(&exp, &text);
    printf("equal returned %d\n", n);

    return 0;
}

Regular Expression