Db num fields PT

From SA-MP Wiki

Jump to: navigation, search

db_num_fields

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


Descrição:

Pega o número de campos do resultado de uma consulta.


Parâmetros:
(DBResult:dbresult)
DBResult:dbresultO resultado da consulta, retornado por db_query.


Valores de retorno:

O número de campos de uma consulta.


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:

new DB:db;
 
public OnGameModeInit(){
    if((db = db_open("exemplo.db")) == DB:0){
        print("Falha o se conectar ao banco de dados 'exemplo.db'");
        SendRconCommand("exit");
        return 1;
    }
    db_free_result(db_query(db, "create table if not exists usuarios (id integer not null primary key autoincrement,\
    nome varchar(24) not null, admin integer default(0))"));
    return 1;
}
 
public OnGameModeExit(){
    db_close(db);
    return 1;
}
 
public OnPlayerCommandText(playerid, cmdtext[]){
    if(!strcmp(cmdtext, "/totalcampos", false)){
        new DBResult: result = db_query(db, "select * from usuarios where 1");
        new string[41];
        format(string, sizeof(string), "A tabela usuarios tem %d campos.", db_num_fields(result));
        SendClientMessage(playerid, -1, string); //Saída: "A tabela usuarios tem 3 campos."
        db_free_result(db);
        return 1;
    }
    return 0;
}

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