---
title: "db_next_row | open.mp"
description: "به ردیف بعدی در نتیجه‌ای که از db_query برگردونده شده میره."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/db_next_row
language: fa
---

# db\_next\_row

هشدار

این function در SA-MP 0.3.7 R1 اضافه شده و در نسخه های قبلی کار نخواهد کرد!

## توضیحات

به ردیف بعدی در نتیجه‌ای که از db\_query برگردونده شده میره.

| اسم | توضیح |
| --- | --- |
| DBResult:dbresult | نتیجه‌ای که از db\_query برگردونده شده. |

## مقادیر برگشتی

1: اگه ردیف بعدی موجود باشه و حرکت موفقیت‌آمیز باشه.

0: اگه ردیف بعدی موجود نباشه یا خطا رخ داده باشه.

## مثال‌ها

```c
// انتخاب تمام ردیف‌ها از جدول "players"
new DBResult:db_result = db_query(db_handle, "SELECT * FROM `players`");

// چک کن که آیا کوئری موفق بوده
if (db_num_rows(db_result))
{
    // دریافت و پردازش نتایج
    do
    {
        // کد برای پردازش هر ردیف
        new name[MAX_PLAYER_NAME];
        new score;

        db_get_field_assoc(db_result, "name", name, sizeof(name));
        score = db_get_field_assoc_int(db_result, "score");

        printf("Player: %s, Score: %d", name, score);

    } while (db_next_row(db_result));
}
else
{
    print("No records found.");
}

// آزاد کردن حافظه
db_free_result(db_result);
```

## نکته‌ها

نکته

این تابع معمولاً در یک حلقه do-while استفاده میشه تا تمام ردیف‌های موجود در نتیجه پردازش بشن.

هشدار

نتایج باید بعد از اتمام کار با db\_free\_result آزاد بشن. عدم انجام این کار باعث memory leak میشه.

## تابع‌های مرتبط

-   [db\_open](https://omp.itsneufox.com/fa/docs/scripting/functions/db_open): باز کردن اتصال به پایگاه داده SQLite
-   [db\_close](https://omp.itsneufox.com/fa/docs/scripting/functions/db_close): بستن اتصال به پایگاه داده SQLite
-   [db\_query](https://omp.itsneufox.com/fa/docs/scripting/functions/db_query): کوئری زدن به پایگاه داده SQLite
-   [db\_free\_result](https://omp.itsneufox.com/fa/docs/scripting/functions/db_free_result): آزاد کردن حافظه نتیجه از db\_query
-   [db\_num\_rows](https://omp.itsneufox.com/fa/docs/scripting/functions/db_num_rows): گرفتن تعداد ردیف‌های موجود در نتیجه
-   [db\_num\_fields](https://omp.itsneufox.com/fa/docs/scripting/functions/db_num_fields): گرفتن تعداد فیلدهای موجود در نتیجه