isset

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

    isset — Determina se uma variável está declarada e é diferente de null

    Descrição

    isset(mixed$var, mixed...$vars): bool

    Determina se uma variável é considerada definida, isto é, está declarada e é diferente de null.

    Se a variável tornou-se indefinida com a função unset(), ela não é mais considerada definida.

    isset() retornará false ao verificar uma variável que foi atribuída com o valor null. Note também que um caractere nulo ("\0") não é equivalente à constante null do PHP.

    Se múltiplos parâmetros forem fornecidos então isset() retornará true apenas se todos os parâmetros forem considerados definidos. A avaliação ocorre da esquerda para a direira e para assim que uma variável indefinida for encontrada.

    Parâmetros

    var

    A variável a ser verificada.

    vars

    Mais variáveis a verificar.

    Valor Retornado

    Retorna true se var existe e tem qualquer valor diferente de null. false caso contrário.

    Exemplos

    Exemplo #1 Exemplos de isset()

    <?php

    $var     = '';

    // Isto será avaliado como VERDADEIRO e por isso o texto será mostrado.
    if (isset($var)) {
    echo     "Esta variável está definida então vou imprimir.";
    }

    // Nos próximos exemplos, será utilizado var_dump() para mostrar
    // o valor de retorno de isset().

    $a = "teste";
    $b = "outroteste";

    var_dump(isset($a)); // VERDADEIRO
    var_dump(isset($a, $b)); // VERDADEIRO

    unset ($a);

    var_dump(isset($a)); // FALSO
    var_dump(isset($a, $b)); // FALSO

    $foo = NULL;
    var_dump(isset($foo)); // FALSO

    ?>

    Isto também funciona para elementos em arrays:

    <?php

    $a     = array ('test' => 1, 'hello' => NULL, 'pie' => array('a' => 'apple'));

    var_dump(isset($a['test'])); // VERDADEIRO
    var_dump(isset($a['foo'])); // FALSO
    var_dump(isset($a['hello'])); // FALSO

    // A chave 'hello' é igual a NULO então é considerada indefinida
    // Se deseja-se verificar por chaves de valores NULOS, deve-se tentar:
    var_dump(array_key_exists('hello', $a)); // VERDADEIRO

    // Verificando valores de array em maior profundidade
    var_dump(isset($a['pie']['a'])); // VERDADEIRO
    var_dump(isset($a['pie']['b'])); // FALSO
    var_dump(isset($a['cake']['a']['b'])); // FALSO

    ?>

    Exemplo #2 isset() em Deslocamento de Strings

    <?php
    $expected_array_got_string     = 'somestring';
    var_dump(isset($expected_array_got_string['some_key']));
    var_dump(isset($expected_array_got_string[0]));
    var_dump(isset($expected_array_got_string['0']));
    var_dump(isset($expected_array_got_string[0.5]));
    var_dump(isset($expected_array_got_string['0.5']));
    var_dump(isset($expected_array_got_string['0 Mostel']));
    ?>

    O exemplo acima produzirá:

    bool(false) bool(true) bool(true) bool(true) bool(false) bool(false)

    Notas

    Aviso

    isset() somente funciona com variáveis, pois passar qualquer outra coisa resultará em erro de interpretação. Para verificar se constantes estão definidas, use a função defined().

    Nota: Como esta é uma construção da linguagem e não uma função, ela não pode ser chamada usando funções variáveis ou argumentos nomeados.

    Nota:

    Ao usar isset() em propriedades inacessíveis de objetos, o método de sobrecarga __isset() será chamado, se declarado.

    Veja Também

    To Top