Documentación offline PHP master

Ds\Map::map

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Ds\Map::map

Devuelve el resultado de la aplicación de una retrollamada a cada valor

Descripción#

public Ds\Map::map(callable $callback): Ds\Map
```php

Devuelve el resultado de la aplicación de un `callback` a cada valor del mapa.

## Parámetros

`callback`  
```php
callback(mixed $key, mixed $value): mixed

Un callable a aplicar a cada valor del mapa.

La retrollamada debe devolver aquello a lo que la clave será mappada en el mapa resultante.

Valores devueltos#

El resultado de la aplicación de un callback a cada valor del mapa.

[!NOTE] Las claves y los valores de la instancia actual no serán afectados.

Ejemplos#

Ejemplo de Ds\Map::map

<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);

print_r($map->map(function($key, $value) { return $value * 2; }));
print_r($map);
?>

Resultado del ejemplo anterior es similar a:

(
    [0] => Ds\Pair Object
        (
            [key] => a
            [value] => 2
        )

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

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

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

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

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

)