Funções para Array

Veja Também

array_change_key_case — Modifica todas as chaves em um array

array_chunk — Divide um array em pedaços

array_combine — Cria um array usando um array para chaves e outro para valores

array_count_values — Conta as frequências de cada valor de um array

array_diff_assoc — Computes the difference of arrays with additional index check

array_diff_key — Computes the difference of arrays using keys for comparison

array_diff_uassoc — Computes the difference of arrays with additional index check

which is performed by a user supplied callback function

array_diff_ukey — Computa a diferença de arrays usando uma função callback na

comparação de chaves

array_diff — Analisa as diferenças entre arrays

array_fill_keys — Preenche um array com valores, especificando chaves

array_fill — Preenche um array com valores

array_filter — Filtra os elementos da array usando uma função de callback

array_flip — Inverte as relações entre chaves e valores

array_intersect_assoc — Computa a interseção de arrays com uma adicional

verificação de índice

array_intersect_key — Computa a interseção de array comparando pelas chaves

array_intersect_uassoc — Computes the intersection of arrays with additional index

check, compares indexes by a callback function

array_intersect_ukey — Computes the intersection of arrays using a callback

function on the keys for comparison

array_intersect — Calcula a interseção entre arrays

array_key_exists — Checa se uma chave ou índice existe em um array

array_keys — Retorna todas as chaves de um array

array_map — Aplica uma função em todos os elementos dos arrays dados

array_merge_recursive — Funde dois ou mais arrays recursivamente

array_merge — Funde um ou mais arrays

array_multisort — Ordena múltiplos arrays ou arrays multi-dimensionais

array_pad — Expande um array para um certo comprimento utilizando um

determinado valor

array_pop — Retira um elemento do final do array

array_product — Calcula o produto dos valores de um array

array_push — Adiciona um ou mais elementos no final de um array

array_rand — Retorna um ou mais elementos aleatórios de um array

array_reduce — Reduz um array para um único valor através de um processo

iterativo utilizando uma função.

array_reverse — Retorna um array com os elementos na ordem inversa

array_search — Procura por um valor em um array e retorna sua chave

correspondente caso seja encontrado

array_shift — Retira o primeiro elemento de um array

array_slice — Extrai uma parcela de um array

array_splice — Remove uma parcela do array e substitui com outros elementos

array_sum — Calcula a soma dos elementos de um array

array_udiff_assoc — Computes the difference of arrays with additional index check,

compares data by a callback function

array_udiff_uassoc — Computes the difference of arrays with additional index

check, compares data and indexes by a callback function

array_udiff — Computes the difference of arrays by using a callback function for

data comparison

array_uintersect_assoc — Computa a interseção de arrays com checagem adicional

de índice, compara os dados utilizando uma função de callback
array_uintersect_uassoc — Computa a interseção de arrays com checagem adicional
de índice, compara os dados e os índices utilizando funções de callback

array_uintersect — Computa a interseção de array, comparando dados com uma

função callback

array_unique — Remove o valores duplicados de um array

array_unshift — Adiciona um ou mais elementos no início de um array

array_values — Retorna todos os valores de um array

array_walk_recursive — Aplica um função do usuário recursivamente para cada

membro de um array

array_walk — Aplica uma determinada funcão em cada elemento de um array

array — Cria um array

arsort — Ordena um array em ordem descrescente mantendo a associação entre

índices e valores

asort — Ordena um array mantendo a associação entre índices e valores

compact — Cria um array contendo variáveis e seus valores

count — Conta o número de elementos de uma variável, ou propriedades de um

objeto

current — Retorna o elemento corrente em um array

each — Retorna o par chave/valor corrente de um array e avança o seu cursor

end — Faz o ponteiro interno de um array apontar para o seu último elemento

extract — Importa variáveis para a tabela de símbolos a partir de um array

in_array — Checa se um valor existe em um array

key — Retorna uma chave de um array

krsort — Ordena um array pelas chaves em ordem descrescente

ksort — Ordena um array pelas chaves

list — Cria variáveis como se fossem arrays

natcasesort — Ordena um array utilizando o algoritmo da "ordem natural" sem

diferenciar maiúsculas e minúsculas
 natsort — Ordena um array utilizando o algoritmo da "ordem natural"

next — Avança o ponteiro interno de um array

pos — Sinônimo de current

prev — Retrocede o ponteiro interno de um array

range — Cria um array contendo uma faixa de elementos

reset — Faz o ponteiro interno de um array apontar para o seu primeiro elemento

rsort — Ordena um array em ordem descrescente

shuffle — Mistura os elementos de um array

sizeof — Sinônimo de count

sort — Ordena um array

uasort — Ordena um array utilizando uma função de comparação definida pelo

usuário e mantendo as associações entre chaves e valores

uksort — Ordena um array pelas chaves utilizando uma função de comparação

definida pelo usuário.

usort — Ordena um array pelos valores utilizando uma função de comparação

definida pelo usuário

is_array
(PHP 4, PHP 5)

is_array — Verifica se a variável é um array

Descrição
bool is_array ( mixed $var )

Verifica se uma dada variável é um array.

Parâmetros
var

A variável a ser avaliada.

Valor Retornado

Retorna TRUE se var é um array, FALSE caso contrário.

Exemplos

Exemplo #1 Verificando se a variável é um array

<?php
$yes = array('this', 'is', 'an array');

echo is_array($yes) ? 'Array' : 'not an Array';

echo "\n";

$no = 'this is a string';

echo is_array($no) ? 'Array' : 'not an Array';

?>

explode
(PHP 4, PHP 5)

explode — Divide uma string em strings

Valor Retornado
array explode ( string $delimiter , string $string [, int $limit ] )

Retorna uma matriz de strings, cada uma como substring de string formada pela
divisão dela a partir do delimiter .

Parâmetros
delimiter

O delimitador.

string

A string de entrada.

limit
 Se limit é definido, o array retornado irá conter o máximo de elementos igual a
limit com o último elemento contendo o resto da string .

Se o parâmetro limit é negativo, todos componentes exceto o último -limit

são retornados.

Ainda que implode() pode por razões históricas aceitar seus parâmetros em uma das
duas ordens, explode() não pode. Você deve assegurar que o argumento delimiter
vem antes do argumento string .

Valor Retornado

Se delimiter é uma string vazia (""), explode() irá retornar FALSE. Se delimiter
contém um valor que não contém em string , então explode() irá retornar um array
contendo string .

Histórico
Versão Descrição
5.1.0 Suporte a limit negativo foi adicionado
4.0.1 O parâmetro limit foi adicionado

Exemplos

Exemplo #1 explode() exemplos

<?php
// Example 1
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1
echo $pieces[1]; // piece2

// Example 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $
data);
echo $user; // foo
echo $pass; // *

?>

Exemplo #2 Exemplos de parâmetro limit

<?php
$str = 'one|two|three|four';

// positive limit
print_r(explode('|', $str, 2));

// negative limit (since PHP 5.1)

print_r(explode('|', $str, -1));
?>
O exemplo acima irá imprimir:

Array
(
[0] => one
[1] => two|three|four
)
Array
(
[0] => one
[1] => two
[2] => three
)

split

(PHP 4, PHP 5)

split — Separa strings em array utilizando expressões regulares

Descrição
array split ( string $expressao , string $variavel [, int $limite ] )

Separa uma string em array por expressão regular.

Parâmetros
pattern

A expressão regular case sensitive.

Se separar caracteres que são consideredos especiais para as expressões

regulares, será necessário usar o caracter de escape primeiramente. Se você
pensar que split() (ou outra função para execução de expressões regulares) é
muito estranha, por favor leia o arquivo regex.7, incluido na pasta regex/ no
subdiretório da distribuição do PHP. Está no formato manpage e você deverá
usar o comando man /usr/local/src/regex/regex.7 para maiores informações.

string

A string de entrada.

limit

Se limit é definido, o array retornado conterá no máximo de limit elementos,

sendo que o último elemento conterá o resto da string .

Valor Retornado

Retorna uma matriz de strings, contendo as substrings de string separadas pelos

limites descritos na expressão regular pattern .
Se existirem n ocorrências da pattern , será retornado uma matriz (array) contendo
n+1 items. Por exemplo, se não existir uma ocorrência de pattern , uma matriz com
um único elemento será retornado. Certamente, isto também é válido se string estiver
vazia. Se um erro ocorrer, split() retorna FALSE.

Exemplos

Exemplo #1 Exemplo da split()

Separa os quatro primeiro elementos de uma linha do arquivo /etc/passwd:

<?php
list($user,$pass,$uid,$gid,$extra) =
split (":", $passwd_line, 5);
?>

Exemplo #2 Exemplo da split()

Separação de dados delimitados por barras, pontos, ou traços:

<?php
// Delimitado por barras, pontos ou traços
$data = "04/30/1973";
list ($mes, $dia, $ano) = split ('[/.-]', $data);
echo "Mês: $mes; Dia: $dia; Ano: $ano<br />\n";
?>

Notas
Dica

preg_split(), que usa sintaxe de expressão regular compatível com Perl, é normalmente
a rápida alternativa para split(). Se você não precisa do poder das expressões regulares,
é mais eficiente usar explode(), que não faz overhead como engine de expressão regular.
implode
(PHP 4, PHP 5)

implode — Junta elementos de uma matriz em uma string

Descrição
string implode ( string $glue , array $pieces )

Retorna uma string contendo os elementos da matriz na mesma ordem com uma ligação
entre cada elemento.

Exemplo #1 implode() exemplo

<?php

$array = array('lastname', 'email', 'phone');

$comma_separated = implode(",", $array);

print $comma_separated; // lastname,email,phone

?>

preg_split
(PHP 4, PHP 5)

preg_split — Divide a string por uma expressão regular

Descrição
array preg_split ( string $pattern , string $subject [, int $limit [, int $flags ]] )

Divide uma dada string por uma expressão regular.

Parâmetros
pattern

O padrão a ser usado.

subject

A string de entrada.

limit
 Se especificado, então somente limit pedaços da string serão retornados, e se
limit for -1, significa "sem limite", que é útil quando especificando flags .

flags

flags pode ser uma combinação das seguintes flags (combinada com o operador
| bit-a-bit):

PREG_SPLIT_NO_EMPTY
Se esta flag é usada, somente pedaços não vazios serão retornados pela
preg_split().
PREG_SPLIT_DELIM_CAPTURE
Se esta flag é usada, expressão entre parênteses no padrão serão capturados e
retornados também.
PREG_SPLIT_OFFSET_CAPTURE

Se esta flag é usada, para cada combinação o offset da string será também
retornado. Note que isto modifica o valor de retorno em um array onde cada
elemento é um array contendo a string combinada no índice 0 e o offset da
mesma em subject no índice 1.

Valor Retornado

Retorna um array contendo pedaços de strings de subject divididos pelo que for
combinado pelo pattern .

Histórico
Versão Descrição
4.3.0 A PREG_SPLIT_OFFSET_CAPTURE foi adicionada
4.0.5 A PREG_SPLIT_DELIM_CAPTURE foi adicionada
4.0.0 O parâmetro flags foi adicionado

Exemplos

Exemplo #1 Exemplo da preg_split(): Obtendo partes de uma string

<?php
// reparte a frase por algum número caracteres de vírgula ou espaço,
// incluindo " ", \r, \t, \n e \f
$keywords = preg_split("/[\s,]+/", "hypertext language, programming");
?>

Exemplo #2 Dividindo a string em cada caractere que a compõe

<?php
$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>

Exemplo #3 Dividindo a string pela combinação e seus offsets

<?php
$str = 'hypertext language programming';
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);
?>

O exemplo acima irá imprimir:

Array
(
[0] => Array
(
[0] => hypertext
[1] => 0
)

[1] => Array

(
[0] => language
[1] => 10
)

[2] => Array

(
[0] => programming
[1] => 19
)

unset
(PHP 4, PHP 5)

unset — Destrói a variável especificada

Descrição
void unset ( mixed $var [, mixed $var [, mixed $... ]] )

unset() destrói a variável especificada.

O comportamento de unset() pode variar dentro de uma função dependendo do tipo de

variável que você está tentando destruir.

Se utilizar unset() em uma variável global dentro de uma função, somente a variável
local será destruída. A variável no ambiente que foi chamada terá o mesmo valor como
antes da execução de unset().
<?php
function destroy_foo()
{
global $foo;
unset($foo);
}

$foo = 'bar';
destroy_foo();
echo $foo;
?>

O exemplo acima irá imprimir:

bar

Se você quer usar unset() na variável global dentro de uma função, você pode usar o
array $GLOBALS, veja então:

<?php
function foo()
{
unset($GLOBALS['bar']);
}

$bar = "something";
foo();
?>

Se a variável for passada por referencia e a função unset() estiver dentro de uma
função, apenas a variável local será destruída. A variável no ambiente que chamou a
função onde esta unset() irá manter o mesmo valor de antes da utilização de unset().

<?php
function foo(&$bar)
{
unset($bar);
$bar = "blah";
}

$bar = 'something';
echo "$bar\n";

foo($bar);
echo "$bar\n";
?>

O exemplo acima irá imprimir:

something
something
Se for utilizado unset() com uma variável estática dentro de uma função, unset() destrói
a variável somente no contexto do resto da função. Chamada seguintes irão restaurar o
valor anterior da variável. todas as suas referências.

<?php
function foo()
{
static $bar;
$bar++;
echo "Before unset: $bar, ";
unset($bar);
$bar = 23;
echo "after unset: $bar\n";
}

foo();
foo();
foo();
?>

O exemplo acima irá imprimir:

Before unset: 1, after unset: 23

Before unset: 2, after unset: 23
Before unset: 3, after unset: 23

Parâmetros
var

The variable to be unset.

var

Another variable ..

...

Valor Retornado

Não há valor retornado.

Histórico
Versão Descrição
4.0.0 unset() tornou-se uma expressão. (No PHP 3, unset() sempre retorna 1).

Exemplos

Exemplo #1 Exemplo da unset()

<?php
// destroy a single variable
unset($foo);
// destroy a single element of an array
unset($bar['quux']);

// destroy more than one variable

unset($foo1, $foo2, $foo3);
?>