PHP - Funções de Sequência

Introdução à interface Sequence

Uma Sequência pode descrever o comportamento de valores organizados em uma única dimensão linear. Alguns idiomas podem se referir a isso como uma lista. É semelhante a uma matriz que usa chaves inteiras incrementais, com exceção de algumas características.

• Os valores sempre podem ser indexados como [0, 1, 2,…, tamanho - 1].
• Só é permitido acessar valores por índice no intervalo [0, tamanho - 1].

Casos de uso

• Onde quer que possamos usar um array como uma lista (não preocupado com chaves).
• Uma alternativa mais eficiente para SplDoublyLinkedList e SplFixedArray.

Sinopse da interface

Ds\Sequence implements Ds\Collection {
   /* Methods */
   abstract public void allocate( int $capacity )
   abstract public void apply( callable $callback )
   abstract public int capacity( void ) 
   abstract public bool contains([ mixed $...values ] )
   abstract public Ds\Sequence filter([ callable $callback ] )
   abstract public mixed find( mixed $value )
   abstract public mixed first( void )
   abstract public mixed get( int $index )
   abstract public void insert( int $index [, mixed $...values ] )
   abstract public string join([ string $glue ] )
   abstract public mixed last( void )
   abstract public Ds\Sequence map( callable $callback )
   abstract public Ds\Sequence merge( mixed $values )
   abstract public mixed pop( void )
   abstract public void push([ mixed $...values ] )
   abstract public mixed reduce( callable $callback [, mixed $initial ] )
   abstract public mixed remove( int $index )
   abstract public void reverse( void )
   abstract public Ds\Sequence reversed( void )
   abstract public void rotate( int $rotations )
   abstract public void set( int $index , mixed $value )
   abstract public mixed shift( void )
   abstract public Ds\Sequence slice( int $index [, int $length ] )
   abstract public void sort([ callable $comparator ] )
   abstract public Ds\Sequence sorted([ callable $comparator ] )
   abstract public number sum( void )
   abstract public void unshift([ mixed $values ] )
}

Constantes Predefinidas

Ds \ Map :: MIN_CAPACITY