دالة Iter_rows - كتاب المهارات الرقمية - الصف 8 - الفصل 1 - المملكة العربية السعودية

📚 دالة Iter_rows

المفاهيم الأساسية

دالة Iter_rows: تُستخدم للحصول على جميع القيم لصف أو أكثر في ورقة عمل إكسل باستخدام مكتبة `openpyxl`.

خريطة المفاهيم

```markmap

استخدام بايثون مع إكسل

الهدف

أتمتة المهام المتكررة

إجراء العمليات الحسابية المعقدة بشكل أسرع

الأداة: مكتبة أوبن بيكسل (openpyxl)

وظائفها

• قراءة بيانات إكسل
• كتابة بيانات إكسل
• إجراء الحسابات الرياضية
• إنشاء الرسوم والمخططات البيانية

خطوات تثبيتها في PyCharm

• فتح نافذة "Packages" (الحزم)
• البحث عن "openpyxl"
• اختيار المكتبة والضغط على "Install" (تثبيت)
• انتظار رسالة اكتمال التثبيت

الخطوات الأولى بعد التثبيت

استيراد المكتبة

• استخدام الأمر: `import openpyxl`

العمل مع دفاتر العمل

#### تحميل دفتر عمل موجود

• استخدام دالة: `load_workbook()`
• يجب وضع الملف في نفس مجلد الكود أو استخدام المسار المطلق

#### التعرف على أوراق العمل

• استخدام السمة: `sheetnames` لمعرفة أسماء الأوراق

معرفة أبعاد الورقة

سمة الصف الأقصى (max_row attribute)

• تُستخدم لمعرفة عدد الصفوف الموجودة في الورقة

سمة العمود الأقصى (max_column attribute)

• تُستخدم لمعرفة عدد الأعمدة الموجودة في الورقة

الوصول إلى الخلايا

خصائص الخلية الرئيسية

• موقعها في الملف
• قيمتها

طرق الوصول

• الوصول إلى خلية محددة (مثل `sheet_obj["A1"]`)
• الوصول إلى نطاق من الخلايا (مثل `sheet_obj["B1":"B5"]`)

الوصول إلى قيم الخلايا

الوصول إلى قيمة خلية واحدة

• تحديد موقع الخلية (مثال: "C3")
• استدعاء سمة `.value` (مثال: `cell.value`)

الوصول إلى قيمة أكثر من خلية واحدة

• استخدام الدالتان `iter_rows` و `iter_cols`
• لتجنب البحث اليدوي الطويل والمعرض للخطأ

دالة iter_rows

الغرض

• الحصول على جميع القيم لصف أو أكثر في ورقة عمل إكسل

الصيغة

• iter\_rows (min\_row=None, max\_row=None, min\_col=None, max\_col=None)

المعاملات (Parameters)

• `min_row`: فهرس الصف الأول في النطاق
• `max_row`: فهرس الصف الأخير في النطاق
• `min_col`: فهرس العمود الأول في النطاق
• `max_col`: فهرس العمود الأخير في النطاق

ملاحظة

• إذا لم تحدد الفهرس، يبدأ النطاق من الخلية الأولى "A1"

مثال تطبيقي

• للحصول على جميع الحقائق الغذائية للحليب من الصف 3 والأعمدة من 3 إلى 11

```

نقاط مهمة

• تُستخدم `iter_rows` لتكرار (Iterate) عبر صفوف محددة في ورقة إكسل.
• المعاملات `min_row`, `max_row`, `min_col`, `max_col` هي معاملات اختيارية لتحديد نطاق الخلايا المراد الوصول إليها.
• عند عدم تحديد النطاق، تبدأ الدالة من الخلية الأولى (A1).
• للحصول على القيم الفعلية للخلايا، يجب استخدام سمة `.value` لكل خلية داخل الحلقة التكرارية.

دالة Iter_rows

تُستخدم دالة Iter_rows عندما تريد الحصول على جميع القيم لصف أو أكثر في ورقة عمل إكسل.

iter_rows (min_row=None, max_row=None, min_col=None, max_col=None)

إذا لم تحدد الفهرس، فسيبدأ نطاق البحث من الخلية الأولى "A1".

ستُستخدم دالة iter_rows الآن للحصول على جميع الحقائق الغذائية للحليب. عليك الحصول على جميع مواقع الخلايا لصف الحليب، وهو "3D" ثم استدعاء سمة القيمة.

import openpyxl path = "nutrition.xlsx" wb = openpyxl.load_workbook(path) sheet_obj = wb['arabic'] # أنشئ متغير صفوف يحتوي على مواقع حقائق التغذية الخاصة بالحليب rows = sheet_obj.iter_rows(min_row=3, max_row=3, min_col=3, max_col=11) # المتداخلة لطباعة قيمة كل خلية rof الآن استخدم حلقات print("حقائق غذائية عن الحليب: ", end="") for row in rows: for cell in row: print(cell.value, end=" ")

حقائق غذائية عن الحليب: 150 38 0 101 123 5.63 3.25 3.27 61 88.1

وزارة التعليم Ministry of Education 2025 - 1447

177

دالة Iter_rows تُستخدم دالة Iter_rows عندما تريد الحصول على جميع القيم لصف أو أكثر في ورقة عمل إكسل. iter_rows (min_row=None, max_row=None, min_col=None, max_col=None) إذا لم تحدد الفهرس، فسيبدأ نطاق البحث من الخلية الأولى "A1". ستُستخدم دالة iter_rows الآن للحصول على جميع الحقائق الغذائية للحليب. عليك الحصول على جميع مواقع الخلايا لصف الحليب، وهو "3D" ثم استدعاء سمة القيمة. import openpyxl path = "nutrition.xlsx" wb = openpyxl.load_workbook(path) sheet_obj = wb['arabic'] # أنشئ متغير صفوف يحتوي على مواقع حقائق التغذية الخاصة بالحليب rows = sheet_obj.iter_rows(min_row=3, max_row=3, min_col=3, max_col=11) # المتداخلة لطباعة قيمة كل خلية rof الآن استخدم حلقات print("حقائق غذائية عن الحليب: ", end="") for row in rows: for cell in row: print(cell.value, end=" ") حقائق غذائية عن الحليب: 150 38 0 101 123 5.63 3.25 3.27 61 88.1 وزارة التعليم Ministry of Education 2025 - 1447 177 --- VISUAL CONTEXT --- **DIAGRAM**: Untitled Description: A conceptual diagram illustrating the parameters of the `iter_rows` function. A large grey rectangular box contains the text 'iter_rows (min_row=None, max_row=None, min_col=None, max_col=None)'. Two blue oval-shaped boxes are connected to this main box by curved arrows originating from the main box. The left blue oval box is labeled 'فهرس الصف الأصغر والأكبر' (Index of the smallest and largest row) and points to 'min_row' and 'max_row' within the main box. The right blue oval box is labeled 'فهرس العمود الأصغر والأكبر' (Index of the smallest and largest column) and points to 'min_col' and 'max_col' within the main box. This diagram visually explains how to specify row and column ranges for the iter_rows function. Context: This diagram visually explains the optional parameters (min_row, max_row, min_col, max_col) of the iter_rows function, which are used to define the specific range of cells to iterate over in an Excel worksheet.