MYSQL

Esta estrutura representa um manpulador para uma conexão ao banco de dados. É usada para quase todas as funções MySQL.

MYSQL_RES

Esta estrutura representa o resultado de uma consulta que retorna linhas (SELECT, SHOW, DESCRIBE, EXPLAIN). A informação retornada de uma consulta é chamada conjunto de resultado no resto desta seção.

MYSQL_ROW

Esta é uma representação segura de tipo de uma linha de dados. Ela é implementada atualmente como um vetor de strings de tamanho fixo (Você não pode tratá-los como strings terminadas com null se os valores do campo podem conter dados binários, porque tais valores podem conter um byte null internamente.). Linhas são obtidas pela chamada de mysql_fetch_row().

MYSQL_FIELD

Esta estrutura contém informação sobre um campo, tais como nome, tipo e tamanho do campo. Seus membros são descritos em mais detalhes aqui. Você pode obter a estrutura MYSQL_FIELD para cada campo chamando mysql_fetch_field() repetidamente. Valores de campos não são parte desta estrutura; eles estão contidos na estrutura MYSQL_ROW.

MYSQL_FIELD_OFFSET

Esta é uma representação segura de um offset em uma lista de campos MySQL. (Usado por mysql_field_seek().) Offsets são números de campos em um registro, começando com zero.

my_ulonglong

O tipo usado pelo número de linhas e para mysql_affected_rows(), mysql_num_rows(), e mysql_insert_id(). Este tipo fornece uma faixa de 0 a 1.84e19.

Em alguns sistemas, tentar imprimir um valor do tipo my_ulonglong não funcionará. Para imprimir tais valores, converta-os para unsigned long e use o formato de impressão %lu. Exemplo:

printf ("Número de linhas: %lu\n", (unsigned long) mysql_num_rows(resultado));

char * name

O nome do campo, como um string terminada com null.

char * table

O nome da tabela contendo este campo, se não for um campo calculado. Para campos calculador, o valor table é uma string vazia.

char * def

O valor padrão para este campo, como um string terminada em null. Ele é atribuido apenas se você utilizar mysql_list_fields().

enum enum_field_types tipo

O tipo do campo. O valor tipo pode ser um dos seguintes:

Você pode utilizar a macro IS_NUM() para testar se uma campo tem um tipo numérico. Passe o valor tipo para IS_NUM() e ele irá avaliar como VERDADEIRO (TRUE) se o campo for numérico:

if (IS_NUM(campo->tipo))
    printf("Campo é numérico\n");

unsigned int length

A largura de um campo, como especificado nas definições da tabela.

unsigned int max_length

A largura máxima do campo no conjunto de resultados (O tamanho do maior valor do campo para os registro no resultado atual). Se você utilizar mysql_store_result() ou mysql_list_fields(), ele contem o tamanho máximo para o campo. Se você utiliza mysql_use_result(), o valor desta variável é zero.

unsigned int param

Diferentes parâmetros binários para o campo. O valor de param pode ter zero ou mais dos seguintes conjunto de bits:

Uso dos parâmetros BLOB_FLAG, ENUM_FLAG, SET_FLAG, e TIMESTAMP_FLAG foram obsoletos porque eles indicavam o tipo de um campo e não um atributo do tipo. É preferível testar campo->tipo para FIELD_TYPE_BLOB, FIELD_TYPE_ENUM, FIELD_TYPE_SET, ou FIELD_TYPE_TIMESTAMP.

O seguinte exemplo ilustra o uso típico do valor param:

if (campo->param & NOT_NULL_FLAG)
    printf("Campo não pode ser nulo\n");

Você pode usar as seguintes macros para determinar o status dos valores param:

unsigned int decimals

O número de decimais para um campo numérico.