40 lines
1.3 KiB
Factor
40 lines
1.3 KiB
Factor
USING: help.markup help.syntax sequences strings ;
|
|
IN: pcre
|
|
|
|
ARTICLE: "pcre" "PCRE binding"
|
|
"The " { $vocab-link "pcre" } " vocab implements a simple binding for libpcre, enabling rich regular expression support for Factor applications." $nl
|
|
"Precompiling and optimizing a regular expression:"
|
|
{ $subsections <compiled-pcre> }
|
|
{ $examples
|
|
{ $code
|
|
"USING: pcre ; "
|
|
"\"foobar\" \"\\\\w\" findall"
|
|
}
|
|
}
|
|
{ $notes "Regular expressions are by default utf8 and unicode aware." } ;
|
|
|
|
HELP: <compiled-pcre>
|
|
{ $values { "expr" string } { "compiled-pcre" compiled-pcre } }
|
|
{ $description "Creates a precompiled regular expression object." } ;
|
|
|
|
HELP: findall
|
|
{ $values
|
|
{ "subject" string }
|
|
{ "obj" "a string, compiled regular expression or a regexp literal" }
|
|
{ "matches" sequence }
|
|
}
|
|
{ $description "Finds all matches of the given regexp in the string. Matches is sequence of associative array where the key is the name of the capturing group, or f to denote the full match." }
|
|
{ $examples
|
|
{ $code
|
|
"USE: pcre"
|
|
"\"foobar\" \"(?<ch1>\\\\w)(?<ch2>\\\\w)\" findall ."
|
|
"{"
|
|
" { { f \"fo\" } { \"ch1\" \"f\" } { \"ch2\" \"o\" } }"
|
|
" { { f \"ob\" } { \"ch1\" \"o\" } { \"ch2\" \"b\" } }"
|
|
" { { f \"ar\" } { \"ch1\" \"a\" } { \"ch2\" \"r\" } }"
|
|
"}"
|
|
}
|
|
} ;
|
|
|
|
ABOUT: "pcre"
|