View on
MetaCPAN
Reini Urban > re-engine-Hyperscan-0.01 > re::engine::Hyperscan

Download:
re-engine-Hyperscan-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

NAME ^

re::engine::Hyperscan - High-performance regular expression matching library (Intel only)

SYNOPSIS ^

    use re::engine::Hyperscan;

    if ("Hello, world" =~ /(Hello|Hi), (world)/) {
        print "Greetings, $1!";
    }

DESCRIPTION ^

ALPHA - Does not work YET

Replaces perl's regex engine in a given lexical scope with Intel's Hyperscan regular expressions provided by libhyperscan.

This provides the fastest regular expression library on Intel-CPU's only, but needs to fall back to the core perl regexp compiler with backtracking, lookbehind, zero-width assertions and more advanced patterns. It is typically 50% faster then the core regex engine.

For the supported syntax see https://01org.github.io/hyperscan/dev-reference/compilation.html.

With the following unsupported constructs in the pattern, the compiler will fall back to the core re engine:

Backreferences and capturing sub-expressions.
Arbitrary zero-width assertions.
Subroutine references and recursive patterns.
Conditional patterns.
Backtracking control verbs.
The \C "single-byte" directive (which breaks UTF-8 sequences).
The \R newline match.
The \K start of match reset directive.
Callouts and embedded code.
Atomic grouping and possessive quantifiers.

METHODS ^

min_width (RX)

Returns the result from hs_expression_info(). NYI The minimum length in bytes of a match for the pattern.

max_width (RX)

Returns the result from hs_expression_info(). NYI The maximum length in bytes of a match for the pattern. If the pattern has an unbounded maximum width, this will be set to the maximum value of an unsigned int (UINT_MAX).

unordered_matches (RX)

Returns the result from hs_expression_info(). NYI Whether this expression can produce matches that are not returned in order, such as those produced by assertions.

matches_at_eod (RX)

Returns the result from hs_expression_info(). NYI Whether this expression can produce matches at end of data (EOD).

matches_only_at_eod (RX)

Returns the result from hs_expression_info(). NYI Whether this expression can *only* produce matches at end of data (EOD).

FUNCTIONS ^

ENGINE

Returns a pointer to the internal Hyperscan engine, the database, suitable for the XS API (regexp*)re->engine field.

AUTHORS ^

Reini Urban <rurban@cpan.org>

COPYRIGHT ^

Copyright 2017 Reini Urban.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: