array_walk

array_walk -- Pas een gebruikersfunctie toe op elk element van een array

Beschrijving

int array_walk ( array array, callback function [, mixed userdata])

Past de door de gebruiker gedefinieerde functie function toe op elk element van de array array . De function ontvangt gewoonlijk twee parameters : een waarde uit array als eerste , en als tweede de key of index . Als de optionele userdata parameter wordt gegeven zal deze als derde parameter worden meegegeven aan de callback function .

Als de function meer parameters nodig heeft dan er aan worden meegegeven wordt er een fout van het niveau E_WARNING gegenereerd elke keer dat array_walk( ) de function aanroept . Deze waarschuwingen kunnen worden onderdrukt door de PHP error operator @ voor de array_walk( ) call te zetten , of door de error_reporting( ) te gebruiken .

Opmerking : Als function moet werken met de eigenlijke waarden van de array kun je de eerste parameter van de function als een reference specificeren . De dingen die worden veranderd in die elementen veranderen dan in de originele array zelf .

Opmerking : Het meegeven van de key en userdata aan de function werd toegevoegd in PHP 4.0.0 .

array_walk( ) is onafhankelijk van de interne array pointer van array . array_walk( ) zal door de gehele array lopen zonder te letten op de positie van de pointer . Om de pointer te resetten kun je reset( ) Om de pointer te resetten kun je reset( ) gebruiken . In PHP 3 reset array_walk( ) de pointer wel .

Gebruikers mogen de array zelf niet veranderen vanuit de callback functie , zoals het toevoegen of verwijderen van een element , of de array waar array_walk( ) op wordt toegepast unsetten . Als de array toch wordt veranderd is het gedrag van deze functie niet gedefinieerd .

Voorbeeld 1 . array_walk( ) voorbeeld




De output van bovenstaand programma ziet er zo uit :








Zie ook list( ) , foreach , each( ) en call_user_func_array( ) .