is_string

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

is_stringInforma se a variável é do tipo string

Descrição

is_string ( mixed $var ) : bool

Verifica se a dada variável é do tipo string.

Parâmetros

var

A variável a ser analisada.

Valor Retornado

Retorna true se var é do tipo string, false senão.

Exemplos

Exemplo #1 Exemplo da is_string()

<?php
if (is_string("23")) {
 echo 
"is string\n";
} else {
 echo 
"is not an string\n";
}
var_dump(is_string('abc'));
var_dump(is_string("23"));
var_dump(is_string(23.5));
var_dump(is_string(true));
?>

O exemplo acima irá imprimir:

is string
bool(true)
bool(true)
bool(false)
bool(false)

Veja Também

  • is_float() - Informa se a variável é do tipo float
  • is_int() - Informa se a variável é do tipo inteiro
  • is_bool() - Verifica se a variável é um boleano
  • is_object() - Informa se a variável é um objeto
  • is_array() - Verifica se a variável é um array

add a note add a note

User Contributed Notes 3 notes

up
27
laszlo dot heredy shift-two gmail etc
10 years ago
Using is_string() on an object will always return false (even with __toString()).

<?php
class B {
  public function
__toString() {
    return
"Instances of B() can be treated as a strings!\n";
  }


$b = new B();
print(
$b); //Instances of B() can be treated as a strings!
print(is_string($b) ? 'true' : 'false'); //false
?>
up
5
Peter Barney
6 years ago
As noted earlier, is_string() returns false on an object that has a __toString() method. Here is a simple way to do a check that will work:

<?php
// determine if the passed argument can be treated like a string.
function is_stringy($text) {
    return (
is_string($text) || (is_object($text) && method_exists($text, '__toString' ));
}
up
0
jcours at numifinancial dot com
3 years ago
is_string() of an integer or float returns false, so it might be useful to include an is_numeric() when checking if a value is stringy:

<?php
function is_stringy($val) {
  return (
is_string($val) || is_numeric($val)
    || (
is_object($val) && method_exists($val, '__toString')));
}
?>

Test code (which should print "vector N OK" for each test vector):
<?php
foreach ([[NULL, false], [false, false], [true, false],
  [
0, true], [[], false], [0.1, true], ["x", true],
  [
"", true], [new Exception("x"), true]] as $idx => $vector) {
  list (
$val, $expected) = $vector;
  if (
is_stringy($val) != $expected) {
    print (
"mismatch at $idx\n");
   
var_dump($val);
  } else {
    print (
"vector $idx OK\n");
  }
}
?>
To Top