php-doc-en/reference/regex/book.xml
Adam Harvey b38c2956ff Begin beefing up our warnings for things removed in 7.0.
First up: ereg.

I've added a couple of new snippets based on the MySQL snippets that allow us
to provide alternatives in the big red warning box atop each page, since that
approach seems to work well there. I'll add more variations as required as I
work through the various extensions that need to be updated.

In general, I'd like to use this approach more consistently moving forward as
we deprecate and remove things, since it gives the user a very obvious link to
follow to find out about the new way of doing things.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@338425 c90b9560-bf6c-de11-be94-00142212c4b1
2016-01-08 00:42:05 +00:00

75 lines
2.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<book xml:id="book.regex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="core" ?>
<title>Regular Expression (POSIX Extended)</title>
<titleabbrev>POSIX Regex</titleabbrev>
<preface xml:id="intro.regex">
&reftitle.intro;
<warning>
&warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives;
<simplelist role="alternatives">
<member>
<link linkend="book.pcre">PCRE</link>
(for full regular expression support)
</member>
<member>
<function>fnmatch</function>
(for simpler shell style wildcard pattern matching)
</member>
</simplelist>
</warning>
<tip>
<para>
PHP also supports regular expressions using a Perl-compatible syntax
using the <link linkend="book.pcre">PCRE functions</link>. Those functions
support non-greedy matching, assertions, conditional subpatterns, and a
number of other features not supported by the POSIX-extended regular
expression syntax.
</para>
</tip>
<warning>
<para>
These regular expression functions are not binary-safe. The <link
linkend="book.pcre">PCRE functions</link> are.
</para>
</warning>
<para>
Regular expressions are used for complex string manipulation.
PHP uses the POSIX extended regular expressions as defined by POSIX
1003.2. For a full description of POSIX regular expressions see the <link xlink:href="&url.regex.man;">regex
man pages</link> included in the regex directory in the PHP distribution. It's
in manpage format, so you'll want to do something along the lines of
<command>man /usr/local/src/regex/regex.7</command> in order to read it.
</para>
</preface>
&reference.regex.setup;
&reference.regex.constants;
&reference.regex.examples;
&reference.regex.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->