WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

sscanf()

Liest Felder nach Format. Ohne Ausgabevariablen entsteht ein Array mit null für ein nicht passendes Feld.

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

Syntax

sscanf(string $string, string $format, mixed &...$vars): array|int|null

Liest Felder nach Format. Ohne Ausgabevariablen entsteht ein Array mit null für ein nicht passendes Feld. Mit Referenzvariablen werden Werte zugewiesen und bei vollständigem oder teilweisem Lesen die Zuweisungen gezählt. Die Zahl vor Verwendung aller Felder prüfen. Endet die Eingabe vor der ersten Zuweisung, kommt ohne Referenzen null zurück, mit Referenzen -1 ohne Wertänderung. Eine falsche Anzahl von Ausgabevariablen löst ValueError aus.

Signatur

sscanf(string $string, string $format, mixed &...$vars): array|int|null

Ausgabe des Beispiels

[[12,null],2,7,21]
[null,-1,9]

Beispiele

<?php
$fields=sscanf("12 x","%d %d"); $a=$b=null;
$count=sscanf("7 21","%d %d",$a,$b);
echo json_encode([$fields,$count,$a,$b]);
$a=9; echo "\n", json_encode([sscanf("","%d"),sscanf("","%d",$a),$a]);

Ergebnis

[[12,null],2,7,21]
[null,-1,9]

Quellen