Db field name PT

From SA-MP Wiki

Jump to: navigation, search

db_field_name

Image:Farm-Fresh text lowercase.png Nota: O nome desta função começa com uma letra minúscula.


Descrição:

Retorna o nome do campo selecionado em uma consulta a partir de um índice.


Parâmetros:
(DBResult:dbresult, field, result[], maxlength)
DBResult:dbresultO resultado da consulta, retornado pela função db_query.
fieldO índice do field para pegar o nome.
result[]O vetor que irá ser armazenado o nome do campo.
maxlengthO tamanho máximo do vetor.


Valores de retorno:

Retorna 1 se houver sucesso, 0 se dbresult não for válido ou se o índice não estiver acessível.


Image:32px-Circle-style-warning.png

Aviso

Usando um identificador inválido seu servidor irá crashar! Pegue um identificador válido usando db_query. Mas é protegido contra referências nulas.


Exemplo de uso:

public OnGameModeInit(){
    new DB: db = db_open("exemplo.db");
 
    if(db == DB:0)
        return 1;
 
    new DBResult: result = db_query(db, "select * from usuarios where 1 limit 1");
    new campos = db_num_fields(result);
 
    printf("A tabela 'usuarios' tem %d campos.", campos);
 
    new nome_campo[10];
 
    for(new i; i < campos; i++){
        db_field_name(result, i, nome_campo, sizeof(nome_campo));
        printf("Índice %d - Campo: %s", i, nome_campo);
    }
 
    db_free_result(result);
    db_close(db);
    return 1;
}

Funções Relacionadas

As seguintes funções podem ser úteis, pois estão de alguma forma, relacionadas a esta função.


  • db_open: Abre conexão com o banco de dados SQLite.
  • db_close: Finaliza a conexão com o banco de dados SQLite.
  • db_query: Envia uma consulta para o banco de dados SQLite.
  • db_num_rows: Pega um número de linhas de um resultado de uma consulta.
  • db_next_row: Passa para a próxima linha de um resultado de uma consulta.
  • db_num_fields: Pega o número de campos de um resultado de uma consulta.
  • db_field_name: Pega o nome de um determinado campo pelo resultado da consulta.
  • db_get_field: Pega o valor de um campo pelo índice do campo.
  • db_get_field_int: Pega um valor inteiro de um resultado de uma consulta pelo índice do campo.
  • db_get_field_float: Pela um valor flutuante do resultado de uma consulta pelo índice do campo.
Personal tools
Navigation
Toolbox