©
This document uses PHP Chinese website manual Release
(PHP 4, PHP 5, PHP 7)
compact — 建立一个数组,包括变量名和它们的值
$varname
[, mixed $...
] )创建一个包含变量与其值的数组。
对每个参数, compact() 在当前的符号表中查找该变量名并将它添加到输出的数组中,变量名成为键名而变量的内容成为该键的值。简单说,它做的事和 extract() 正好相反。返回将所有变量添加进去后的数组。
任何没有变量名与之对应的字符串都被略过。
varname
compact() 接受可变的参数数目。每个参数可以是一个包括变量名的字符串或者是一个包含变量名的数组,该数组中还可以包含其它单元内容为变量名的数组, compact() 可以递归处理。
返回输出的数组,包含了添加的所有变量。
Example #1 compact() 例子
<?php
$city = "San Francisco" ;
$state = "CA" ;
$event = "SIGGRAPH" ;
$location_vars = array( "city" , "state" );
$result = compact ( "event" , "nothing_here" , $location_vars );
print_r ( $result );
?>
以上例程会输出:
Array ( [event] => SIGGRAPH [city] => San Francisco [state] => CA )
Note: Gotcha
因为可变变量也许不能在函数内部用于 PHP 的超全局数组,此时不能将超全局数组传递入 compact() 中。
[#1] piedone at pyrocenter dot hu [2011-04-15 06:00:24]
A quick way of compacting all local variables:
<?php
$localVariables = compact(array_keys(get_defined_vars()));
?>
This is useful if you want to return all local variables from a function/method or you want to pass all local variables to one. A valid example would be to use this with application hooks/events (if you want the called hook to be able to modify everything in the caller), but otherwise use with care (as methods should be used through their declared interface).
[#2] Robc [2011-01-19 15:16:22]
The description says that compact is the opposite of extract() but it is important to understand that it does not completely reverse extract(). In particluar compact() does not unset() the argument variables given to it (and that extract() may have created). If you want the individual variables to be unset after they are combined into an array then you have to do that yourself.
[#3] tatarynowicz at gmail dot com [2011-01-10 15:17:21]
Please note that compact() will _not_ issue a warning if the specified variable name is undefined.
[#4] M Spreij [2007-05-24 06:10:04]
Can also handy for debugging, to quickly show a bunch of variables and their values:
<?php
print_r(compact(explode(' ', 'count acw cols coldepth')));
?>
gives
Array
(
[count] => 70
[acw] => 9
[cols] => 7
[coldepth] => 10
)
[#5] hericklr at gmail dot com [2005-06-13 08:43:01]
The compact function doesn't work inside the classes or functions.
I think its escope is local...
Above it is a code to help about it.
Comments & Suggestions are welcome.
PS: Sorry for my poor english...
<?php
function x_compact()
{ if(func_num_args()==0)
{ return false; }
$m=array();
function attach($val)
{ global $m;
if((!is_numeric($val)) && array_key_exists($val,$GLOBALS))
{ $m[$val]=$GLOBALS[$val];}
}
function sub($par)
{ global $m;
if(is_array($par))
{ foreach($par as $cel)
{ if(is_array($cel))
{ sub($cel); }
else
{ attach($cel); }
}
}
else
{ attach($par); }
return $m;
}
for($i=0;$i<func_num_args();$i++)
{ $arg=func_get_arg($i);
sub($arg);
}
return sub($arg);
}
?>