DocumentationHackReferenceClassHH\VectorfromItems

HH\Vector::fromItems

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

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

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

Parameters

?Traversable<Tv> $iterable

Returns

Vector<Tv> - A Vector with the values from the Traversable; or an empty Vector if the Traversable is null.

Examples

// 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) {
}