mysql_fetch_lengths()
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.