WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

__toString

Die öffentliche Methode `__toString` liefert beim Ausgeben, Verketten oder expliziten Umwandeln eine Zeichenfolge.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

public function __toString(): string

Die öffentliche Methode __toString liefert beim Ausgeben, Verketten oder expliziten Umwandeln eine Zeichenfolge. Seit PHP 8 implementiert die Klasse dadurch Stringable. Unter strict_types verlangt ein reiner string-Parameter eine explizite Umwandlung des Objekts. Die Methode darf eine Ausnahme werfen.

declare(strict_types=1);
class Ticket {
    public function __construct(private int $id) {}
    public function __toString(): string { return "T-" . $this->id; }
}
function label(string $s): string { return $s; }
$t = new Ticket(4);
echo json_encode([$t instanceof Stringable, label((string)$t)]), PHP_EOL;
try { label($t); } catch (TypeError $e) { echo get_class($e); }
[true,"T-4"]
TypeError

Beispiele

<?php
declare(strict_types=1);
class Ticket {
    public function __construct(private int $id) {}
    public function __toString(): string { return "T-" . $this->id; }
}
function label(string $s): string { return $s; }
$t = new Ticket(4);
echo json_encode([$t instanceof Stringable, label((string)$t)]), PHP_EOL;
try { label($t); } catch (TypeError $e) { echo get_class($e); }

Ergebnis

[true,"T-4"]
TypeError

Quellen