ورقة Python المرجعية
مرجع Python 3 قابل للبحث والطباعة — البنية وهياكل البيانات وعبارات الاستيعاب والدوال والأصناف والملفات والمكتبة القياسية. مجاني.
المتغيرات والأنواع
10x = 1
تعيين متغير (نوع ديناميكي)
x: int = 1
تعليق نوع اختياري
a, b = 1, 2
تعيين متعدد
type(x)
الحصول على نوع قيمة
int('42')
تحويل سلسلة إلى عدد صحيح
str(42)
تحويل قيمة إلى سلسلة نصية
isinstance(x, int)
فحص النوع
None
قيمة العدم / الغياب
x = y = 0
تعيين متسلسل
PI: Final = 3.14
تلميح ثابت (typing.Final)
السلاسل النصية
11f'Hello {name}'
إدراج بـ f-string
len(s)
طول السلسلة
s.upper()
تحويل إلى أحرف كبيرة
s.strip()
إزالة المسافات المحيطة
s.split(',')
التقسيم إلى قائمة
','.join(items)
ربط قائمة بفاصل
s.replace('a', 'b')
استبدال سلاسل فرعية
'a' in s
اختبار العضوية
s[1:4]
تقطيع الأحرف من 1 إلى 3
s[::-1]
عكس سلسلة
s.startswith('a')
التحقق من البادئة
القوائم و tuples
10a = [1, 2, 3]
إنشاء قائمة
a.append(4)
إضافة عنصر للنهاية
a.insert(0, x)
الإدراج عند فهرس
a.pop()
إزالة وإرجاع آخر عنصر
a[1:3]
تقطيع قائمة فرعية
sorted(a, reverse=True)
إرجاع نسخة مفروزة
a.sort(key=len)
الفرز في المكان بمفتاح
len(a)
عدد العناصر
t = (1, 2)
tuple غير قابل للتغيير
first, *rest = a
التفكيك بنجمة
القواميس والمجموعات
10d = {'k': 'v'}
إنشاء قاموس
d['k']
الوصول لقيمة بمفتاح
d.get('k', default)
الحصول بقيمة احتياطية
d.keys() / d.values()
عرض المفاتيح أو القيم
d.items()
المرور على أزواج key/value
{**a, **b}
دمج القواميس
a | b
معامل اتحاد القاموس/المجموعة
del d['k']
إزالة مفتاح
s = {1, 2, 3}
إنشاء مجموعة (قيم فريدة)
set(a) & set(b)
تقاطع المجموعات
الفهومات (Comprehensions)
8[x * 2 for x in a]
فهم قائمة
[x for x in a if x > 0]
فهم مُصفّى
{x: x**2 for x in a}
فهم قاموس
{x for x in a}
فهم مجموعة
(x for x in a)
تعبير مولّد (كسول)
[y for row in m for y in row]
التسطيح بحلقات متداخلة
[a if c else b for x in items]
قيمة شرطية في الفهم
sum(x for x in a)
تجميع مولّد
التحكم في التدفق
9if x > 0:\n ...
شرطي (المسافة البادئة مهمة)
elif / else:
فروع إضافية
a if cond else b
تعبير ثلاثي
for x in range(10):
التكرار على نطاق
for i, x in enumerate(a):
التكرار مع فهرس
for a, b in zip(x, y):
التكرار على iterables معاً
while cond:
التكرار طالما true
break / continue
الخروج أو تخطي تكرار
match x:\n case 1: ...
مطابقة نمط بنيوية (3.10+)
الدوال
8def f(a, b=1): return a + b
دالة بوسيطة افتراضية
def f(*args, **kwargs):
وسائط موضعية ومفتاحية متغيرة
f(name='Sam')
الاستدعاء بوسيطة مفتاحية
lambda x: x + 1
دالة مجهولة مضمنة
def f(a: int) -> int:
تلميحات نوع للمعاملات والإرجاع
@decorator
تغليف دالة بمُزخرف
yield value
إنتاج قيمة من مولّد
global x / nonlocal x
إعادة ربط متغير خارجي النطاق
الأصناف
9class A(Base):
صنف بوراثة
def __init__(self, x):
المُنشئ / المُهيِّئ
self.x = x
سمة كائن
def __str__(self):
تمثيل نصي
@property
سمة محسوبة للقراءة فقط
@staticmethod / @classmethod
دوال ثابتة ودوال الصنف
super().__init__()
استدعاء مُهيِّئ الأصل
@dataclass
توليد init/repr/eq تلقائياً
isinstance(obj, A)
فحص نوع الكائن
الملفات والأخطاء والوحدات
9with open('f.txt') as fh:
فتح ملف (يُغلق تلقائياً)
fh.read() / fh.readlines()
قراءة محتوى ملف
open('f.txt', 'w').write(s)
الكتابة إلى ملف
try:\n ...\nexcept ValueError as e:
التقاط استثناء محدد
raise ValueError('bad')
إثارة استثناء
finally:
كتلة تنظيف تعمل دائماً
import os
استيراد وحدة
from math import sqrt
استيراد اسم محدد
import numpy as np
الاستيراد باسم مستعار
لا يوجد إدخال يطابق “:q”.
هل تحتاج إلى مساعدة؟
هل واجهت مشكلة في هذه الأداة؟ أخبر فريقنا.