mysqli_result::$lengths
mysqli_fetch_lengths
(PHP 5, PHP 7, PHP 8)
mysqli_result::$lengths -- mysqli_fetch_lengths — Retorna os comprimentos das colunas da linha atual do resultado
Descrição
Estilo orientado a objetos
Estilo procedural
A função mysqli_fetch_lengths() retorna um array que contém os comprimentos de cada coluna da linha atual dentro do conjunto de resultados.
Parâmetros
-
result Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().
Valor Retornado
Um array de números inteiros que representam o tamanho de cada coluna (não incluindo
caracteres nulos de terminação). false se ocorrer um erro.
mysqli_fetch_lengths() é válida apenas para a linha atual
do resultado. Retorna false se for chamada antes de se chamar
mysqli_fetch_row, mysqli_fetch_array, mysqli_fetch_object ou após ter recebido todas as linhas do resultado.
Exemplos
Example #1 Estilo orientado a objetos
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* verifica a conexão */
if (mysqli_connect_errno()) {
printf("Conexão falhou: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT * from Country ORDER BY Code LIMIT 1";
if ($result = $mysqli->query($query)) {
$row = $result->fetch_row();
/* mostra os comprimentos das colunas */
foreach ($result->lengths as $i => $val) {
printf("Campo %2d tem comprimento %2d\n", $i+1, $val);
}
$result->close();
}
/* fecha a conexão */
$mysqli->close();
?>Example #2 Estilo procedural
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* verifica a conexão */
if (mysqli_connect_errno()) {
printf("Conexão falhou: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT * from Country ORDER BY Code LIMIT 1";
if ($result = mysqli_query($link, $query)) {
$row = mysqli_fetch_row($result);
/* mostra os comprimentos das colunas */
foreach (mysqli_fetch_lengths($result) as $i => $val) {
printf("Campo %2d tem comprimento %2d\n", $i+1, $val);
}
mysqli_free_result($result);
}
/* fecha a conexão */
mysqli_close($link);
?>Os exemplos acima produzirão:
Campo 1 tem comprimento 3 Campo 2 tem comprimento 5 Campo 3 tem comprimento 13 Campo 4 tem comprimento 9 Campo 5 tem comprimento 6 Campo 6 tem comprimento 1 Campo 7 tem comprimento 6 Campo 8 tem comprimento 4 Campo 9 tem comprimento 6 Campo 10 tem comprimento 6 Campo 11 tem comprimento 5 Campo 12 tem comprimento 44 Campo 13 tem comprimento 7 Campo 14 tem comprimento 3 Campo 15 tem comprimento 2