is_scalar

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

is_scalar — Prüft, ob eine Variable skalar ist

Beschreibung

is_scalar(mixed $value): bool

Prüft, ob ein Ausdruck als skalarer Wert ausgewertet wird.

Für weitere Informationen siehe skalare Typen.

Hinweis:
is_scalar() betrachtet Variablen vom Typ resource nicht als skalar, da Resourcen abstrakte Datentypen darstellen, auch wenn sie zur Zeit als Integer repräsentiert sind. Sie sollten sich nicht auf dieses Implementationsdetail verlassen, da es sich ändern kann.

Hinweis:
is_scalar() erachtet NULL nicht als skalar.

Parameter-Liste

value: Die zu prüfende Variable.

Rückgabewerte

Gibt true zurück, wenn value skalar ist, sonst false.

Beispiele

Beispiel #1 is_scalar()-Beispiel

<?php
function show_var($var)
{
    if (is_scalar($var)) {
        echo $var;
    } else {
        var_dump($var);
    }
}
$pi = 3.1416;
$proteins = array("Hämoglobin", "Cytochrom c Oxidase", "Ferredoxine");

show_var($pi);
show_var($proteins)

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

3.1416
array(3) {
  [0]=>
  string(11) "Hämoglobin"
  [1]=>
  string(19) "Cytochrom c Oxidase"
  [2]=>
  string(11) "Ferredoxine"
}

Siehe auch

is_float() - Prüft, ob eine Variable vom Typ float ist
is_int() - Prüft, ob eine Variable vom Typ int ist
is_numeric() - Prüft, ob eine Variable eine Zahl oder ein numerischer String ist
is_real() - Alias von is_float
is_string() - Prüft, ob Variable vom Typ string ist
is_bool() - Prüft, ob eine Variable vom Typ boolean ist
is_object() - Prüft, ob eine Variable vom Typ object ist
is_array() - Prüft, ob die Variable ein Array ist

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 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.

＋add a note