philip Thu Feb 20 11:40:20 2003 EDT
Modified files:
/phpdoc/en/reference/strings/functions strpos.xml
Log:
Expand example, remove old example, use &return.falseproblem; and see also stripos()
Index: phpdoc/en/reference/strings/functions/strpos.xml
diff -u phpdoc/en/reference/strings/functions/strpos.xml:1.2
phpdoc/en/reference/strings/functions/strpos.xml:1.3
--- phpdoc/en/reference/strings/functions/strpos.xml:1.2 Wed Apr 17 02:44:23
2002
+++ phpdoc/en/reference/strings/functions/strpos.xml Thu Feb 20 11:40:20 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.8 -->
<refentry id="function.strpos">
<refnamediv>
@@ -25,31 +25,35 @@
entire string will be used.
</para>
<para>
- If <parameter>needle</parameter> is not found, returns &false;.
- <note>
- <para>
- It is easy to mistake the return values for "character found at
- position 0" and "character not found". Here's how to detect
- the difference:
- <informalexample>
- <programlisting role="php">
+ If <parameter>needle</parameter> is not found,
+ <function>strpos</function> will return <type>boolean</type> &false;.
+ </para>
+
+ &return.falseproblem;
+
+ <para>
+ <example>
+ <title><function>strpos</function> examples</title>
+ <programlisting role="php">
<![CDATA[
-// in PHP 4.0b3 and newer:
-$pos = strpos($mystring, "b");
-if ($pos === false) { // note: three equal signs
- // not found...
-}
+<?php
+$mystring = 'abc';
+$findme = 'a';
+$pos = strpos($mystring, $findme);
-// in versions older than 4.0b3:
-$pos = strpos($mystring, "b");
-if (!is_integer($pos)) {
- // not found...
+// Note our use of ===. Simply == would not work as expected
+// because the position of 'a' was the 0th (first) character.
+if ($pos === false) {
+ echo "The string '$findme' was not found in the string '$mystring'";
+} else {
+ echo "The string '$findme' was found in the string '$mystring'";
+ echo " and exists at position $pos";
}
+
+?>
]]>
- </programlisting>
- </informalexample>
- </para>
- </note>
+ </programlisting>
+ </example>
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
@@ -62,7 +66,7 @@
the beginning of <parameter>haystack</parameter>.
</para>
<para>
- See also <function>strrpos</function>,
+ See also <function>strrpos</function>, <function>stripos</function>,
<function>strrchr</function>, <function>substr</function>,
<function>stristr</function>, and <function>strstr</function>.
</para>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
