Db close PT

From SA-MP Wiki

Jump to: navigation, search

db_close

Descrição:

Fecha uma conexão do banco de dados SQLite aberta com db_open.


Parâmetros:
(DB:db)
DB:dbO identificador da conexão aberta com o banco de dados SQLite (retornado pela função db_open).


Valores de retorno:

  • 1: Função executada com sucesso.
  • 0: Falha na execução da função. A conexão não foi aberta ou já foi fechada.


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

Aviso

Usando um identificador inválido irá crashar seu servidor! Pegue um identificador válido usando a função db_open. Mas é protegido contra referências nulas.


Exemplo de uso:

new DB: db;
 
//Ao servidor iniciar
public OnGameModeInit(){
    //Abre a conexão com o banco de dados
    db = db_open("exemplo.db");
    //Verifica se a conexão é válida
    if(db == DB:0){
        print("Falha ao se conectar ao banco de dados 'exemplo.db'");
    }
    else{
        print("Conectado com sucesso ao banco de dados 'exemplo.db'");
    }
    return 1;
}
 
//Ao servidor desligar
public OnGameModeExit(){
    //Verifica se o identificador é válido
    if(db != DB:0){
        //Finaliza a conexão
        db_close(db);
        print("Conexão finalizada com o banco de dados com sucesso.");
    }
    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