b4o3oz
Aceste functii va permit sa gestionati tablourile in diferite moduri. Tablourile sunt esentiale pentru memorarea, gestionarea si operarea cu multimi de variabile. PHP permite folosirea tablourilor uni si multidimensionale.

array
Are sintaxa:

array array( amixed... i)Creaza si intoarce un tablou de parametri.

Nota: array() este un constructor de limbaj utilizat pentru a reprezenta tablouri si nu o functie obisnuita.

Sintaxa index => valori, separata prin virgula, defineste indexul si valorile. Indexul poate fi de tip sir sau numeric. Cand indicele este omis, un index intreg este automat produs incepand de la 0. Daca indexul este un intreg, indexul urmator produs va fi indexul intreg mai mare cu 1. Notati ca atunci cand se definesc doi indecsi identici cu valori diferite, ultima valoare o suprascrie pe prima.

Urmatorul exemplu demonstreaza cum se creaza un tablou bidimensional, cum se specifica cheia pentru un tablou asociativ si cum sar si continua indicii numerici din tablou:

$fruits = array(
"fruits" => array( "a" => "orange", "b" => "bannana", "c" => "apple"),
"numbers" => array( 1, 2, 3, 4, 5, 6),
"holes" => array( "first", 5 => "second", "third")
);Suprascrierea indicilor:

$array = array( 1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13); print_r( $array);Continutul este:

array( a0i => 1, a1i => 1, a2i => 1, a3i => 13, a4i => 1, a8i => 1, a9i => 19)Notati ca indicele 3 este definit de doua ori si tine valoarea sa finala, 13. Indexul 4 este definit dupa indexul 8 si indexul urmator devine 9 (pentru a estima 19), de vreme ce indicele cel mai mare era 8.

Urmatorul exemplu creaza un tablou cu o baza pe 1.

$primele_3_luni = array( 1 => 'ianuarie', 'februarie', 'martie'); print_r( $primele_3_luni);Tabloul $primele_3_luni va contine:

array( a1i => 'ianuarie', a2i => 'februarie', a3i => 'martie')array_count_values
Are sintaxa:

array array_count_values( array input)Functia returneaza un tablou folosind valorile din tabloul de intrare, input, drept chei si frecventa lor drept valori.

Exemplu:

$array = array( 1, "salut", 1, "moneda", "salut"); array_count_values( array);
// Restitue array( 1 => 2, "salut" => 2, "moneda" => 1)array_diff
Are sintaxa:

array array_diff( array array1, array array2 a, array ...i)Functia returneaza un tablou care contine toate valorile tabloului array1 care nu sunt prezente in nici unul din celelalte argumente; cheile sunt pastrate.

Exemplu:

$array1 = array( "a" => "green", "red", "blue");
$array2 = array( "b" => "green", "yellow", "red");
$result = array_diff( $array1, $array2);
// $result va reprezenta array( "blue")array_intersect
Are sintaxa:

array array_intersect( array array1, array array2 a, array ...i)Functia returneaza un tablou continand toate valorile lui array1 care sunt prezente in toate celelalte argumente; cheile sunt pastrate.

Exemplu:

$array1 = array( "a" = > "vert", "rouge", "bleu");
$array2 = array ( "b" = > "vert", "jaune", "rouge");
$result = array_intersect( $array1, $array2);
// $result va reprezenta array( "a" => "vert", "rouge");array_keys
Are sintaxa:

array array_keys( array input a, mixed search_valuei)Functia returneaza cheile (numerice sau siruri de caractere) ale tabloului input.

Daca argumentul search_value este specificat, atunci doar cheile corespunzatoare acestei valori sunt restituite. Altfel se restituie toate cheile.

Exemplu:

$array = array( 0 => 100, "color" => "red"); array_keys ( $array); // Restitue array( 0, "color")

$array = array( "blue", "red", "green", "blue", "blue"); array_keys ( $array, "blue"); // Restitue array( 0, 3, 4)array_merge
Are sintaxa:

array array_merge( array array1, array array2 a, array ...i)Functia concateneaza elementele a doua sau mai multe tablouri astfel incat elementele unui tablou se adauga la sfarsitul tabloului precedent. Returneaza tabloul obtinut.

Daca tablourile de intrare au aceleasi chei tip sir de caractere, atunci ultima valoare a respectivei chei va fi scrisa peste cea precedenta. Daca, tablourile au chei numerice identice, ultima valoare nu va suprascrie valoarea originala, dar va fi adaugata.

Exemplu:

$array1 = array ( "color" => "red", 2, 4);
$array2 = array ( "a", "b", "color" => "green", "shape" => "trapezoid", 4); array_merge( $array1, $array2);Tabloul obtinut este:

array( "color" => "green", 2, 4, "a", "b", "shape" => "trapezoid", 4)array_multisort
Are sintaxa:

bool array_multisort( array ar1 a, mixed arg a, mixed ... a, array ...iii)Functia poate fi utilizata pentru a sorta mai multe tablouri odata sau un singur tablou multidimensional in functie de una sau mai multe dimensiuni (criterii de sortare). Sortarea nu afecteaza cheile asociative.

Tablourile de intrare sunt tratate drept coloanele unui tabel care se sorteaza pe linii. Primul tablou reprezinta criteriul primar de sortare. Valorile din respectivul tablou (situate pe linii) se compara intre ele si daca sunt egale se sorteaza conform celui de al doilea tablou etc.

Structura argumentelor acestei functii este putin neobisnuita, dar flexibila. Primul argument trebuie sa fie obligatoriu un tablou. In continuare, fiecare argument este fie un tablou fie un criteriu de sortare.

Criterii de sortare dupa ordine:

SORT_ASC
Ordonare in ordine crescatoare;
SORT_DESC
Ordonare in ordine descrescatoare.
Criterii de sortare dupa tip:

SORT_REGULAR
Comparara valorile normal;
SORT_NUMERIC
Comparara valorile numeric;
SORT_STRING
Comparara valorile ca siruri de caractere.
Nu se pot specifica doua criterii de acelasi tip dupa un argument. Functia intoarce TRUE daca sortarea a reusit si FALSE in caz contrar.

Exemplu (sortarea a mai multor tablouri):

$ar1 = array( "10", 100, 100, "a");
$ar2 = array( 1, 3, "2", 1); array_multisort( $ar1, $ar2);In acest exemplu, dupa sortare, primul tablou contine 10, "a", 100,100. Al doilea contine 1, 1, 2, "3". Intrarea in al doilea tablou corespunde intrarilor identice in primul tablou care au fost deasemenea ordonate.

Exemplu (sortarea tablourilor multidimensionale):

$ar = array( array( "10", 100, 100, "a"), array( 1, 3, "2", 1)); array_multisort( $ara0i, SORT_ASC, SORT_STRING,

$ara1i, SORT_NUMERIC, SORT_DESC);In acest exemplu, dupa sortare, primul tablou va contine 10, 100, 100, "a" (a fost sortat ca siruri de caractere in ordine crescatoare), iar al doilea va contine 1, 3, "2", 1 (sortat ca numere in ordine descrescatoare).

array_pad
Are sintaxa:

array array_pad( array input, int pad_size, mixed pad_value)Functia returneaza o copie a tabloului input avand dimensiunea specificata prin pad_size si umplut cu valoarea pad_value. Daca argumentul pad_size este pozitiv tabloul este umplut la dreapta, iar daca este negativ este umplut la stanga. Daca valoarea absoluta a argumentului pad_size este mai mica sau egala cu lungimea tabloului input umplerea nu are loc.

Exemplu:

$input = array( 12, 10, 9);
$result = array_pad( $input, 5, 0); // Tabloul $result contine (12, 10, 9, 0, 0)
$result = array_pad( $input, -7, -1); // Tabloul $result contine (-1, -1, -1, -1, 12, 10, 9)
$result = array_pad( $input, 2, "noop"); // Umplerea nu are locarray_pop
Are sintaxa:

mixed array_pop( array array)Functia extrage si returneaza ultimul element din tabloul array si micsoreaza dimensiunea tabloului cu o unitate.

Exemplu:

$my_list = array( "orange", "apple", "raspberry");
$fruit = array_pop( $my_list);
/* In acest moment $my_list are doar 2 elemente: "orange" si "apple";
$fruit are "raspberry" */array_push
Are sintaxa:

int array_push( array array, mixed var a, mixed ...i)Functia trateaza tabloul ca pe o coada si introduce valorile primite ca argumente la sfarsitul tabloului. Lungimea tabloului creste cu numarul de variabile introduse. Are acelasi efect ca si instructiunea:

$arrayai = $var;repetata pentru fiecare $var.

Exemplu:

$queue = array( 1, 2); array_push( $queue, "+", 3);
// Tabloul $queue va contine: 1, 2, "+" si 3Functia returneaza noul numar de elemente din tablou.

array_reverse
Are sintaxa:

array array_revers( array array a, bool preserve_keysi)Functia returneaza un nou tablou care contine elementele tabloului array in ordine inversa.

Exemplu:

$input = array( "php", 4.0, array( "green", "red"));
$result = array_reverse( $input);
// Tabloul $result va contine ( array( "green", "red"), 4.0, "php")Nota: functia nu modifia cheile tabloului daca argumentul preserve_key este TRUE.

array_shift
Are sintaxa:

mixed array_shift( array array)Functia extrage si returneaza primul element din tabloul array, muta elementele cu o pozitie spre stanga si reduce dimensiunea tabloului cu 1.

Exemplu:

$args = array( "-v", "-f");
$opt = array_shift( $args);
/* Tabloul $argc va contine elementul "-f"; variabila $opt va fi "-v" */array_slice
Are sintaxa:

array array_splice( array input, int offset a, int length a, array replacementii)Functia extrage o portiune dintr-un tablou; returneaza secventa elementelor din argumentul input specificata prin parametrii offset si length.

Daca offset este pozitiv, secventa va incepe la acea pozitie din tablou. Daca offsset este negativ, secventa va incepe la aceea pozitie fata de sfarsitul tabloului.

Daca length este precizat si este pozitiv, atunci secventa va avea length elemente. Daca length este precizat si este negativ, atunci secventa se va opri la length elemente fata de sfarsitul tabloului. Daca length lipseste secventa va contine toate elementele incepand de la pozitia offset pana la sfarsitul tabloului.

Exemplu:

$input = array( "a", "b", "c", "d", "e");
$output = array_slice( $input, 2); // Returneaza "c", "d" si "e"
$output = array_slice( $input, 2, -1); // Returneaza "c" si "d"
$output = array_slice( $input, -2, 1); // Returneaza "d"
$output = array_slice( $input, 0, 3); // Returneaza "a", "b" si "c" array_sum
Are sintaxa:

mixed array_sum( array arr)Functia calculeaza si returneaza suma elementelor din tabloul arr ca un numar intreg sau float.

array_unique

Are sintaxa:

array array_unique( array array)Functia elimina valorile duplicate din tablou; returneaza un tablou nou care nu contine valori duplicate; cheile nu se modifica.

Exemplu:

$input = array( "a" => "green", "red", "b" => "green", "blue", "red");
$result = array_unique( $input);
// Tabloul $result contine ( "a" => "green", "red", "blue")array_unshift
Are sintaxa:

int array_unshift( array array, mixed var a, mixed ...i)Functia insereaza valorile specificate in lista la inceputul tabloului array in aceeasi ordine. Valorile initiale sunt deplasate spre dreapta si dimensiunea tabloului creste cu numarul valorilor introduse; returneaza noua dimensiune a tabloului.

Exemplu:

$stack = array( "p1", "p3"); array_unshift( $stack, "p4", "p5", "p6");
// Tabloul $stack va contine: "p4", "p5", "p6", "p1" si "p3"array_values
Are sintaxa:

array array_values( array input)Functia returneaza toate valorile din tabloul input.

Exemplu:

$tshirt = array( "size" => "XL", "color" => "gold"); array_values( $tshirt); // Returneaza array( "XL", "gold")arsort
Are sintaxa:

void arsort( array array a, int sort_flagsi)Functia sorteaza descrescator tabloul array astfel incat legaturile dintre indicii asociativi si valorile indicate de catre acestia sa se mentina. Veti folosi aceasta functie pentru a sorta tablouri asociative in care ordinea actuala a elementelor este importanta.

Exemplu:

$fruits = array( "d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); arsort( $fruits); reset( $fruits);
while( list( $key, $val) = each( $fruits))
A echo "$key = $val\n";
SSe va obtine:

fruitsaai = orange fruitsadi = lemon fruitsabi = banana fruitsaci = appleFructele au fost sortate in ordine alfabetica descrescatoare pastrand legatura dintre indec7#351;ii asociativi si elemente.

asort
Are sintaxa:

void asort( array array a, int sort_flagsi))Functia sorteaza crescator tabloul array astfel incat legaturile dintre indicii asociativi si valorile indicate de catre acestia sa se mentina. Veti folosi aceasta functie pentru a sorta tablouri asociative in care ordinea actuala a elementelor este importanta.

Exemplu:

$fruits = array( "d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); arsort( $fruits); reset( $fruits);
while( list( $key, $val) = each( $fruits))
A echo "$key = $val\n";
SFructele au fost aranjate in ordine alfabetica pastrand legatura dintre indec7#351;ii asociativi si elemente. Exemplul de mai sus va furniza rezultatul:

fruitsaci = apple fruitsabi = banana fruitsadi = lemon fruitsaai = orangecount
Are sintaxa:

int count( mixed var)Functia returneaza numarul de elemente din argumentul var, care este de obicei un tablou. Intoarce 1 daca variabila nu este un tablou si 0 daca variabila nu a fost initializata.

Exemplu:

$a a0i = 1;
$a a1i = 3;
$a a2i = 5;
$result = count( $a); // $result == 3each
Are sintaxa:

array each( array array)Functia returneaza cheia curenta si valoarea corespunzatoare din tabloul array si avanseaza pointerul tabloului. Aceasta pereche de valori este returnata intr-un tablou cu 4 elemente, cu cheile 0, 1, key si value. Elementele 0 si key contin numele elementului din tablou, iar 1 si value contin valoarea.

Daca s-a ajuns la sfarsitul tabloului functia each() returneaza FALSE.

Exemplu:

$my_list = array( "bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each( $my_list);Variabila $bar va contine contine urmatoarele perechi key/value:

0 => 0
1 => 'bob' key => 0 value => 'bob'$my_list = array( "Robert" => "Bob", "Seppo" => "Sepi");
$bar = each( $my_list);Variabila $bar va contine contine urmatoarele perechi key/value:

0 => 'Robert'
1 => 'Bob' key => 'Robert' value => 'Bob'Functia each() este utilizata in conjuctura cu functia list() pentru a traversa un tablou, de exemplu $HTTP_POST_VARS:

echo "Valorile trasmise via POST:<br>"; reset( $HTTP_POST_VARS);
while( list( $key, $val) = each( $HTTP_POST_VARS))
A echo "$key => $val<br>";

Send
Are sintaxa:

end( array array)Functia pozitioneaza poinerul intern al tabloului pe ultimul element.

in_array
Are sintaxa:

bool in_array( mixed needle, array haystack)Functia cauta valoarea needl in tabloul haystack si intoarce TRUE daca o gaseste si FALSE in caz contrar.

Exemplu:

$os = array( "Mac", "NT", "Linux", "OS/2"); if( in_array( "Linux", $os)) print "Got Linux";key
Are sintaxa:

mixed key( array array)Functia intoarce indicele elementului corespunzator pozitiei curente in tablou.

list
Are sintaxa:

void list(...)Nu este o functie reala ci un constructor de limbaj. Este utilizata pentru a asigna o lista de variabile printr-o singura operatie.

Exemplu:

&l;table>
<tr>
<th>Numele angajatului</th>
<th>Salariu</th>
</tr>
<?php
$result = mysql( $conn, "SELECT id, name, salary FROM employees");
while( list( $id, $name, $salary) = mysql_fetch_now( $result))
A print( " <tr>\n" .
" <td><a href=\"info.php?id=$id\">$name</a></td>\n" .
" <td>$salariu</td>\n" .
" </tr>\n");
S
?>
</table>natsort
Are sintaxa:

void natsort( array array)Aceasta functie implementeaza un algoritm de sortare care ordoneaza alfanumeric sirurile, asa cum ar proceda un operator uman. Aceasta ordonare se numeste ordonare naturala. Diferenta dintre acest algoritm si modul uzual in care un calculator sorteaza sirurile - utilizand de exemplu sort() - reiese din exemplul urmator:

$array1 = $array2 = array( "img12.png", "img10.png", "img2.png", "img1.png"); sort( $array1); echo "Standard sorting\n"; print_r( $array1);

natsort( $array2); echo "\nNatural order sorting\n"; print_r( $array2); Codul anterior genereaza urm73259;toarea iesire:

Standard sorting
Array
(
a0i => img1.png
a1i => img10.png
a2i => img12.png
a3i => img2.png
)

Natural order sorting
Array
(
a3i => img1.png
a2i => img2.png
a1i => img10.png
a0i => img12.png
)natcasesort
Are sintaxa:

void natcasesort( array array)Aceasta functie implementeaza un algoritm case-insenzitiv de sortare care ordoneaza alfanumeric sirurile, asa cum ar proceda un operator uman.

next
Are sintaxa:

mixed next( array array)Functia avanseaza pointer-ul intern la urmatorul element din tablou care este returnat drept rezultat. Daca tabloul nu mai are elemente se returneaza FALSE.

prev
Are sintaxa:

mixed prev( array array)Functia devanseaza pointer-ul intern cu o pozitie si returneaza elementul respectiv. Daca tabloul nu mai are elemente se returneaza FALSE.

range
Are sintaxa:

array range( int low, int high)Functia creaza si returneaza un tablou de intregi cu valori cuprinse intre low si high, inclusiv.

reset
Are sintaxa:

mixed reset( array array)Functia pozitioneaza pointerul intern al unui tablou pe primul element al acestuia si returneaza primul element din tablou.

rsort
Are sintaxa:

void rsort( array array a, int sort_flagsi)Functia sorteaza un tablou in ordine descrescatoare.

Exemplu:

$fruits = array( "lemon", "orange", "banana", "apple"); rsort( $fruits); reset( $fruits);
while( list($key, $val) = each( $fruits))
A echo "$key -> $val\n";
SCodul de mai sus afiseaza:

fruitsa0i = orange fruitsa1i = lemon fruitsa2i = banana fruitsa3i = applesizeof
Are sintaxa:

int sizeof( array array)Functia returneaza numarul de elemente dintr-un tablou.

sort
Are sintaxa:

void sort( array array a, int sort_flagsi)i)Functia sorteaza elementele unuii tablou in ordine crescatoare.

Exemplu:

$fruits = array( "lemon", "orange", "banana", "apple"); sort( $fruits); reset( $fruits);
while( list($key, $val) = each( $fruits))
A echo "$key -> $val\n";
SCodul de mai sus afiseaza:

fruitsa3i = apple fruitsa2i = banana fruitsa1i = lemon fruitsa0i = orangeParametrul sort_flags poate fi utilizat pentru a modifica modul de sortare, fiind disponibile urmatoarele valori:

SORT_REGULAR
Comparara valorile normal;
SORT_NUMERIC
Comparara valorile numeric;
SORT_STRING
Comparara valorile ca siruri de caractere.