diff --git a/docs/translations/pt-BR/scripting/functions/db_close.md b/docs/translations/pt-BR/scripting/functions/db_close.md new file mode 100644 index 000000000..f5a61053d --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/db_close.md @@ -0,0 +1,90 @@ +--- +title: db_close +description: Fecha uma conexão de banco de dados SQLite que foi aberta com `db_open`. +keywords: + - sqlite +--- + + + +## Descrição + +Fecha uma conexão de banco de dados SQLite que foi aberta com [db_open](db_open). + +| Nome | Descrição | +| ----- | ---------------------------------------------------------------------------------------------- | +| DB:db | O identificador da conexão de banco de dados a ser fechada (retornada por [db_open](db_open)). | + +## Retorno + +1: A função foi executada com sucesso. + +0: A função falhou ao executar. Isso pode significar que o identificador de conexão do banco de dados é inválido. + +## Exemplos + +```c +static DB:gDBConnectionHandle; + +// ... + +public OnGameModeInit() +{ + // Criar uma conexão com um banco de dados + gDBConnectionHandle = db_open("exemplo.db"); + + // Se a conexão com o banco de dados existir + if(gDBConnectionHandle) + { + // Uma conexão com o banco de dados foi criada com sucesso + print("Conexão com o banco de dados \"exemplo.db\" criada com sucesso."); + } + else + { + // Falha ao criar uma conexão com o banco de dados + print("Falha ao abrir uma conexão com o banco de dados \"exemplo.db\"."); + } + return 1; +} + +public OnGameModeExit() +{ + // Feche a conexão com o banco de dados se a conexão estiver aberta + if(db_close(gDBConnectionHandle)) + { + // Limpeza extra + gDBConnectionHandle = DB:0; + } + + // ... + return 1; +} +``` + +## Notas + +:::warning + +Usar um identificador inválido diferente de zero irá travar seu servidor! Obtenha um identificador de conexão de banco de dados válido usando [db_open](db_open). + +::: + +## Funções relacionadas + +- [db_open](db_open): Abre uma conexão com um banco de dados SQLite. +- [db_query](db_query): Consulta um banco de dados SQLite. +- [db_free_result](db_free_result): Liberar memória de resultado de uma db_query. +- [db_num_rows](db_num_rows): Obtenha o número de linhas em um resultado. +- [db_next_row](db_next_row): Mover para a próxima linha. +- [db_num_fields](db_num_fields): Obtenha o número de campos em um resultado. +- [db_field_name](db_field_name): Retorna o nome de um campo em um determinado índice. +- [db_get_field](db_get_field): Obtém o conteúdo do campo com o ID especificado da linha de resultado atual. +- [db_get_field_assoc](db_get_field_assoc): Obtém o conteúdo do campo com o nome especificado da linha de resultado atual. +- [db_get_field_int](db_get_field_int): Obtém o conteúdo do campo como um número inteiro com ID especificado da linha de resultado atual. +- [db_get_field_assoc_int](db_get_field_assoc_int): Obtém o conteúdo do campo como um número inteiro com o nome especificado da linha de resultado atual. +- [db_get_field_float](db_get_field_float): Obtém o conteúdo do campo como um float com ID especificado da linha de resultado atual. +- [db_get_field_assoc_float](db_get_field_assoc_float): Obtém o conteúdo do campo como um float com o nome especificado da linha de resultado atual. +- [db_get_mem_handle](db_get_mem_handle): Obtenha o identificador de memória para um banco de dados SQLite que foi aberto com db_open. +- [db_get_result_mem_handle](db_get_result_mem_handle): Obtenha o identificador de memória para uma consulta SQLite que foi executada com db_query. +- [db_debug_openfiles](db_debug_openfiles): A função obtém o número de conexões de banco de dados abertas para fins de depuração. +- [db_debug_openresults](db_debug_openresults): A função obtém o número de resultados do banco de dados aberto.