پرش به مطلب اصلی

db_num_rows

هشدار

This function starts with a lowercase letter.

هشدار

This function was added in SA-MP 0.3.7 R1 and will not work in earlier versions!

توضیحات

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

اسمتوضیح
DBResult:dbresultنتیجه‌ای که از db_query برگردونده شده.

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

تعداد ردیف‌ها در نتیجه.

مثال‌ها

// انتخاب تمام بازیکنا با امتیاز بیشتر از 1000
new DBResult:db_result = db_query(db_handle, "SELECT * FROM `players` WHERE `score` > 1000");

// چک کن که آیا کوئری موفق بوده
if (db_result)
{
new rows = db_num_rows(db_result);

if (rows > 0)
{
printf("Found %d players with score > 1000", rows);

// پردازش نتایج
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 players found with score > 1000");
}

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

نکته‌ها

نکته

این تابع برای چک کردن اینکه آیا کوئری هیچ نتیجه‌ای برگردونده یا نه مفیده. می‌تونی از این برای اجتناب از اجرای حلقه روی نتایج خالی استفاده کنی.

هشدار

نتایج باید بعد از اتمام کار با db_free_result آزاد بشن. عدم انجام این کار باعث memory leak میشه.

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

  • db_open: باز کردن اتصال به پایگاه داده SQLite
  • db_close: بستن اتصال به پایگاه داده SQLite
  • db_query: کوئری زدن به پایگاه داده SQLite
  • db_free_result: آزاد کردن حافظه نتیجه از db_query
  • db_next_row: رفتن به ردیف بعدی
  • db_num_fields: گرفتن تعداد فیلدهای موجود در نتیجه