---
title: "db_next_row | open.mp"
description: "Avança para a próxima linha do conjunto de resultados obtido com `db_query`."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_next_row
language: pt-BR
---

# db\_next\_row

## descrição

A função avança para a próxima linha do resultado obtido com [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query).

| Nome | Descrição |
| --- | --- |
| DBResult:dbresult | Resultado retornado por [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query). |

## retorno

Retorna 1 se o handle do resultado for válido e ainda não for a última linha. Retorna 0 caso contrário.

## exemplo

```c
// examples.inc

Examples_ListNames(DB:dbConnectionHandle)
{
    new DBResult:db_result_set = db_query("SELECT `name` FROM `examples`");

    if (db_result_set)
    {
        new result[256];

        do
        {
            db_get_field_assoc(db_result_set, "name", result, sizeof result);
            // Aqui pode fazer algo com 'result'
        }
        while (db_next_row(db_result_set));

        db_free_result(db_result_set);
    }
}
```

```c
// mode.pwn

#include <examples>

static DB:gDBConnectionHandle;

public OnGameModeInit()
{
    gDBConnectionHandle = db_open("example.db");

    if (gDBConnectionHandle)
    {
        print("Conexão com banco \"example.db\" criada com sucesso.");
        Examples_ListNames(gDBConnectionHandle);
    }
    else
    {
        print("Falha ao abrir conexão com banco \"example.db\".");
    }

    return 1;
}

public OnGameModeExit()
{
    if (db_close(gDBConnectionHandle))
    {
        gDBConnectionHandle = DB:0;
    }
    return 1;
}
```

## notas

aviso

Usando um identificador inválido seu servidor irá crashar! Pegue um identificador válido usando [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query). Mas é protegido contra referências nulas.

## funções relacionadas

-   [db\_open](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_open): Abre conexão com banco SQLite
-   [db\_close](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_close): Fecha conexão com banco SQLite
-   [db\_query](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_query): Executa consulta no banco
-   [db\_free\_result](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_free_result): Libera memória do resultado
-   [db\_num\_rows](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_num_rows): Obtém número de linhas do resultado
-   [db\_num\_fields](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_num_fields): Obtém número de campos do resultado
-   [db\_field\_name](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_field_name): Retorna nome do campo pelo índice
-   [db\_get\_field](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field): Obtém conteúdo do campo pelo índice
-   [db\_get\_field\_assoc](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc): Obtém conteúdo do campo pelo nome
-   [db\_get\_field\_int](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_int): Obtém conteúdo do campo como inteiro pelo índice
-   [db\_get\_field\_assoc\_int](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc_int): Obtém conteúdo do campo como inteiro pelo nome
-   [db\_get\_field\_float](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_float): Obtém conteúdo do campo como float pelo índice
-   [db\_get\_field\_assoc\_float](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_field_assoc_float): Obtém conteúdo do campo como float pelo nome
-   [db\_get\_mem\_handle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_get_mem_handle): Obtém handle de memória do banco 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 handle de memória do resultado db\_query
-   [db\_debug\_openfiles](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_debug_openfiles): Número de conexões abertas
-   [db\_debug\_openresults](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/db_debug_openresults): Número de resultados abertos