pcre2_jit_match.3 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. .TH PCRE2_JIT_MATCH 3 "11 February 2020" "PCRE2 10.35"
  2. .SH NAME
  3. PCRE2 - Perl-compatible regular expressions (revised API)
  4. .SH SYNOPSIS
  5. .rs
  6. .sp
  7. .B #include <pcre2.h>
  8. .PP
  9. .nf
  10. .B int pcre2_jit_match(const pcre2_code *\fIcode\fP, PCRE2_SPTR \fIsubject\fP,
  11. .B " PCRE2_SIZE \fIlength\fP, PCRE2_SIZE \fIstartoffset\fP,"
  12. .B " uint32_t \fIoptions\fP, pcre2_match_data *\fImatch_data\fP,"
  13. .B " pcre2_match_context *\fImcontext\fP);"
  14. .fi
  15. .
  16. .SH DESCRIPTION
  17. .rs
  18. .sp
  19. This function matches a compiled regular expression that has been successfully
  20. processed by the JIT compiler against a given subject string, using a matching
  21. algorithm that is similar to Perl's. It is a "fast path" interface to JIT, and
  22. it bypasses some of the sanity checks that \fBpcre2_match()\fP applies.
  23. Its arguments are exactly the same as for
  24. .\" HREF
  25. \fBpcre2_match()\fP,
  26. .\"
  27. except that the subject string must be specified with a length;
  28. PCRE2_ZERO_TERMINATED is not supported.
  29. .P
  30. The supported options are PCRE2_NOTBOL, PCRE2_NOTEOL, PCRE2_NOTEMPTY,
  31. PCRE2_NOTEMPTY_ATSTART, PCRE2_PARTIAL_HARD, and PCRE2_PARTIAL_SOFT. Unsupported
  32. options are ignored. The subject string is not checked for UTF validity.
  33. .P
  34. The return values are the same as for \fBpcre2_match()\fP plus
  35. PCRE2_ERROR_JIT_BADOPTION if a matching mode (partial or complete) is requested
  36. that was not compiled. For details of partial matching, see the
  37. .\" HREF
  38. \fBpcre2partial\fP
  39. .\"
  40. page.
  41. .P
  42. There is a complete description of the PCRE2 native API in the
  43. .\" HREF
  44. \fBpcre2api\fP
  45. .\"
  46. page and a description of the JIT API in the
  47. .\" HREF
  48. \fBpcre2jit\fP
  49. .\"
  50. page.