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.