Db query PT

From SA-MP Wiki

Jump to: navigation, search

db_query

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


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

Nota
Importante

Tipo de retorno para esta função mudou desde a versão 0.3.7 R2.


Descrição:

Esta função é usada para executar uma consulta SQL em um banco de dados aberto com db_open.


Parâmetros:
(DB:db, query[])


DB:dbO identificador do banco de dados aberto.
query[]A consulta para ser executada.


Valores de retorno:

Retorna 0 se falhar ou o identificador do resultado (começando pelo 1).


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

Nota
Importante

Sempre libere o resultado usando db_free_result, não importa qual a consulta enviada mas sempre libere!


Exemplo de uso:

new DB:db;
 
public OnGameModeInit(){
    db = db_open("exemplo.db");
    if(DB:0 != db){
        db_free_result(db_query(db, "create table if not exists test (num1 integer not null)"));
 
        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
In other languages