PHP में array_unshift() फ़ंक्शन एक सरणी की शुरुआत में एक या अधिक तत्व जोड़ता है। संख्यात्मक कुंजियाँ रीइंडेक्स हो जाती हैं (0 से शुरू), स्ट्रिंग कुंजियाँ अपरिवर्तित रहती हैं।
सिंटैक्स (Syntax)
array_unshift(array &$arr, mixed $value1, mixed ...$values): int
पैरामीटर्स (Parameters)
$arr − इनपुट सरणी (रेफरेंस द्वारा पास की जाती है)।
$value1 − जोड़ा जाने वाला पहला मान। आवश्यक।
$values (वैकल्पिक) − अतिरिक्त मान जो जोड़े जाएँगे।
रिटर्न वैल्यू (Return Value)
सरणी में नए तत्वों की कुल संख्या लौटाता है।
उदाहरण (Examples)
उदाहरण 1: एक तत्व जोड़ना (रिटर्न वैल्यू)
<?php
$arr = array("p" => "one", "q" => "two");
$count = array_unshift($arr, "three");
echo $count; // आउटपुट: 3 (नई कुल लंबाई)
?>
आउटपुट
3
उदाहरण 2: सरणी संरचना दिखाना
<?php
$arr = array("p" => "one", "q" => "two");
array_unshift($arr, "three");
print_r($arr);
?>
आउटपुट
Array
(
[0] => three
[p] => one
[q] => two
)
उदाहरण 3: एकाधिक तत्व जोड़ना
<?php $arr = ["d", "e"]; array_unshift($arr, "a", "b", "c"); print_r($arr); ?>
आउटपुट
Array
(
[0] => a
[1] => b
[2] => c
[3] => d
[4] => e
)
उदाहरण 4: सहयोगी सरणी पर प्रभाव
<?php $arr = ["x" => 10, "y" => 20]; array_unshift($arr, "new"); print_r($arr); // स्ट्रिंग कुंजियाँ 'x', 'y' बनी रहती हैं, संख्यात्मक 0 नया है ?>
संबंधित फ़ंक्शन्स
| फ़ंक्शन | स्थिति | कुंजियाँ |
|---|---|---|
| array_unshift() | शुरुआत में जोड़ें | संख्यात्मक रीइंडेक्स, स्ट्रिंग अपरिवर्तित |
| array_push() | अंत में जोड़ें | संख्यात्मक रीइंडेक्स, स्ट्रिंग अपरिवर्तित |
| array_shift() | शुरुआत से हटाएँ | संख्यात्मक रीइंडेक्स |
| array_pop() | अंत से हटाएँ | संख्यात्मक अपरिवर्तित |