Ds\Map::toArray

    (PECL ds >= 1.0.0)

    Ds\Map::toArray — Converts the map to an array

    Description

    public Ds\Map::toArray(): array

    Converts the map to an array.

    Caution

    Maps where non-scalar keys are can't be converted to an array.

    Caution

    An array will treat all numeric keys as integers, eg. "1" and 1 as keys in the map will only result in 1 being included in the array.

    Note:

    Casting to an array is not supported yet.

    Parameters

    This function has no parameters.

    Return Values

    An array containing all the values in the same order as the map.

    Examples

    Example #1 Ds\Map::toArray() example

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

    var_dump($map->toArray());
    ?>

    The above example will output something similar to:

    array(3) {
  ["a"]=>
  int(1)
  ["b"]=>
  int(2)
  ["c"]=>
  int(3)
}

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    -1
    foalford at gmail dot com
    4 years ago
    When using Hashable object as $key, Map::put() will not call the Hashable::hash() on the key until later. For example

    <?
    class Key implements \Ds\Hashable
    {
    protected $id;

    public function __construct($id)
    {
    $this->id = $id;
    }

    public function equals($obj) : bool
    {
    return $this->id == $obj->id;
    }

    public function hash()
    {
    return $this->id;
    }
    }
    $map = new \Ds\Map();
    $myki = new Key('myki');

    $map->put($myki, "Value String");

    var_dump($map->get($myki));
    echo 'Map::put() store the Hashable object and it cause error in toArray()'. PHP_EOL;
    var_dump($map->toArray());
    ?>
    ＋add a note
    To Top