Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

sscanf()

Odczytuje pola zgodnie z formatem.

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

Składnia

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

Odczytuje pola zgodnie z formatem. Bez zmiennych wyjściowych zwraca tablicę z null dla niedopasowanego pola. Z argumentami referencyjnymi przypisuje wyniki i przy pełnym lub częściowym odczycie podaje liczbę przypisań. Sprawdź ją przed użyciem wszystkich pól. Przy końcu wejścia bez przypisań wynik to null bez referencji lub -1 z referencjami, których wartości pozostają bez zmian. Zła liczba zmiennych wyjściowych powoduje ValueError.

Sygnatura

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

Wynik przykładu

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

Przykłady

<?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]);

Wynik

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

Źródła