Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

sscanf()

Lê campos segundo o formato. Sem variáveis de saída devolve um array com null para um campo sem correspondência.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

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

Lê campos segundo o formato. Sem variáveis de saída devolve um array com null para um campo sem correspondência. Com variáveis por referência atribui os resultados e conta as atribuições numa leitura completa ou parcial. Confirme a contagem antes de usar os campos. Se a entrada terminar antes de qualquer atribuição, devolve null sem referências ou -1 com referências intactas. Um número incorreto de variáveis de saída gera ValueError.

Assinatura

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

Saída do exemplo

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

Exemplos

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

Resultado

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

Fontes