PHP में list() एक भाषा निर्माण (language construct) है जो सरणी के मानों को अलग-अलग चरों (variables) में निर्दिष्ट (assign) करता है। यह केवल संख्यात्मक सूचकांकित सरणियों (indexed arrays) के साथ काम करता है और 0 से शुरू होने वाले सूचकांक मानता है।
सिंटैक्स (Syntax)
list(mixed $var1, mixed $var2, ...): array
PHP 7.1+ में छोटा सिंटैक्स: [$var1, $var2] = $arr;
पैरामीटर्स (Parameters)
$var1, $var2, ... − वे चर जिनमें सरणी के मान निर्दिष्ट किए जाएँगे।
रिटर्न वैल्यू (Return Value)
निर्दिष्ट सरणी लौटाता है।
उदाहरण (Examples)
उदाहरण 1: मूल उपयोग
<?php
$arr = array("David", "Jack");
list($one, $two) = $arr;
echo "Selected candidates: $one and $two.";
// आउटपुट: Selected candidates: David and Jack.
?>
आउटपुट
Selected candidates: David and Jack.
उदाहरण 2: कुछ मान छोड़ना (PHP 7.1+)
<?php
$arr = array("Apple", "Banana", "Cherry", "Date");
[, , $third, $fourth] = $arr; // पहले दो छोड़ें
echo "$third, $fourth"; // Cherry, Date
?>
उदाहरण 3: कुंजियों के साथ निर्दिष्ट करना (PHP 7.1+)
<?php $data = ["name" => "Amit", "age" => 25, "city" => "Delhi"]; ["name" => $n, "age" => $a] = $data; echo "$n is $a years old"; // आउटपुट: Amit is 25 years old ?>
उदाहरण 4: नेस्टेड list() / सरणी विनाश (PHP 7.1+)
<?php
$matrix = [
[1, 2],
[3, 4]
];
foreach ($matrix as [$a, $b]) {
echo "$a + $b = " . ($a + $b) . "
";
}
?>
आउटपुट
1 + 2 = 3 3 + 4 = 7
महत्वपूर्ण नोट्स
list()केवल संख्यात्मक, 0-आधारित सूचकांक वाली सरणियों पर काम करता है (PHP 7.1 से पहले)।- सहयोगी सरणियों के लिए PHP 7.1+ में
["key" => $var]सिंटैक्स उपयोग करें। - यदि सरणी में चरों से कम तत्व हैं, तो अतिरिक्त चरों को
nullमिलता है (PHP 7.0+ में नोटिस के साथ)। list()फ़ंक्शन नहीं है, इसलिए इसे चर फ़ंक्शन के रूप में कॉल नहीं किया जा सकता।