Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

array_walk

Array-Funktionen

    Befehl:
bool array_walk ( array &$array, callback $funcname [, mixed $userdata] )


    Parameter-Liste:
NameBeschreibung
arrayDas Eingabe-Array.
funcnameTypischerweise akzeptiert funcname zwei Parameter. Der Wert von array wird als erster übergeben, und der Schlüssel/Index als zweiter.
Hinweis:
Wenn funcname direkt mit den Werten des Arrays arbeiten soll, spezifizieren Sie den ersten Parameter von funcname als Referenz. Dann werden alle Änderungen an diesen Elementen direkt in dem originalen Array durchgeführt.
Hinweis:
Viele interne Funktionen (wie z.B. strtolower()) erzeugen eine Warnung, wenn mehr als die erwartete Anzahl von Parametern übergeben wird; sie sind auch nicht direkt nutzbar als funcname.
Nur die Werte von array können geändert werden. Die Struktur des Arrays kann nicht geändert werden, d.h. dass der Programmierer keine Elemente hinzufügen oder löschen kann und dass die Reihenfolge der Elemente nicht geändert werden kann. Falls die Callback-Funktion diese Anforderung nicht beachtet, ist der Verhalten dieser Funktion nicht definiert und auch nicht vorhersagbar.
userdataWenn der optionale Parameter userdata angegeben ist, wird er als dritter Parameter dem Callback funcname übergeben.

    Beschreibung:
Die Funktion array_walk() übergibt jedes Element eines Arrays (arr) nacheinander an die Rückruffunktion function.

Innerhalb dieser Funktion erhalten Sie den Wert des jeweiligen Array-Elements als ersten Parameter, den Schlüssel des Elements als zweiten Parameter und den Wert von userdata als dritten Parameter.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Wendet eine Benutzerfunktion rekursiv auf jedes Element eines Arrays an
 
Call a function for every element in an iterator
 
Erzeugen einer anonymen / temporären (Lambda-Stil) Funktion
 
•  list()
Weist Variablen zu, als wären sie ein Array
 
•  each()
Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor
 
Call a callback with an array of parameters
 
Wendet eine Callback-Funktion auf die Elemente von Arrays an
 

array_walk() - Beispiel:


Eingabe:
<?php
$fruits = array("d" => "Zitrone", "a" => "Orange", "b" => "Banane", "c" => "Apfel");

function test_alter(&$item1, $key, $prefix)
{
    $item1 = "$prefix: $item1";
}

function test_print($item2, $key)
{
    echo "$key. $item2<br>\n";
}

echo "Vorher ...:\n";
array_walk($fruits, 'test_print');

array_walk($fruits, 'test_alter', 'Frucht');
echo "... und nachher:\n";

array_walk($fruits, 'test_print');
?>


Ausgabe:
Vorher ...:
d. Zitrone
a. Orange
b. Banane
c. Apfel
... und nachher:
d. Frucht: Zitrone
a. Frucht: Orange
b. Frucht: Banane
c. Frucht: Apfel
array_walk() - Beispiel


Eingabe:
<?PHP
function tue_etwas ( $_var )
{
    global $_neu;

    $_neu += $_var;

    echo $_neu . "\n";
}

$var = array ( 2, 4, 6 );

array_walk ( $var, 'tue_etwas' );
?>


Ausgabe:
2
6
12
Array-Funktionen