اكتب دالتك: FUNCTION وقيمة الإرجاع

المشكلة: نفس المعادلة في عشرين مكان

في محطة فيها عشرون مرسلاً تناظرياً، تكرر هذا السطر عشرين مرة بأرقام مختلفة:

Flow := (RawFlow - 4.0) / 16.0 * 250.0;
Pres := (RawPres - 4.0) / 16.0 * 10.0;

وفي أحدها تكتب 16.0 مكان 4.0 بالخطأ، فيخرج القياس غلطاً وتبحث عنه ثلاثة أيام. الحل أن تكتب المعادلة مرة واحدة في دالة.

الإعلان

FUNCTION Scale4to20 : REAL
VAR_INPUT
  Raw    : REAL;   (* 4.0 .. 20.0 mA *)
  EngLo  : REAL;
  EngHi  : REAL;
END_VAR

Scale4to20 := EngLo + (Raw - 4.0) / 16.0 * (EngHi - EngLo);

END_FUNCTION

لاحظ ثلاثة أشياء:

1. النوع بعد الاسم: FUNCTION Scale4to20 : REAL يعني أن الدالة ترجع REAL.
2. المداخل في VAR_INPUT: تُقرأ ولا تُكتب.
3. الإرجاع بإسناد إلى اسم الدالة نفسه: Scale4to20 := .... هذه هي صياغة المعيار، ولا وجود لكلمة return.

الاستخدام

Flow := Scale4to20(RawFlow, 0.0, 250.0);
Pres := Scale4to20(RawPres, 0.0, 10.0);
Temp := Scale4to20(RawTemp, -50.0, 200.0);

أو بالأسماء، وهو أوضح عند المراجعة:

Flow := Scale4to20(Raw := RawFlow, EngLo := 0.0, EngHi := 250.0);

النقاء: لا ذاكرة ولا آثار

الدالة نقية (Pure): نفس المداخل تعطي نفس المخرج دائماً، ولا تتذكر شيئاً بين النداءات. وهذا يعني:

• لا تعلن مؤقتاً ولا عدّاداً داخلها. TON يحتاج ذاكرة، فمكانه FUNCTION_BLOCK.
• متغيرات VAR المحلية داخل الدالة قيمتها غير محددة في بداية كل نداء. لا تبنِ عليها.
• لا تكتب على متغير عام من داخل الدالة. تقنياً تستطيع في بعض المنصات، لكنها عادة سيئة تجعل نتيجة الدالة تعتمد على تاريخ البرنامج.

متى تحتاج FUNCTION_BLOCK بدلها؟ عندما يكون الجواب على سؤال «هل تحتاج تذكّر شيء من الدورة السابقة؟» نعم.

دوال تستحق الكتابة

• Scale4to20 و ScaleRaw: تحجيم القياسات.
• DeadbandPct: نطاق ميت حول قيمة مرجعية.
• CelsiusToF، BarToPsi: تحويل وحدات.
• ClampPct: حصر قيمة بين 0 و 100 مع تسجيل التجاوز.

كل واحدة منها تُراجع مرة، تُختبر مرة، وتصح في كل مكان بعدها.

لا يعمل في المختبر

مختبر هذا الموقع ينفّذ PROGRAM واحداً ولا يدعم إعلان FUNCTION. أمثلة الدوال أعلاه كود للقراءة لا للتشغيل، أما برنامج المختبر أدناه فيكتب نفس المعادلة مباشرة داخل البرنامج لترى النتيجة تتحرك.