chiark / gitweb /
pcre3 (1:8.30-5) unstable; urgency=low
[pcre3.git] / doc / html / pcre_pattern_to_host_byte_order.html
1 <html>
2 <head>
3 <title>pcre_pattern_to_host_byte_order specification</title>
4 </head>
5 <body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
6 <h1>pcre_pattern_to_host_byte_order man page</h1>
7 <p>
8 Return to the <a href="index.html">PCRE index page</a>.
9 </p>
10 <p>
11 This page is part of the PCRE HTML documentation. It was generated automatically
12 from the original man page. If there is any nonsense in it, please consult the
13 man page, in case the conversion went wrong.
14 <br>
15 <br><b>
16 SYNOPSIS
17 </b><br>
18 <P>
19 <b>#include &#60;pcre.h&#62;</b>
20 </P>
21 <P>
22 <b>int pcre_pattern_to_host_byte_order(pcre *<i>code</i>,</b>
23 <b>pcre_extra *<i>extra</i>, const unsigned char *<i>tables</i>);</b>
24 </P>
25 <P>
26 <b>int pcre16_pattern_to_host_byte_order(pcre16 *<i>code</i>,</b>
27 <b>pcre16_extra *<i>extra</i>, const unsigned char *<i>tables</i>);</b>
28 </P>
29 <br><b>
30 DESCRIPTION
31 </b><br>
32 <P>
33 This function ensures that the bytes in 2-byte and 4-byte values in a compiled
34 pattern are in the correct order for the current host. It is useful when a
35 pattern that has been compiled on one host is transferred to another that might
36 have different endianness. The arguments are:
37 <pre>
38   <i>code</i>         A compiled regular expression
39   <i>extra</i>        Points to an associated <b>pcre[16]_extra</b> structure,
40                  or is NULL
41   <i>tables</i>       Pointer to character tables, or NULL to
42                  set the built-in default
43 </pre>
44 The result is 0 for success, a negative PCRE_ERROR_xxx value otherwise.
45 </P>
46 <P>
47 There is a complete description of the PCRE native API in the
48 <a href="pcreapi.html"><b>pcreapi</b></a>
49 page and a description of the POSIX API in the
50 <a href="pcreposix.html"><b>pcreposix</b></a>
51 page.
52 <p>
53 Return to the <a href="index.html">PCRE index page</a>.
54 </p>