{"type":"rich","version":"1.0","provider_name":"phorkie","provider_url":"https:\/\/p.cweiske.de\/","title":"phpdoc strpos reStructuredText","author_name":"Christian Weiske","cache_age":86400,"width":900,"height":900,"html":"\n\n
\n
\n
\n \n
\n\n\n
\n

Synopsis<\/h1>\n

Find the position of the first occurrence of a substring in a string<\/p>\n<\/div>\n

\n

Description<\/h1>\n
\n

System Message: ERROR\/3 (<stdin><\/tt>, line 8)<\/p>\n

Unknown directive type "signature".<\/p>\n

\n.. signature::\n    int function strpos(\n        string $haystack,\n        mixed $needle,\n        int $offset = 0\n    )\n\n<\/pre>\n<\/div>\n
Find the numeric position of the first occurrence of $needle<\/tt> in the\n$haystack<\/tt> string.<\/p>\n<\/div>\n
\n
Parameters<\/h1>\n
\n
$haystack<\/tt><\/dt>\n
The string to search in.<\/dd>\n
$needle<\/tt><\/dt>\n
If $needle<\/tt> is not a string, it is converted to an integer and applied as the ordinal value of a character.<\/dd>\n
$offset<\/tt><\/dt>\n
If specified, search will start this number of characters counted from the beginning of the string. Unlike FUNCTION:strrpos<\/a> and FUNCTION:strripos<\/a>, the offset cannot be negative.<\/dd>\n<\/dl>\n<\/div>\n
\n
Return values<\/h1>\n
Returns the position of where the needle exists relative to the beginning of the $haystack<\/tt> string (independent of offset). Also note that string positions start at 0, and not 1.\nReturns FALSE<\/a> if the needle was not found.<\/p>\n
\n
Warning<\/p>\n
This function may return Boolean FALSE<\/a>, but may also return a non-Boolean value which evaluates to FALSE<\/a>. Please read the section on Booleans<\/a> for more information. Use the === operator<\/a> for testing the return value of this function.<\/p>\n<\/div>\n<\/div>\n
\n
EXAMPLES<\/h1>\n
\n
Using _===_<\/h2>\n
\n
System Message: ERROR\/3 (<stdin><\/tt>, line 47)<\/p>\n
Unknown directive type "code".<\/p>\n
\n.. code:: php\n\n    <?php\n    $mystring = 'abc';\n    $findme   = 'a';\n    $pos = strpos($mystring, $findme);\n\n    \/\/ Note our use of ===.  Simply == would not work as expected\n    \/\/ because the position of 'a' was the 0th (first) character.\n    if ($pos === false) {\n        echo "The string '$findme' was not found in the string '$mystring'";\n    } else {\n        echo "The string '$findme' was found in the string '$mystring'";\n        echo " and exists at position $pos";\n    }\n    ?>\n\n\n<\/pre>\n<\/div>\n<\/div>\n
\n
Using !==<\/h2>\n
\n
System Message: ERROR\/3 (<stdin><\/tt>, line 67)<\/p>\n
Unknown directive type "code".<\/p>\n
\n.. code:: php\n\n    <?php\n    $mystring = 'abc';\n    $findme   = 'a';\n    $pos = strpos($mystring, $findme);\n\n    \/\/ The !== operator can also be used.  Using != would not work as expected\n    \/\/ because the position of 'a' is 0. The statement (0 != false) evaluates\n    \/\/ to false.\n    if ($pos !== false) {\n        echo "The string '$findme' was found in the string '$mystring'";\n        echo " and exists at position $pos";\n    } else {\n        echo "The string '$findme' was not found in the string '$mystring'";\n    }\n    ?>\n\n<\/pre>\n<\/div>\n<\/div>\n
\n
Using an offset<\/h2>\n
\n
System Message: ERROR\/3 (<stdin><\/tt>, line 87)<\/p>\n
Unknown directive type "code".<\/p>\n
\n.. code:: php\n\n    <?php\n    \/\/ We can search for the character, ignoring anything before the offset\n    $newstring = 'abcdef abcdef';\n    $pos = strpos($newstring, 'a', 1); \/\/ $pos = 7, not 0\n    ?>\n\n\n\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
Notes<\/h1>\n
\n
Note<\/p>\n
This function is binary-safe.<\/p>\n<\/div>\n<\/div>\n
\n
See also<\/h1>\n