array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli-result.lengths.php', 1 => 'mysqli_result::$lengths', ), 'up' => array ( 0 => 'class.mysqli-result.php', 1 => 'mysqli_result', ), 'prev' => array ( 0 => 'mysqli-result.getiterator.php', 1 => 'mysqli_result::getIterator', ), 'next' => array ( 0 => 'mysqli-result.num-rows.php', 1 => 'mysqli_result::$num_rows', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysqli/mysqli_result/lengths.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8)
mysqli_result::$lengths -- mysqli_fetch_lengths — Retorna os comprimentos das colunas da linha atual do resultado
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.
result
Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().
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.
Exemplo #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();
?>
Exemplo #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