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

# DB\_SelectNextRow

## descrição

A função avança para a próxima linha do conjunto de resultados obtido com [DB\_ExecuteQuery](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_ExecuteQuery).

| Nome | Descrição |
| --- | --- |
| DBResult:dbresult | O resultado retornado por [DB\_ExecuteQuery](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_ExecuteQuery). |

## retorno

Retorna **true** se o handle do resultado for válido e ainda não estiver na última linha, caso contrário, retorna **false**.

## exemplo

```c
// examples.inc

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

    if (db_result_set)
    {
        new result[256];

        do
        {
            DB_GetFieldStringByName(db_result_set, "name", result, sizeof result);
        }
        while (DB_SelectNextRow(db_result_set));

        DB_FreeResultSet(db_result_set);
    }
}
```

```c
// mode.pwn

#include <examples>

static DB:gDBConnectionHandle;

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

    if (gDBConnectionHandle)
    {
        print("Conexão à base de dados \"example.db\" criada com sucesso.");
        Examples_ListNames(gDBConnectionHandle);
    }
    else
    {
        print("Falha ao abrir a base de dados \"example.db\".");
    }

    return 1;
}

public OnGameModeExit()
{
    if (DB_Close(gDBConnectionHandle))
    {
        gDBConnectionHandle = DB:0;
    }

    return 1;
}
```

## notas

## funções relacionadas

-   [DB\_Open](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_Open_Modern): Abrir conexão com uma base de dados SQLite
-   [DB\_Close](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_Close_Modern): Fechar a conexão com uma base de dados SQLite
-   [DB\_ExecuteQuery](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_ExecuteQuery): Executar uma consulta SQL
-   [DB\_FreeResultSet](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_FreeResultSet): Libertar memória do resultado
-   [DB\_GetRowCount](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetRowCount): Obter número de linhas do resultado
-   [DB\_GetFieldCount](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldCount): Obter número de campos do resultado
-   [DB\_GetFieldName](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldName): Obter nome do campo pelo índice
-   [DB\_GetFieldString](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldString): Obter conteúdo de campo por índice
-   [DB\_GetFieldStringByName](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldStringByName): Obter conteúdo de campo por nome
-   [DB\_GetFieldInt](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldInt): Obter conteúdo inteiro por índice
-   [DB\_GetFieldIntByName](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldIntByName): Obter conteúdo inteiro por nome
-   [DB\_GetFieldFloat](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldFloat): Obter conteúdo float por índice
-   [DB\_GetFieldFloatByName](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetFieldFloatByName): Obter conteúdo float por nome
-   [DB\_GetMemHandle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetMemHandle): Obter handle de memória da base de dados
-   [DB\_GetLegacyDBResult](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetLegacyDBResult): Obter handle de memória do resultado
-   [DB\_GetDatabaseConnectionCount](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetDatabaseConnectionCount): Obter número de conexões abertas (debug)
-   [DB\_GetDatabaseResultSetCount](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DB_GetDatabaseResultSetCount): Obter número de resultados abertos (debug)