default وrequired وquote

تظهر ثلاث دوال في كل chart تقريبًا: default للقيم البديلة، وrequired للقيم الضرورية، وquote للنصوص الآمنة.

توفّر دالة default قيمةً بديلة عندما تكون القيمة فارغة أو مفقودة، حتى لا يعرض القالب قيمة فارغة أبدًا.

عند كتابتها كدالة، تأتي القيمة البديلة أولًا وتأتي القيمة ثانيًا. أما في خط الأنابيب، فتصل القيمة أخيرًا، ولذلك تصبح القراءة طبيعية.

بالنسبة إلى default، تعني القيمة الفارغة 0، أو سلسلة فارغة، أو قائمة فارغة، أو nil. وتؤدي أي من هذه القيم إلى تفعيل القيمة البديلة.

توقف دالة required التصيير وتعرض رسالتكم عندما تكون القيمة مفقودة، فتحوّل الأخطاء الصامتة إلى أخطاء واضحة. ⛔

عندما تكون القيمة موجودة، تعيد required القيمة ببساطة، ولذلك يمكنكم وضعها مباشرةً في أي موضع يُفترض أن يوجد فيه حقل إلزامي.

تذكر رسالة required الجيدة المفتاح المفقود وطريقة تعيينه، حتى يتمكن المستخدمون من إصلاح المشكلة دون قراءة chart.

تضع دالة quote القيمة بين علامتي اقتباس مزدوجتين، فتحمي YAML من القيم التي تبدو كأرقام أو قيم منطقية أو قيم null.

من دون quote، قد تُحلَّل قيمة مثل yes أو 1.20 بوصفها قيمة منطقية أو رقمًا. ويحافظ وضع علامات الاقتباس على كونها سلسلة نصية متوقعة.

يمكن لهذه الدوال أن تتحد في خط أنابيب واحد: وفّروا قيمةً بديلة، ثم ضعوا الناتج بين علامتي اقتباس، وكل ذلك في سطر واحد سهل القراءة.

استخدموا default عندما تكون القيمة اختيارية، وrequired عندما تكون إلزامية. واستخدموا quote كلما كان من الضروري أن تظل السلسلة النصية سلسلةً نصية.

أي دالة توقف التصيير عندما تكون القيمة مفقودة؟

تعرّفتم إلى default للقيم البديلة، وrequired للمدخلات الإلزامية، وquote للنصوص الآمنة. وتجعل هذه الدوال القيم متينة معًا. 🎉