unsigned long *mysql_fetch_lengths(MYSQL_RES *result)

Descrição

Retorna o tamanho da coluna do registro atual em um resultado. Se você planeja copiar calores dos compos, esta informação de tamanho é útil também para a otimização, porque você pode evitar a chamada strlen(). Se o resultado contém dados biários, você deveutilizar esta função para determinar o tamanho dos dados, pois strlen() retorna um valor incorreto para quaquer campo contendo caracteres nulos.

O tamanho para colunas vazias e para colunas contendo valores NULL é zero. Para ver como distnguir este dois casos, veja a descrição de mysql_fetch_row().

Valor Retornado

Um vetor de unsigned long integers (inteiros longos sem sinal) representando o tamanho de cada coluna (não incluindo nenhuma caracter nulo). NULL se ocorrer um erro.

Erros

mysql_fetch_lengths() só é válido para o registro atual no resultado. Ele retorna NULL se você chamá-lo antes de mysql_fetch_row() ou depois de retornar todos os registros em um resultado.

Exemplo

MYSQL_ROW row;
unsigned long *lengths;
unsigned int num_fields;
unsigned int i;

row = mysql_fetch_row(result);
if (row)
{
    num_fields = mysql_num_fields(result);
    lengths = mysql_fetch_lengths(result);
    for(i = 0; i < num_fields; i++)
    {
         printf("Column %u is %lu bytes in length.\n", i, lengths[i]);
    }
}