compact
(PHP 4, PHP 5)
compact — Создает массив, содержащий названия переменных и их значения
Описание
Создает массив, содержащий переменные и их значения.
Для каждого из переданного параметров, функция compact() ищет переменную с указанным именем в текущей таблице символов и добавляет их в выводимый массив так, что имя переменной становится ключом, а содержимое переменной становится значением этого ключа. Короче говоря, она обратна функции extract().
Любые неустановленные строки будут просто пропущены.
Список параметров
- varname
-
compact() принимает неограниченное количество параметров. Любой из параметров может быть либо строкой, содержащей название переменной, либо массивом названий переменных. Массив может содержать вложенные массивы названий переменных; функция compact() обрабатывает их рекурсивно.
Возвращаемые значения
Возвращает массив со всеми переменными, добавленными в него.
Примеры
Пример #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
)
Примечания
Замечание: Замечания по работе функции compact
Так как переменные переменных не могут быть использованы с суперглобальными массивами внутри функций, суперглобальные массивы не могут быть переданы в compact().
- PHP Руководство
- Индекс функций
- Справочник функций
- Расширения, относящиеся к переменным и типам
- Массивы
- array_change_key_case
- array_chunk
- array_combine
- array_count_values
- array_diff_assoc
- array_diff_key
- array_diff_uassoc
- array_diff_ukey
- array_diff
- array_fill_keys
- array_fill
- array_filter
- array_flip
- array_intersect_assoc
- array_intersect_key
- array_intersect_uassoc
- array_intersect_ukey
- array_intersect
- array_key_exists
- array_keys
- array_map
- array_merge_recursive
- array_merge
- array_multisort
- array_pad
- array_pop
- array_product
- array_push
- array_rand
- array_reduce
- array_replace_recursive
- array_replace
- array_reverse
- array_search
- array_shift
- array_slice
- array_splice
- array_sum
- array_udiff_assoc
- array_udiff_uassoc
- array_udiff
- array_uintersect_assoc
- array_uintersect_uassoc
- array_uintersect
- array_unique
- array_unshift
- array_values
- array_walk_recursive
- array_walk
- array
- arsort
- asort
- compact
- count
- current
- each
- end
- extract
- in_array
- key
- krsort
- ksort
- list
- natcasesort
- natsort
- next
- pos
- prev
- range
- reset
- rsort
- shuffle
- sizeof
- sort
- uasort
- uksort
- usort
Коментарии
Use the following piece of code if you want to insert a value into an array at a path that is extracted from a string.
Example:
You have a syntax like 'a|b|c|d' which represents the array structure, and you want to insert a value X into the array at the position $array['a']['b']['c']['d'] = X.
<?
function array_path_insert(&$array, $path, $value)
{
$path_el = split('\|', $path);
$arr_ref =& $array;
for($i = 0; $i < sizeof($path_el); $i++)
{
$arr_ref =& $arr_ref[$path_el[$i]];
}
$arr_ref = $value;
}
$array['a']['b']['f'] = 4;
$path = 'a|b|d|e';
$value = 'hallo';
array_path_insert($array, $path, $value);
/* var_dump($array) returns:
array(1) {
["a"]=>
&array(1) {
["b"]=>
&array(2) {
["f"]=>
int(4)
["d"]=>
&array(1) {
["e"]=>
string(5) "hallo"
}
}
}
*/
?>
Rock on
Philipp
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);
}
?>
You might could think of it as ${$var}. So, if you variable is not accessible with the ${$var} it will not working with this function. Examples being inside of function or class where you variable is not present.
<?php
$foo = 'bar';
function blah()
{
// this will no work since the $foo is not in scope
$somthin = compact('foo'); // you get empty array
}
?>
PS: Sorry for my poor english...
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
)
You can check whether a variable is defined by using array_key_exists()!First, you may ask that no reserved array (would be called $LOCALS) is predefined in function scope (contrast to reserved array $GLOBALS in global scope. To solve it, you can use compact().
Then, you may ask that why property_exists() cannot be used. This is because no reserved function is predefined to create OBJECT containing variables and their values, and no reserved function is predefined to import variables into the current symbol table from an OBJECT. In addition, property_exists() breaks the naming convention of reserved function.
Finally, I show how to check whether a variable is defined by using array_key_exists():
<?php
function too(){
$roo = array_key_exists('foo', compact('foo'));
echo ($roo?'1':'0').'<br/>';
$foo = null;
$roo = array_key_exists('foo', compact('foo'));
echo ($roo?'1':'0').'<br/>';
}
too();
?>
The output will be:
0<br/>
1<br/>
Compact does not work with references, but there is a short way to resolve this:
<?php
//$foo=array();
foreach( array('apple','banana') as $v) $foo[$v] = &$v;
?>
Please note that compact() will _not_ issue a warning if the specified variable name is undefined.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.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).