자료구조 Ds\Map::remove
(PECL ds >= 1.0.0)
Ds\Map::remove — 키로 값을 제거하고 반환합니다.
설명
public Ds\Map::remove(mixed $key, mixed $default = ?): mixed
키별로 값을 제거하고 반환하거나 키를 찾을 수 없는 경우 선택적 기본값을 반환합니다.
메모: 객체 유형의 키가 지원됩니다. 개체가 Ds\Hashable을 구현하는 경우 개체의 equals 함수에 의해 동등성이 결정됩니다. 개체가 Ds\Hashable을 구현하지 않는 경우 개체는 동일한 것으로 간주되기 위해 동일한 인스턴스에 대한 참조여야 합니다.
메모: 배열 구문을 사용하여 키별로 값에 액세스할 수도 있습니다. $map["key"].
주의 배열 구문을 사용할 때 주의하십시오. 스칼라 키는 엔진에 의해 정수로 강제 변환됩니다. 예를 들어 $map["1"]은 int(1)에 액세스하려고 시도하는 반면 $map->get("1")은 문자열 키를 올바르게 조회합니다.
배열을 참조하십시오.
매개변수
key- 제거할 키입니다.
default- 키를 찾을 수 없는 경우 반환되는 선택적 기본값입니다.
반환 값
제거된 값 또는 제공된 경우 default이며 맵에서 key를 찾을 수 없습니다.
오류/예외
키를 찾을 수 없고 기본값이 제공되지 않은 경우 OutOfBoundsException이 발생합니다.
Examples
예제 #1 Ds\Map::remove() 예제
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->remove("a")); // 1
var_dump($map->remove("e", 10)); // 10 (default used)
?>
위의 예는 다음과 유사한 결과를 출력합니다.
int(1)
int(10)