PHP | DsMap remove() Function

The Ds\Map::remove() function is an inbuilt function in PHP which is used to remove and return a value by key.

Syntax:

mixed Ds\Map::remove( $key, $default )

Parameters: This function accepts two parameters as mentioned above and described below:

$key: It holds the key value which need to remove.
$default: It is optional parameter and it returns if key not found.

Return Value: This function returns the value that was removed.

Exception: This function throws OutOfRangeException if the key not exist and value of $default is not provided.

Below programs illustrate the Ds\Map::remove() function in PHP:

Example 1:

<?php  
  
// Declare new Map  
$map = new \Ds\Map([ 
    1 => "geeks", 
    2 => "for",  
    3 => "geeks", 
    4 => "DataStructures"
]);  
  
echo("Map Elements\n");  
  
// Display the map elements  
print_r($map);  
  
echo("\nRemoved element of the map: \n");  
  
// Use remove() function to remove  
// value at index 3 and return it  
var_dump($map->remove(3));  
  
?> 

Output:

Map Elements
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 1
            [value] => geeks
        )

    [1] => Ds\Pair Object
        (
            [key] => 2
            [value] => for
        )

    [2] => Ds\Pair Object
        (
            [key] => 3
            [value] => geeks
        )

    [3] => Ds\Pair Object
        (
            [key] => 4
            [value] => DataStructures
        )

)

Removed element of the map: 
string(5) "geeks"

Example:

<?php  
  
// Declare new Map  
$map = new \Ds\Map([ 
    "a" => "geeks", 
    "b" => "for",  
    "c" => "geeks", 
    "d" => "DataStructures"
]);  
  
echo("Map Elements\n");  
  
// Display the map elements  
print_r($map);  
  
echo("\nRemoved element of the map: \n");  
  
// Use remove() function to remove  
// value at index 3 and return it  
var_dump($map->remove("c"));  
  
?> 

Output:

Map Elements
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => a
            [value] => geeks
        )

    [1] => Ds\Pair Object
        (
            [key] => b
            [value] => for
        )

    [2] => Ds\Pair Object
        (
            [key] => c
            [value] => geeks
        )

    [3] => Ds\Pair Object
        (
            [key] => d
            [value] => DataStructures
        )

)

Removed element of the map: 
string(5) "geeks"

Reference: https://www.php.net/manual/en/ds-map.remove.php

My Personal Notes

PHP | Ds\Map remove() Function

Recommended Posts: