Db free result PT

From SA-MP Wiki

Jump to: navigation, search

db_free_result

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


Descrição:

Libera a memória alocada do resultado da consulta feito com db_query.


Parâmetros:
(DBResult:dbresult)
DBResult:dbresultO resultado para ser liberado.


Valores de retorno:

Se o dbresult for válido retorna 1, caso contrario retorna 0.


Exemplo de uso:

public OnGameModeInit(){
 
    new DB: db = db_open("exemplo.db");
    if(db != DB:0){
        new DBResult: result = db_query(db, "select * from usuarios where nome='Jogador'");
        if(result != DBResult: 0){
            if(db_num_rows(result) > 0){
                print("O usuário 'Jogador' existe!");
            }
            else{
                print("O usuário 'Jogador' não existe!");
            }
            //Liberando o resultado:
            db_free_result(result);
        }
        else{
            print("Falha ao enviar a consulta!");
            /*
            Quando ocorre essa falha a maioria das vezes é erro na syntax.
            */
        }
    }
    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_free_result: Libera o resultado da consulta, gerado pela função db_query
  • 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