자료구조 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)