PCRE_EXEC(3) Library Functions Manual PCRE_EXEC(3) NNAAMMEE PCRE - Perl-compatible regular expressions SSYYNNOOPPSSIISS ##iinncclluuddee <> iinntt ppccrree__jjiitt__eexxeecc((ccoonnsstt ppccrree **_c_o_d_e,, ccoonnsstt ppccrree__eexxttrraa **_e_x_t_r_a,, ccoonnsstt cchhaarr **_s_u_b_j_e_c_t,, iinntt _l_e_n_g_t_h,, iinntt _s_t_a_r_t_o_f_f_s_e_t,, iinntt _o_p_t_i_o_n_s,, iinntt **_o_v_e_c_t_o_r,, iinntt _o_v_e_c_s_i_z_e,, ppccrree__jjiitt__ssttaacckk **_j_s_t_a_c_k));; iinntt ppccrree1166__jjiitt__eexxeecc((ccoonnsstt ppccrree1166 **_c_o_d_e,, ccoonnsstt ppccrree1166__eexxttrraa **_e_x_t_r_a,, PPCCRREE__SSPPTTRR1166 _s_u_b_j_e_c_t,, iinntt _l_e_n_g_t_h,, iinntt _s_t_a_r_t_o_f_f_s_e_t,, iinntt _o_p_t_i_o_n_s,, iinntt **_o_v_e_c_t_o_r,, iinntt _o_v_e_c_s_i_z_e,, ppccrree__jjiitt__ssttaacckk **_j_s_t_a_c_k));; iinntt ppccrree3322__jjiitt__eexxeecc((ccoonnsstt ppccrree3322 **_c_o_d_e,, ccoonnsstt ppccrree3322__eexxttrraa **_e_x_t_r_a,, PPCCRREE__SSPPTTRR3322 _s_u_b_j_e_c_t,, iinntt _l_e_n_g_t_h,, iinntt _s_t_a_r_t_o_f_f_s_e_t,, iinntt _o_p_t_i_o_n_s,, iinntt **_o_v_e_c_t_o_r,, iinntt _o_v_e_c_s_i_z_e,, ppccrree__jjiitt__ssttaacckk **_j_s_t_a_c_k));; DDEESSCCRRIIPPTTIIOONN This function matches a compiled regular expression that has been suc- cessfully studied with one of the JIT options against a given subject string, using a matching algorithm that is similar to Perl's. It is a "fast path" interface to JIT, and it bypasses some of the sanity checks that ppccrree__eexxeecc(()) applies. It returns offsets to captured substrings. Its arguments are: _c_o_d_e Points to the compiled pattern _e_x_t_r_a Points to an associated ppccrree[[1166||3322]]__eexxttrraa structure, or is NULL _s_u_b_j_e_c_t Points to the subject string _l_e_n_g_t_h Length of the subject string, in bytes _s_t_a_r_t_o_f_f_s_e_t Offset in bytes in the subject at which to start matching _o_p_t_i_o_n_s Option bits _o_v_e_c_t_o_r Points to a vector of ints for result offsets _o_v_e_c_s_i_z_e Number of elements in the vector (a multiple of 3) _j_s_t_a_c_k Pointer to a JIT stack The allowed options are: PCRE_NOTBOL Subject string is not the beginning of a line PCRE_NOTEOL Subject string is not the end of a line PCRE_NOTEMPTY An empty string is not a valid match PCRE_NOTEMPTY_ATSTART An empty string at the start of the subject is not a valid match PCRE_NO_UTF16_CHECK Do not check the subject for UTF-16 validity (only relevant if PCRE_UTF16 was set at compile time) PCRE_NO_UTF32_CHECK Do not check the subject for UTF-32 validity (only relevant if PCRE_UTF32 was set at compile time) PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8 validity (only relevant if PCRE_UTF8 was set at compile time) PCRE_PARTIAL ) Return PCRE_ERROR_PARTIAL for a partial PCRE_PARTIAL_SOFT ) match if no full matches are found PCRE_PARTIAL_HARD Return PCRE_ERROR_PARTIAL for a partial match if that is found before a full match However, the PCRE_NO_UTF[8|16|32]_CHECK options have no effect, as this check is never applied. For details of partial matching, see the ppccrreeppaarrttiiaall page. A ppccrree__eexxttrraa structure contains the following fields: _f_l_a_g_s Bits indicating which fields are set _s_t_u_d_y___d_a_t_a Opaque data from ppccrree[[1166||3322]]__ssttuuddyy(()) _m_a_t_c_h___l_i_m_i_t Limit on internal resource use _m_a_t_c_h___l_i_m_i_t___r_e_c_u_r_s_i_o_n Limit on internal recursion depth _c_a_l_l_o_u_t___d_a_t_a Opaque data passed back to callouts _t_a_b_l_e_s Points to character tables or is NULL _m_a_r_k For passing back a *MARK pointer _e_x_e_c_u_t_a_b_l_e___j_i_t Opaque data from JIT compilation The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT, PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, PCRE_EXTRA_TABLES, PCRE_EXTRA_MARK and PCRE_EXTRA_EXECUTABLE_JIT. There is a complete description of the PCRE native API in the ppccrreeaappii page and a description of the JIT API in the ppccrreejjiitt page. PCRE 8.30 31 October 2012 PCRE_EXEC(3)