Db query PT
From SA-MP Wiki
db_query
Nota: O nome desta função começa com uma letra minúscula. |
Descrição:
Esta função é usada para executar uma consulta SQL em um banco de dados aberto com db_open.
(DB:db, query[])
DB:db | O 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).
Nota | 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_assoc: Pega o valor do resultado de uma consulta pelo nome do campo.
- db_get_field_int: Pega um valor inteiro de um resultado de uma consulta pelo índice do campo.
- db_get_field_assoc_int: Pega um valor inteiro de um resultado de uma consulta pelo nome do campo.
- db_get_field_float: Pela um valor flutuante do resultado de uma consulta pelo índice do campo.
- db_get_field_assoc_float: Pega um valor flutuante do resultado de uma consulta pelo nome do campo.
- db_get_mem_handle: Pegar um identificador de memória para um banco de dados SQLite que foi aberto com db_open.
- db_get_result_mem_handle: Pegar um identificador de memória para uma consulta SQLite que foi executada com db_query.
- db_desbug_openfiles Pega o número de conexões abertas com a função db_open.
- db_desbug_openresults Pega o número de resultados abertos com a função db_query.