compact

(PHP 4, PHP 5, PHP 7, PHP 8)

compactCrea un array a partir de variables y su valor

Descripción

compact(array|string $var_name, array|string ...$var_names): array

Crea un array a partir de variables y su valor.

Para cada uno de los argumentos varname, ..., compact() busca una variable con el mismo nombre en la tabla actual de símbolos, y la añade al array, de manera que se tenga la relación nombre => 'valor de variable'. En resumen, es lo contrario de la función extract().

Nota:

Antes de PHP 7.3, todas las cadenas no definidas eran ignoradas en silencio.

Parámetros

var_name
var_names

compact() acepta diferentes parámetros varname. Los parámetros pueden ser variables que contienen cadenas, o un array de cadenas, que puede contener otros arrays de nombres de variables, que compact() tratará de manera recursiva.

Valores devueltos

Devuelve el array de salida que contiene todas las variables añadidas.

Errores/Excepciones

compact() emite un error de nivel E_WARNING si una cadena dada hace referencia a una variable no definida.

Historial de cambios

Versión Descripción
8.0.0 Si una cadena dada hace referencia a una variable no definida, se emite un error de nivel E_WARNING.
7.3.0 compact() emite ahora un error de nivel E_NOTICE si una cadena dada hace referencia a una variable no definida. Anteriormente, estas cadenas eran ignoradas en silencio.

Ejemplos

Ejemplo #1 Ejemplo con compact()

<?php

$city
= "San Francisco";
$state = "CA";
$event = "SIGGRAPH";

$location_vars = array("city", "state");

$result = compact("event", $location_vars);
print_r($result);

?>

El resultado del ejemplo sería:

Array
(
    [event] => SIGGRAPH
    [city] => San Francisco
    [state] => CA
)

Notas

Nota: Error común

Debido a que las variables variables no deben ser utilizadas con los arrays superglobales en funciones, los arrays Superglobales no deben ser pasados a la función compact().

Ver también

  • extract() - Importa las variables en la tabla de símbolos