Array Functions
PHP Manual

list

(PHP 4, PHP 5)

listانتصاب متغیرها به عنوان آرایه

Description

array list ( mixed $varname [, mixed $... ] )

مانند array() تابع واقعی نیست اما ساختار زبانی است. list() برای انتصاب فهرستی از عملوندها استفاده می‌شود.

Parameters

varname

متغیر.

Return Values

بازگرداندن آرایه انتصاب داده شده.

Examples

Example #1 مثال‌های list()

<?php

$info 
= array('coffee''brown''caffeine');

// Listing all the variables
list($drink$color$power) = $info;
echo 
"$drink is $color and $power makes it special.\n";

// Listing some of them
list($drink, , $power) = $info;
echo 
"$drink has $power.\n";

// Or let's skip to only the third one
list( , , $power) = $info;
echo 
"I need $power!\n";

// list() doesn't work with strings
list($bar) = "abcde";
var_dump($bar); // NULL
?>

Example #2 مثال استفاده list()

<table>
 <tr>
  <th>Employee name</th>
  <th>Salary</th>
 </tr>

<?php

$result 
mysql_query("SELECT id, name, salary FROM employees"$conn);
while (list(
$id$name$salary) = mysql_fetch_row($result)) {
    echo 
" <tr>\n" .
          
"  <td><a href=\"info.php?id=$id\">$name</a></td>\n" .
          
"  <td>$salary</td>\n" .
          
" </tr>\n";
}

?>

</table>

Example #3 استفاده از list() داخل یکدیگر

<?php

list($a, list($b$c)) = array(1, array(23));

var_dump($a$b$c);

?>
int(1)
int(2)
int(3)

Example #4 استفاده از list() به همراه اندیس آرایه‌ّای

<?php

$info 
= array('coffee''brown''caffeine');

list(
$a[0], $a[1], $a[2]) = $info;

var_dump($a);

?>

تولید خروجی زیر (ترتیب همان ترتیب در دستور list() است):

array(3) {
  [2]=>
  string(8) "caffeine"
  [1]=>
  string(5) "brown"
  [0]=>
  string(6) "coffee"
}

Notes

Warning

list() مقادیر را با شروع از سمت راست ترین پارامتر انجام می‌دهد. اگر از متغیرهای ساده استفاده می‌کنید نیاز به نگرانی در این باره ندارید. اما اگر از آرایه‌ها اندیس‌دار استفاده می‌کند همان ترتیب اندیس‌ها را انتظار داشته باشید که list() از چپ به راست نوشتید; که این طور نیست و برعکس آن است.

Note:

list() تنها بر آرایه‌های عددی کار می‌کند و فرض بر این است که اندیس از 0 شروع می‌شود.

See Also


Array Functions
PHP Manual