pht\Vector::insertAt

(PECL pht >= 0.0.1)

pht\Vector::insertAtInserts a value into the vector

Description

public pht\Vector::insertAt ( mixed $value , int $offset ) : void

This method inserts a value at the specified offset into the vector (in linear time). The vector will automatically be resized if it is not large enough.

Liste de paramètres

value

The value to be inserted into the vector. This value will be serialised (since it may be passed around between threads).

offset

The offset at which the value will be inserted at. This offset must be within the 0..N range (inclusive), where N is the size of the vector. Inserting at position N is the equivalent of using pht\Vector::push(), and inserting at position 0 is the equivalent of using pht\Vector::unshift(). Attempting to insert at offsets outside of this range will result in an Error exception.

Valeurs de retour

No return value.

Exemples

Exemple #1 Inserting a value into a vector

<?php

use pht\Vector;

$vector = new Vector();

$vector->insertAt(30); // insert 3 at start
$vector->insertAt(10); // insert 1 at start (before 3)
$vector->insertAt(21); // insert 2 in middle (after 1 and before 3)

var_dump($vector);

L'exemple ci-dessus va afficher :

object(pht\Vector)#1 (3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}