array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'simplexmlelement.key.php', 1 => 'SimpleXMLElement::key', 2 => 'Liefert den aktuellen Schlüssel', ), 'up' => array ( 0 => 'class.simplexmlelement.php', 1 => 'SimpleXMLElement', ), 'prev' => array ( 0 => 'simplexmlelement.haschildren.php', 1 => 'SimpleXMLElement::hasChildren', ), 'next' => array ( 0 => 'simplexmlelement.next.php', 1 => 'SimpleXMLElement::next', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/simplexml/simplexmlelement/key.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SimpleXMLElement::key

(PHP 8)

SimpleXMLElement::key — Liefert den aktuellen Schlüssel

Beschreibung

public SimpleXMLElement::key(): string
Warnung

Vor PHP 8.0 war SimpleXMLElement::key() nur in der Kindklasse SimpleXMLIterator deklariert.

Diese Methode ermittelt den Namen des XML-Tags des aktuellen Elements.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

Gibt den Namen des XML-Tags des Elements zurück, auf das das aktuelle SimpleXMLElement-Objekt verweist.

Fehler/Exceptions

Wirft bei einem Fehler einen Error.

Changelog

Version Beschreibung
8.1.0 Wenn SimpleXMLElement::key() mit einem ungültigen Iterator aufgerufen wird, wird nun ein Error geworfen; zuvor wurde false zurückgegeben.

Beispiele

Beispiel #1 Ermitteln des Schlüssels des aktuellen XML-Tags

<?php
$xmlElement = new SimpleXMLElement('<books><book>PHP basics</book><book>XML basics</book></books>');

try {
echo var_dump($xmlElement->key());
} catch (Error $e) {
echo $e->getMessage(), "\n";
}

$xmlElement->rewind(); // zurücksetzen auf das erste Element
echo var_dump($xmlElement->key());

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Iterator not initialized or already consumed
string(4) "book"