العوامل المدركة للـ Null

جزء من قسم Object Oriented Programming في رحلة Dart على Coddy — الدرس 27 من 110.

بالإضافة إلى ?. و !، توفر Dart عوامل تشغيل إضافية تجعل العمل مع القيم القابلة للإلغاء (nullable values) أكثر إيجازاً. تساعدك عوامل التشغيل المدركة للقيم الفارغة (null-aware operators) هذه على كتابة كود أكثر نظافة عند التعامل مع القيم الفارغة المحتملة.

يعيد عامل دمج القيم الفارغة (null-coalescing operator) ?? القيمة اليسرى إذا لم تكن فارغة (null)، وإلا فإنه يعيد القيمة اليمنى:

String? nickname;
String displayName = nickname ?? 'Guest';
print(displayName);  // Guest

nickname = 'Alex';
displayName = nickname ?? 'Guest';
print(displayName);  // Alex

يقوم معامل التعيين المدرك للقيمة الخالية (null-aware assignment operator) ??= بتعيين قيمة فقط إذا كان المتغير حالياً null:

String? username;
username ??= 'Anonymous';
print(username);  // Anonymous

username ??= 'NewName';
print(username);  // Still Anonymous (wasn't null)

يمكنك ربط عامل الوصول المدرك للقيم الفارغة (null-aware access operator) ?. للخصائص المتداخلة:

String? city = user?.address?.city;  // آمن حتى لو كان user أو address قيمته null

تندمج هذه العمليات معاً بشكل جيد. على سبيل المثال، قد تصل إلى خاصية قابلة للإلغاء (nullable) وتوفر قيمة افتراضية:

String greeting = user?.name ?? 'Stranger';
// إذا كان user فارغاً (null) أو user.name فارغاً، استخدم 'Stranger'

استخدام هذه العوامل يحافظ على قابلية قراءة الكود الخاص بك مع الحفاظ على سلامة القيم الفارغة (null safety) في جميع أنحاء برنامجك.

التحدي

سهل

لنقم ببناء نظام تسجيل ضيوف يوضح كيف يمكن للمعاملات المدركة للقيم الفارغة (null-aware operators) أن تجعل كودك أكثر نظافة عند التعامل مع المعلومات الاختيارية.

ستقوم بتنظيم الكود الخاص بك في ملفين:

guest.dart: قم بتعريف فئة Guest التي تمثل شخصاً يحضر فعالية ما. يقدم بعض الضيوف تفاصيل كاملة، بينما يقدم آخرون الأساسيات فقط. يجب أن تحتوي الفئة الخاصة بك على:
- متغير String name غير قابل للقيمة الفارغة - يجب أن يكون لكل ضيف اسم
- متغير String? email قابل للقيمة الفارغة - لا يقدم الجميع بريداً إلكترونياً
- متغير String? dietaryPreference قابل للقيمة الفارغة - بعض الضيوف لا يحددون احتياجات غذائية
- مشد (constructor) يأخذ name كمعامل مطلوب
- دالة getDisplayEmail() تعيد البريد الإلكتروني إذا كان متاحاً، أو 'No email provided' باستخدام معامل ??
- دالة assignDefaultDiet() تقوم بتعيين dietaryPreference إلى 'Standard' فقط إذا كانت قيمته الحالية فارغة (null)، باستخدام معامل ??=
- دالة getEmailDomain() تعيد طول البريد الإلكتروني باستخدام ?.، أو null إذا لم يكن هناك بريد إلكتروني
- دالة printBadge() تقوم بطباعة معلومات بطاقة التعريف الخاصة بالضيف
main.dart: قم باستيراد فئة الضيف الخاصة بك وسجل ثلاثة ضيوف بمستويات متفاوتة من المعلومات:
- أنشئ ضيفاً باسم 'Alice'، وقم بتعيين بريدها الإلكتروني إلى 'alice@company.com' وتفضيلها الغذائي إلى 'Vegetarian'
- أنشئ ضيفاً باسم 'Bob'، وقم بتعيين بريده الإلكتروني فقط إلى 'bob@email.org' (اترك التفضيل الغذائي فارغاً null)
- أنشئ ضيفاً باسم 'Charlie' (اترك كلاً من البريد الإلكتروني والتفضيل الغذائي فارغاً null)
- استدعِ assignDefaultDiet() لجميع الضيوف الثلاثة
- لكل ضيف بالترتيب، استدعِ printBadge()، ثم اطبع Email length: [result] باستخدام getEmailDomain()

يجب أن تقوم دالة printBadge() بالطباعة بهذا التنسيق:

=== Guest Badge ===
Name: [name]
Email: [getDisplayEmail()]
Diet: [dietaryPreference or "Not specified"]

لاحظ كيف يظل التفضيل الغذائي لـ Alice هو 'Vegetarian' لأن ??= يقوم بالتعيين فقط عندما تكون القيمة فارغة، بينما يحصل Bob و Charlie على النظام الغذائي الافتراضي 'Standard'.

المخرجات المتوقعة:

=== Guest Badge ===
Name: Alice
Email: alice@company.com
Diet: Vegetarian
Email length: 17
=== Guest Badge ===
Name: Bob
Email: bob@email.org
Diet: Standard
Email length: 13
=== Guest Badge ===
Name: Charlie
Email: No email provided
Diet: Standard
Email length: null

ورقة مرجعية

توفر لغة Dart عوامل تشغيل تراعي القيم الفارغة (null-aware operators) للتعامل مع القيم التي قد تكون فارغة بشكل أكثر إيجازاً.

يقوم عامل دمج القيم الفارغة (null-coalescing operator) ?? بإرجاع القيمة اليسرى إذا لم تكن فارغة، وإلا فإنه يرجع القيمة اليمنى:

String? nickname;
String displayName = nickname ?? 'Guest';
print(displayName);  // Guest

nickname = 'Alex';
displayName = nickname ?? 'Guest';
print(displayName);  // Alex

يقوم عامل التعيين الذي يراعي القيم الفارغة (null-aware assignment operator) ??= بتعيين قيمة فقط إذا كانت المتغير فارغاً حالياً:

String? username;
username ??= 'Anonymous';
print(username);  // Anonymous

username ??= 'NewName';
print(username);  // Still Anonymous (wasn't null)

يمكنك ربط عامل الوصول الذي يراعي القيم الفارغة (null-aware access operator) ?. للخصائص المتداخلة:

String? city = user?.address?.city;  // Safe even if user or address is null

يمكن دمج عوامل التشغيل هذه معاً:

String greeting = user?.name ?? 'Stranger';
// If user is null OR user.name is null, use 'Stranger'

جرّب بنفسك

import 'guest.dart';

void main() {
  // TODO: قم بإنشاء ضيف باسم 'Alice'
  // قم بتعيين بريدها الإلكتروني إلى 'alice@company.com'
  // قم بتعيين تفضيلاتها الغذائية إلى 'Vegetarian'

  // TODO: قم بإنشاء ضيف باسم 'Bob'
  // قم بتعيين بريده الإلكتروني فقط إلى 'bob@email.org'
  // اترك التفضيلات الغذائية كـ null

  // TODO: قم بإنشاء ضيف باسم 'Charlie'
  // اترك كل من البريد الإلكتروني والتفضيلات الغذائية كـ null

  // TODO: قم باستدعاء assignDefaultDiet() لجميع الضيوف الثلاثة

  // TODO: لكل ضيف بالترتيب (Alice، Bob، Charlie):
  // - قم باستدعاء printBadge()
  // - قم بطباعة 'Email length: [result]' باستخدام getEmailDomain()
}