Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

array_search(3) [php man page]

ARRAY_SEARCH(3) 							 1							   ARRAY_SEARCH(3)

array_search - Searches the array for a given value and returns the corresponding key if successful

SYNOPSIS
mixed array_search (mixed $needle, array $haystack, [bool $strict = false]) DESCRIPTION
Searches $haystack for $needle. PARAMETERS
o $needle - The searched value. Note If $needle is a string, the comparison is done in a case-sensitive manner. o $haystack - The array. o $strict - If the third parameter $strict is set to TRUE then the array_search(3) function will search for identical elements in the $haystack. This means it will also check the types of the $needle in the $haystack, and objects must be the same instance. RETURN VALUES
Returns the key for $needle if it is found in the array, FALSE otherwise. If $needle is found in $haystack more than once, the first matching key is returned. To return the keys for all matching values, use array_keys(3) with the optional $search_value parameter instead. Warning This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on Booleans for more information. Use the === operator for testing the return value of this function. CHANGELOG
+--------+---------------------------------------------------+ |Version | | | | | | | Description | | | | +--------+---------------------------------------------------+ | 5.3.0 | | | | | | | As with all internal PHP functions as of 5.3.0, | | | array_search(3) returns NULL if invalid parame- | | | ters are passed to it. | | | | | 4.2.0 | | | | | | | Prior to PHP 4.2.0, array_search(3) returns NULL | | | on failure instead of FALSE. | | | | +--------+---------------------------------------------------+ EXAMPLES
Example #1 array_search(3) example <?php $array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red'); $key = array_search('green', $array); // $key = 2; $key = array_search('red', $array); // $key = 1; ?> SEE ALSO
array_keys(3), array_values(3), array_key_exists(3), in_array(3). PHP Documentation Group ARRAY_SEARCH(3)

Check Out this Related Man Page

STRRIPOS(3)								 1							       STRRIPOS(3)

strripos - Find the position of the last occurrence of a case-insensitive substring in a string

SYNOPSIS
int strripos (string $haystack, string $needle, [int $offset]) DESCRIPTION
Find the numeric position of the last occurrence of $needle in the $haystack string. Unlike the strrpos(3), strripos(3) is case-insensitive. PARAMETERS
o $haystack - The string to search in. o $needle - If $needle is not a string, it is converted to an integer and applied as the ordinal value of a character. o $offset - If specified, search will start this number of characters counted from the beginning of the string. If the value is negative, search will instead start from that many characters from the end of the string, searching backwards. RETURN VALUES
Returns the position where the needle exists relative to the beginnning of the $haystack string (independent of search direction or off- set). Also note that string positions start at 0, and not 1. Returns FALSE if the needle was not found. Warning This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on Booleans for more information. Use the === operator for testing the return value of this function. EXAMPLES
Example #1 A simple strripos(3) example <?php $haystack = 'ababcd'; $needle = 'aB'; $pos = strripos($haystack, $needle); if ($pos === false) { echo "Sorry, we did not find ($needle) in ($haystack)"; } else { echo "Congratulations! "; echo "We found the last ($needle) in ($haystack) at position ($pos)"; } ?> The above example will output: Congratulations! We found the last (aB) in (ababcd) at position (2) SEE ALSO
strpos(3), stripos(3), strrpos(3), strrchr(3), stristr(3), substr(3). PHP Documentation Group STRRIPOS(3)
Man Page