HH\Vector::fromItems

Creates a Vector from the given Traversable, or an empty Vector if null is passed.

Description

public static function fromItems(
  ?Traversable<Tv> $items,
): Vector<Tv>

Creates a Vector from the given Traversable, or an empty Vector if null is passed.

This is the static method version of the Vector::__construct() constructor.

Parameters

Return Values

Examples

<?hh

namespace Hack\UserDocumentation\API\Examples\Vector\FromItems;

// Create a new Vector from an array
$v = Vector::fromItems(array('red', 'green', 'blue', 'yellow'));
var_dump($v);

// Create a new Vector from a Set
$v = Vector::fromItems(Set {'red', 'green', 'blue', 'yellow'});
var_dump($v);

// Create a new Vector from the values of a Map
$v = Vector::fromItems(Map {
  'red' => 'red',
  'green' => 'green',
  'blue' => 'blue',
  'yellow' => 'yellow',
});
var_dump($v);

// An empty Vector is created if null is provided
$v = Vector::fromItems(null);
var_dump($v);
Output
object(HH\Vector)#1 (4) {
  [0]=>
  string(3) "red"
  [1]=>
  string(5) "green"
  [2]=>
  string(4) "blue"
  [3]=>
  string(6) "yellow"
}
object(HH\Vector)#3 (4) {
  [0]=>
  string(3) "red"
  [1]=>
  string(5) "green"
  [2]=>
  string(4) "blue"
  [3]=>
  string(6) "yellow"
}
object(HH\Vector)#5 (4) {
  [0]=>
  string(3) "red"
  [1]=>
  string(5) "green"
  [2]=>
  string(4) "blue"
  [3]=>
  string(6) "yellow"
}
object(HH\Vector)#6 (0) {
}