Merge pull request #733 from CarlinCV/patch-3

translation for db_close.md - PTBR

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
+---
+
+<LowercaseNote />
+
+## 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.