Skip to content

Commit

Permalink
Revert commit and fix deleted file
Browse files Browse the repository at this point in the history
  • Loading branch information
iPollo committed Oct 14, 2023
1 parent 8e6bc3d commit b47a256
Showing 1 changed file with 90 additions and 0 deletions.
90 changes: 90 additions & 0 deletions docs/translations/pt-BR/scripting/functions/db_close.md
Original file line number Diff line number Diff line change
@@ -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.

0 comments on commit b47a256

Please sign in to comment.