---
title: "db_get_field_assoc | open.mp"
description: "Obtém o conteúdo do campo como uma string com o nome do campo especificado."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc
language: pt-BR
---

# db\_get\_field\_assoc

## Descrição

Obtém o conteúdo do campo com nome especificado.

| Nome | Descrição |
| --- | --- |
| DBResult:dbresult | O resultado de onde obter os dados |
| field\[\] | O nome do campo de onde obter os dados |
| result\[\] | O resultado |
| maxlength | O comprimento máximo do campo |

## Retorno

Retorna 1 se o handle do conjunto de resultados é válido e a coluna está disponível, caso contrário 0.

## Exemplos

```c
// examples.inc

// ...

Examples_ListNames(DB:dbConnectionHandle)
{
    // Conjunto de resultados do banco de dados
    new DBResult:db_result_set = db_query("SELECT `name` FROM `examples`");

    // Se o conjunto de resultados do banco de dados é válido
    if (db_result_set)
    {
        // Aloca alguma memória para armazenar resultados
        new result[256];

        // Faz operações
        do
        {
            // Adiciona o valor do campo "example" à variável de valor de retorno
            db_get_field_assoc(db_result_set, "name", result, sizeof result);
        }

        // Enquanto a próxima linha puder ser obtida
        while (db_next_row(db_result_set));

        // Libera o conjunto de resultados
        db_free_result(db_result_set);
    }
}
```

```c
// mode.pwn

// ...

#include <examples>

static DB:gDBConnectionHandle;

// ...

public OnGameModeInit()
{
    // ...

    // Cria uma conexão com um banco de dados
    gDBConnectionHandle = db_open("example.db");

    // Se a conexão com o banco de dados existe
    if (gDBConnectionHandle)
    {
        // Criou com sucesso uma conexão com o banco de dados
        print("Criou com sucesso uma conexão com o banco de dados \"example.db\".");
        Examples_ListNames(gDBConnectionHandle);
    }
    else
    {
        // Falhou ao criar uma conexão com o banco de dados
        print("Falhou ao abrir uma conexão com o banco de dados \"example.db\".");
    }

    // ...

    return 1;
}

public OnGameModeExit()
{
    // Fecha 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

aviso

Usar um handle inválido diferente de zero crasha o seu servidor! Obtenha um handle de conexão de banco de dados válido usando [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query).

## Funções Relacionadas

-   [db\_open](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_open): Abre uma conexão com um banco de dados SQLite
-   [db\_close](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_close): Fecha a conexão com um banco de dados SQLite
-   [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query): Consulta um banco de dados SQLite
-   [db\_free\_result](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_free_result): Libera a memória do resultado de uma db\_query
-   [db\_num\_rows](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_num_rows): Obtém o número de linhas em um resultado
-   [db\_next\_row](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_next_row): Move para a próxima linha
-   [db\_num\_fields](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_num_fields): Obtém o número de campos em um resultado
-   [db\_field\_name](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_field_name): Retorna o nome de um campo em um índice específico
-   [db\_get\_field](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field): Obtém o conteúdo do campo com ID especificado da linha de resultado atual
-   [db\_get\_field\_int](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_int): Obtém o conteúdo do campo como um inteiro com ID especificado da linha de resultado atual
-   [db\_get\_field\_assoc\_int](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc_int): Obtém o conteúdo do campo como um inteiro com nome especificado da linha de resultado atual
-   [db\_get\_field\_float](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/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](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc_float): Obtém o conteúdo do campo como um float com nome especificado da linha de resultado atual
-   [db\_get\_mem\_handle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_mem_handle): Obtém o handle de memória para um banco de dados SQLite que foi aberto com db\_open.
-   [db\_get\_result\_mem\_handle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_result_mem_handle): Obtém o handle de memória para uma consulta SQLite que foi executada com db\_query.
-   [db\_debug\_openfiles](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/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](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_debug_openresults): A função obtém o número de resultados de banco de dados abertos.