From 768a81cfaaab68ce38b417c89e739bf1de2ae52a Mon Sep 17 00:00:00 2001
From: "Herman J. Radtke III" <hradtke@php.net>
Date: Tue, 9 Sep 2008 05:00:50 +0000
Subject: [PATCH] There was a lot of confusion in the user notes about the !==
 operator.  An example was added using the !== operator in hopes of clearing
 some of it up.

Each example now has its own example box and title as well.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@266014 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/strpos.xml | 36 ++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/reference/strings/functions/strpos.xml b/reference/strings/functions/strpos.xml
index 2510d00fb0..c995f2073b 100644
--- a/reference/strings/functions/strpos.xml
+++ b/reference/strings/functions/strpos.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.15 $ -->
+<!-- $Revision: 1.16 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpos">
  <refnamediv>
   <refname>strpos</refname>
@@ -73,7 +73,7 @@
   &reftitle.examples;
   <para>
    <example>
-    <title><function>strpos</function> examples</title>
+    <title>Using boolean true</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -89,7 +89,39 @@ if ($pos === false) {
     echo "The string '$findme' was found in the string '$mystring'";
     echo " and exists at position $pos";
 }
+?>
+]]>
+    </programlisting>
+   </example>
 
+   <example>
+    <title>Using boolean false</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$mystring = 'abc';
+$findme   = 'a';
+$pos = strpos($mystring, $findme);
+
+// The !== operator can also be used.  Using != would not work as expected
+// because the position of 'a' is 0. The statement (0 != false) evaluates 
+// to false.
+if ($pos !== false) {
+     echo "The string '$findme' was found in the string '$mystring'";
+         echo " and exists at position $pos";
+} else {
+     echo "The string '$findme' was not found in the string '$mystring'";
+}
+?>
+]]>
+    </programlisting>
+   </example>
+
+   <example>
+    <title>Using an offset</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
 // We can search for the character, ignoring anything before the offset
 $newstring = 'abcdef abcdef';
 $pos = strpos($newstring, 'a', 1); // $pos = 7, not 0