PHP 8.3.4 Released!

mysqli_result::$lengths

mysqli_fetch_lengths

(PHP 5, PHP 7, PHP 8)

mysqli_result::$lengths -- mysqli_fetch_lengthsRetorna os comprimentos das colunas da linha atual do resultado

Descrição

Estilo orientado a objetos

Estilo procedural

mysqli_fetch_lengths(mysqli_result $result): array|false

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

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
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top