php-doc-en/reference/regex/functions/sql-regcase.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

104 lines
2.6 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sql-regcase">
<refnamediv>
<refname>sql_regcase</refname>
<refpurpose>Make regular expression for case insensitive match</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&warn.deprecated.function.5-3-0.removed.7-0-0.alternatives;
<simplelist role="alternatives">
<member><function>preg_match</function></member>
<member><function>preg_quote</function></member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sql_regcase</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Creates a regular expression for a case insensitive match.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
The input string.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a valid regular expression which will match
<parameter>string</parameter>, ignoring case. This expression is
<parameter>string</parameter> with each alphabetic character converted to
a bracket expression; this bracket expression contains that character's
uppercase and lowercase form. Other characters remain unchanged.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>sql_regcase</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
echo sql_regcase("Foo - bar.");
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
[Ff][Oo][Oo] - [Bb][Aa][Rr].
]]>
</screen>
</example>
</para>
<para>
This can be used to achieve case insensitive pattern matching in
products which support only case sensitive regular expressions.
</para>
</refsect1>
</refentry>
<!-- 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
-->