PHP array_search() 함수

PHP 배열 함수

예제

배열에서 키 값을 "red"로 검색하고 그 키 이름을 반환합니다:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>

실행 예제

정의와 사용법

array_search() 함수는 배열에서 특정 키 값을 검색하여 해당 키 이름을 반환합니다.

상세 설명

array_search() 함수와 in_array() 동일하게, 배열에서 키 값을 찾습니다. 해당 값이 발견되면, 일치하는 요소의 키 이름이 반환됩니다. 찾지 못하면 false를 반환합니다.

PHP 4.2.0 이전에는, 함수가 실패할 때 false 대신 null을 반환합니다.

세 번째 매개변수가 strict true로 설정되면, 데이터 타입과 값 모두 일치하는 요소만 해당 요소의 키 이름을 반환합니다.

문법

array_search(value,array,strict)
매개변수 설명
value 필수. 검색할 키 값을 지정합니다.
array 필수. 검색할 배열을 지정합니다.
strict

선택 사항. 이 매개변수가 TRUE로 설정되면, 함수가 배열에서 데이터 타입과 값 모두 일치하는 요소를 검색합니다. 가능한 값:

  • true
  • false - 기본

true로 설정되면, 배열에서 주어진 값을 타입과 값 모두 일치하는 요소를 검색합니다(예제 2을 참조하세요).

기술 세부 사항

반환 값:

배열에서 지정된 키 값을 발견하면 해당 키 이름을 반환하며, 발견되지 않으면 FALSE를 반환합니다.

배열에서 키 값이 한 번 이상 발견되면, 첫 번째로 발견된 키 값에 해당하는 키 이름을 반환합니다.
PHP 버전: 4.0.5+
업데이트 기록:

불법적인 매개변수를 함수에 전달하면 함수가 NULL을 반환합니다(이는 PHP 5.3.0부터 모든 PHP 함수에 적용됩니다).

PHP 4.2.0부터, 검색 실패 시 FALSE 대신 NULL을 반환합니다.

更多实例

예제 1

배열에서 키 값 5를 검색하고 키 이름을 반환합니다(주의 ""):

<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>

실행 예제

PHP 배열 함수