array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.array-combine.php', 1 => 'array_combine', 2 => 'Erzeugt ein Array, indem es ein Array für die Schlüssel und ein anderes für die Werte verwendet', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.array-column.php', 1 => 'array_column', ), 'next' => array ( 0 => 'function.array-count-values.php', 1 => 'array_count_values', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/array-combine.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_combine

(PHP 5, PHP 7, PHP 8)

array_combine — Erzeugt ein Array, indem es ein Array für die Schlüssel und ein anderes für die Werte verwendet

Beschreibung

array_combine(array $keys, array $values): array

Erzeugt ein Array, in dem die Werte des keys-Arrays als Schlüssel und die Werte aus dem values-Array als die zugehörigen Werte verwendet werden.

Parameter-Liste

keys

Array mit den zu verwendenden Schlüsseln. Für Schlüssel ungültige Werte werden in einen String umgewandelt.

values

Array mit den zu verwendenden Werten

Rückgabewerte

Gibt das kombinierte Array zurück.

Fehler/Exceptions

Seit PHP 8.0.0 wird ein ValueError ausgelöst, wenn die Anzahl der Elemente in keys und values nicht übereinstimmt. Vor PHP 8.0.0 wurde stattdessen ein Fehler der Stufe E_WARNING ausgegeben.

Changelog

Version Beschreibung
8.0.0 array_combine() löst nun einen ValueError aus, wenn die Anzahl der Elemente der Arrays nicht gleich ist; vorher gab diese Funktion stattdessen false zurück.

Beispiele

Beispiel #1 Ein einfaches array_combine()-Beispiel

<?php
$a = array('gruen', 'rot', 'gelb');
$b = array('avocado', 'apfel', 'banane');
$c = array_combine($a, $b);

print_r($c);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [gruen] => avocado
    [rot] => apfel
    [gelb] => banane
)

Siehe auch