PHP - Fonctions de séquence

Introduction à l'interface de séquence

Une séquence peut décrire le comportement de valeurs disposées dans une seule dimension linéaire. Certaines langues peuvent y faire référence sous le nom de liste. Il est similaire à un tableau qui utilise des clés entières incrémentielles, à l'exception de quelques caractéristiques.

  • Les valeurs peuvent toujours être indexées comme [0, 1, 2,…, taille - 1].
  • Autorisé uniquement à accéder aux valeurs par index dans la plage [0, taille - 1].

Cas d'utilisation

  • Partout où nous pouvons utiliser un tableau comme liste (non concerné par les clés).
  • Une alternative plus efficace à SplDoublyLinkedList et SplFixedArray.

Synopsis de l'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 prédéfinies

Ds \ Map :: MIN_CAPACITY

Sr. Non Description de la fonction
1

Ds \ Sequence :: allocate ()

Cette fonction peut allouer suffisamment de mémoire pour une capacité requise.
2

Ds \ Sequence :: apply ()

Cette fonction peut mettre à jour toutes les valeurs en appliquant une fonction de rappel à chaque valeur.
3

Ds \ Séquence :: capacité ()

Cette fonction peut renvoyer la capacité actuelle.
4

Ds \ Sequence :: contient ()

Cette fonction peut déterminer si une séquence contient des valeurs données.
5

Ds \ Sequence :: filter ()

créer une nouvelle séquence en utilisant callable pour déterminer les valeurs à inclure.
6

Ds \ Sequence :: find ()

Cette fonction peut tenter de trouver l'index de la valeur.
sept

Ds \ Sequence :: first ()

Cette fonction peut renvoyer la première valeur d'une séquence.
8

Ds \ Sequence :: get ()

Cette fonction peut renvoyer la valeur à un index donné.
9

Ds \ Sequence :: insert ()

Cette fonction peut insérer des valeurs à un index donné.
dix

Ds \ Sequence :: join ()

Cette fonction peut joindre toutes les valeurs sous forme de chaîne.
11

Ds \ Sequence :: last ()

Cette fonction peut renvoyer la dernière valeur.
12

Ds \ Sequence :: map ()

Cette fonction peut renvoyer le résultat de l'application d'un rappel à chaque valeur.
13

Ds \ Sequence :: merge ()

Cette fonction peut renvoyer le résultat de l'ajout de toutes les valeurs données à la séquence.
14

Ds \ Séquence :: pop ()

Cette fonction peut supprimer et renvoyer la dernière valeur.
15

Ds \ Sequence :: push ()

Cette fonction peut ajouter des valeurs à la fin d'une séquence.
16

Ds \ Sequence :: réduire ()

Cette fonction peut réduire la séquence à une valeur unique à l'aide d'une fonction de rappel.
17

Ds \ Sequence :: remove ()

Cette fonction peut supprimer et renvoyer une valeur par index.
18

Ds \ Sequence :: reverse ()

Cette fonction peut inverser une séquence sur place.
19

Ds \ Sequence :: inversé ()

Cette fonction peut renvoyer une copie inversée.
20

Ds \ Sequence :: rotate ()

Cette fonction peut faire pivoter la séquence d'un nombre donné de rotations.

21

Ds \ Sequence :: set ()

Cette fonction peut mettre à jour une valeur à l'index donné.
22

Ds \ Sequence :: shift ()

Cette fonction peut supprimer et renvoyer une première valeur.
23

Ds \ Sequence :: slice ()

Cette fonction peut renvoyer une sous-séquence de la plage donnée.
24

Ds \ Sequence :: sort ()

Cette fonction peut trier une séquence sur place.
25

Ds \ Sequence :: trié ()

Cette fonction peut renvoyer une copie triée.
26

Ds \ Sequence :: sum ()

Cette fonction peut renvoyer la somme de toutes les valeurs dans une séquence.
27

Ds \ Sequence :: unshift ()

Cette fonction ajoute des valeurs au début d'une séquence.