PHP - funções de mapa

O Mapa é uma coleção sequencial de pares de valores-chave, quase idêntico a uma matriz usada em um contexto semelhante. As chaves podem ser de qualquer tipo, mas devem ser exclusivas, e os valores são substituídos se adicionados ao mapa usando a mesma chave.

Forças

  • Chaves e valores podem ser de qualquer tipo, incluindo objetos.
  • Suporta sintaxe de array (colchetes).
  • A ordem de inserção é preservada.
  • O desempenho e a eficiência da memória são muito semelhantes aos de um array.
  • Libera automaticamente a memória alocada quando seu tamanho diminui o suficiente.

Fraquezas

  • Não pode ser convertido em uma matriz quando os objetos são usados ​​como chaves.

Sintaxe

Ds\Map implements Ds\Collection {
   /* Constants */   
   
   const int MIN_CAPACITY = 16 ;
   /* Methods */
   
   public void allocate( int $capacity )
   public void apply( callable $callback )
   public int capacity( void )
   public void clear( void )
   public Ds\Map copy( void )
   public Ds\Map diff( Ds\Map $map )
   public Ds\Map filter([ callable $callback ] )
   public Ds\Pair first( void )
   public mixed get( mixed $key [, mixed $default ] )
   public bool hasKey( mixed $key )
   public bool hasValue( mixed $value )
   public Ds\Map intersect( Ds\Map $map )
   public bool isEmpty( void )
   public Ds\Set keys( void )
   public void ksort([ callable $comparator ] )
   public Ds\Map ksorted([ callable $comparator ] )
   public Ds\Pair last( void )
   public Ds\Map map( callable $callback )
   public Ds\Map merge( mixed $values )
   public Ds\Sequence pairs( void )
   public void put( mixed $key , mixed $value )
   public void putAll( mixed $pairs )
   public mixed reduce( callable $callback [, mixed $initial ] )
   public mixed remove( mixed $key [, mixed $default ] )
   public void reverse( void )
   public Ds\Map reversed( void )
   public Ds\Pair skip( int $position )
   public Ds\Map slice int $index [, int $length ] )
   public void sort([ callable $comparator ] )
   public Ds\Map sorted([ callable $comparator ] )
   public number sum( void )
   public array toArray( void )
   public Ds\Map union( Ds\Map $map )
   public Ds\Sequence values( void )
   public Ds\Map xor( Ds\Map $map )
}

Constantes Predefinidas

Ds \ Map :: MIN_CAPACITY

Sr. Não Descrição da função
1

Função Ds \ Map :: allocate ()

Esta função pode alocar memória suficiente para a capacidade necessária.

2

Função Ds \ Map :: apply ()

Esta função pode atualizar, atualizar todos os valores, aplicando uma função de retorno de chamada a cada valor.

3

Função Ds \ Map :: capacity ()

Esta função pode retornar a capacidade atual.

4

Função Ds \ Map :: clear ()

Esta função pode remover remover todos os valores.

5

Função Ds \ Map :: copy ()

Esta função pode retornar a cópia superficial de um mapa.

6

Função Ds \ Map :: count ()

Esta função pode retornar o número de valores em um mapa.

7

Função Ds \ Map :: diff ()

Esta função pode criar um novo mapa usando teclas que não estão em outro mapa.

8

Função Ds \ Map :: filter ()

Esta função pode criar um novo mapa usando um chamável para determinar quais pares incluir.

9

Função Ds \ Map :: first ()

Esta função pode retornar o primeiro par em um mapa.

10

Função Ds \ Map :: get ()

Esta função pode retornar o valor de uma determinada chave.

11

Função Ds \ Map :: hasKey ()

Esta função pode determinar se o mapa contém uma determinada chave.

12

Função Ds \ Map :: hasValue ()

Esta função pode determinar se o mapa contém um determinado valor.

13

Função Ds \ Map :: intersect ()

Esta função pode criar um novo mapa cruzando as chaves com outro mapa.

14

Função Ds \ Map :: isEmpty ()

Esta função pode retornar o retorno se o mapa estiver vazio.

15

Função Ds \ Map :: jsonSerialize ()

Esta função pode retornar uma representação que pode ser convertida em JSON.

16

Função Ds \ Map :: keys ()

Esta função pode retornar o conjunto de chaves do mapa.

17

Função Ds \ Map :: ksort ()

Esta função pode classificar o mapa no local por chave.

18

Função Ds \ Map :: ksorted ()

Esta função pode retornar uma cópia, classificada por chave.

19

Função Ds \ Map :: last ()

Esta função pode retornar o último par de um mapa.

20

Função Ds \ Map :: map ()

Esta função pode retornar o resultado da aplicação de um retorno de chamada a cada valor.

21

Função Ds \ Map :: merge ()

Esta função pode retornar o resultado da adição de todas as associações fornecidas.

22

Função Ds \ Map :: pairs ()

Esta função pode retornar uma sequência contendo todos os pares do mapa.

23

Função Ds \ Map :: put ()

Esta função pode associar uma chave a um valor.

24

Função Ds \ Map :: putAll ()

Esta função pode associar todos os pares de valores-chave do objeto percorrível ou array

25

Função Ds \ Map :: reduce ()

Esta função pode reduzir o mapa a um único valor usando uma função de retorno de chamada.

26

Função Ds \ Map :: remove ()

Esta função pode remover e retornar um valor por chave.

27

Função Ds \ Map :: reverse ()

Esta função pode reverter o mapa no local.

28

Função Ds \ Map :: reversed ()

Esta função pode retornar uma cópia revertida.

29

Função Ds \ Map :: skip ()

Esta função pode retornar o par em um determinado índice posicional.

30

Função Ds \ Map :: slice ()

Esta função pode retornar um subconjunto do mapa definido pelo índice inicial e comprimento.

31

Função Ds \ Map :: sort ()

Esta função pode classificar o mapa no local por valor.

32

Função Ds \ Map :: Sort ()

Esta função pode retornar uma cópia classificada por valor.

33

Função Ds \ Map :: sum ()

Esta função pode retornar a soma de todos os valores em um mapa.

34

Função Ds \ Map :: toArray ()

Esta função pode converter um mapa em um array.

35

Função Ds \ Map :: union ()

Esta função pode criar um novo mapa usando valores da instância atual e outro mapa.

36

Função Ds \ Map :: values ​​()

Esta função pode retornar uma sequência de valores do mapa.

37

Função Ds \ Map :: xor ()

Esta função pode criar um novo mapa usando as teclas da instância atual ou de outro mapa, mas não de ambos.