is_scalar

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

is_scalar — Verifica se é uma váriavel é escalar

Descrição

is_scalar(mixed $value): bool

Verifica se uma expressão é avaliada como um valor escalar.

Consulte Tipos Escalares para mais informação.

Nota:
is_scalar() não considera valores de recurso do tipo resource como escalares, porque recursos são tipos de dados abstratos que atualmente são baseados em inteiros. Esse detalhe de implementação não deve ser levado em consideração pois pode ser modificado futuramente.

Nota:
is_scalar() não considera valores nulos como sendo do tipo escalar.

Parâmetros

value: A variável a ser avaliada.

Valor Retornado

Retorna true se value for uma variável escalar, false caso contrário.

Exemplos

Exemplo #1 Exemplo de is_scalar()

<?php
function show_var($var)
{
    if (is_scalar($var)) {
        echo $var;
    } else {
        var_dump($var);
    }
}
$pi = 3.1416;
$proteins = array("hemoglobin", "cytochrome c oxidase", "ferredoxin");

show_var($pi);
show_var($proteins)

?>

O exemplo acima produzirá:

3.1416
array(3) {
  [0]=>
  string(10) "hemoglobin"
  [1]=>
  string(20) "cytochrome c oxidase"
  [2]=>
  string(10) "ferredoxin"
}

Veja Também

is_float() - Verifica se a variável é do tipo float
is_int() - Informa se o tipo de uma variável é um inteiro
is_numeric() - Verifica se uma variável é um número ou uma string numérica
is_real() - Sinônimo de is_float
is_string() - Verifica se o tipo de uma variável é string
is_bool() - Verifica se a variável é um booleano
is_object() - Verifica se uma variável é um objeto
is_array() - Verifica se a variável é um array

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 3 notes

down

Dr K ¶

19 years ago

Having hunted around the manual, I've not found a clear statement of what makes a type "scalar" (e.g. if some future version of the language introduces a new kind of type, what criterion will decide if it's "scalar"? - that goes beyond just listing what's scalar in the current version.)

In other lanuages, it means "has ordering operators" - i.e. "less than" and friends.

It (-:currently:-) appears to have the same meaning in PHP.

down

Anonymous ¶

18 years ago

Another warning in response to the previous note:
> just a warning as it appears that an empty value is not a scalar.

That statement is wrong--or, at least, has been fixed with a later revision than the one tested.  The following code generated the following output on PHP 4.3.9.

CODE:
<?php
    echo('is_scalar() test:'.EOL);
    echo("NULL: "      . print_R(is_scalar(NULL),     true) . EOL);
    echo("false: "    . print_R(is_scalar(false),   true) . EOL);
    echo("(empty): "  . print_R(is_scalar(''),      true) . EOL);
    echo("0: "         . print_R(is_scalar(0),       true) . EOL);
    echo("'0': "      . print_R(is_scalar('0'),     true) . EOL);
?>

OUTPUT:
is_scalar() test:
NULL: 
false: 1
(empty): 1
0: 1
'0': 1

THUS:
   * NULL is NOT a scalar
   * false, (empty string), 0, and "0" ARE scalars

down

efelch at gmail dot com ¶

19 years ago

A scalar is a single item or value, compared to things like arrays and objects which have multiple values. This tends to be the standard definition of the word in terms of programming. An integer, character, etc are scalars. Strings are probably considered scalars since they only hold "one" value (the value represented by the characters represented) and nothing else.

＋adicione uma nota