خبير التداول على الأخبار(محاولة)

وكما قلنا سيهذب البرنامج للبحث عن الدالة InitNews

ونعلم عدد معطياتها على انها ثلاثة وان نوع المعطى الاول نص string ولكن مصفوفة ثنائية البعد 1000 في 10 (جدول من 1000 سطر و 10 اعمدة)
والمعطى الثاني عدد صحيح int قيمته 2 حسب البرنامج حتى الان - وتعني عدل ساعتين
والمعطى الثالث نص string وقيمته رابط الموقع ديلي فوركس

l string news_url = "http://www.dailyfx.com/files/"; l

passing parameters --- تمرير المعطيات الى الدالة الخارجية حيث تنتقل بنفس الترتيب الى الدالة التي نريدها ولكن ربما تحت مسميات مختلفة ولكن القيم نفسها لا تتغير

فوجدنا دالة InitNews

حيث وصل خط سير البرنامج الى هذه الدالة هنا
لاحظ المعطيات اسماء مختلفة عنها في دالة الاستدعاء ولكن تحمل نفس القيم ونفس النوع
حيث أن المتغير الاول هنا مصفوفة نصية string من بعدين ( 1000 في 10 ) وهي news - حيث انتقلت بنفس الاسم ولكن معها علامة امبرساند & --- ماذا تعني هذه العلامة؟ هنا
والمتغير timeZone - المعطى الثاني اسفل عدد صحيح int كما يفترض وهو نفسه time_zone_gmt السابق
والمتغير الاخير نصي string اسمه newsUrl هو نفسه المتغير السابق news_url ويأخذ نفس قيمته التي كانت رابط الموقع

علامة امبرساند تعني انه مخرجات وليس معطيات - يعني قيمة سنحسب قيمتها
امبرساند = &

فتلك المصفوفة او الجدول باسم news - جدول فارغ سنملأه بالقيم (الاخبار - مثل العملة ذات العلاقة بالخبر وعنوان الخبر وتوقيت الخبر والمتوقع والقراءة الحقيقة الماضية وربما الحالية)

ارجو وضوح هذا الأمر - لانه من أعقد الاجزاء في هذا البرنامج

وكما ذكرنا
timeZone=time_zone_gmt=2
newsUrl=news_url="http://www.dailyfx.com/files/" l

تلك الدالة كما يظهر يوجد فيها 3 جمل برمجية - حسب الالوان اسفل

جملة شرطية اولى if وفيها ايضا دالتين خارجيتين سيتم استدعائها وهما: DoFileDownLoad و DownLoadWebPageToFile

وجملة شرطية اخرى if وبدورها فيها دالة خارجية باسم CsvNewsFileToArray

واخيرا دالة خارجية سيتم استدعائها NormalizeNewsData

يعني هناك اربع دوال خارجية في هذا البرنامج - سيتم استدعائها جميعاً

الدالة الاولى DoFileDownLoad هي الشرط للدالة الثانية DownLoadWebPageToFile والمعنى هو:
ان دالة DoFileDownLoad تفحص اذا صيغة الاكسل المقفل CSV موجودة في موقع كالندر الاخبار ام لا؟
اذا موجودة يذهب للدالة DownLoadWebPageToFile وهي خاصة بتحميل الاخبار من الموقع للتشارت ثم يحدث تاريخ اخر تحديث للبيانات من خلال السطر:
L lastUpdate=TimeCurrent(); L

اذا لم يوجد ملف CSV - يفشل التحميل

وايضا هنا ممكن الاستغناء عن دالة DoFileDownLoad إذا كنا متأكدين سلفا من وجود ملف الاكسل CSV

DoFileDownLoad دالة منطقية - اي ان نوعها bool
وبالتالي تاخذ قيمتين امام صح او خطأ -- true or false

متى نريدها صحيحة؟
لاحظ اسم الدالة DoFileDownLoad - ونترجمها الى - هل تريد تحميل الملف؟
وبالتالي يجب ثم يجب ثم يجب ان تكون قيمتها نعم - نعم نريد تحميل الملف - يعني قيمتها لابد تكون trueفي حالتين
1) اذا الملف غير موجود اساسا - وبالتالي نريد تحميله -
2) وقت التحديث كل ربع ساعة

غير ذلك يجب ثم يجب ان تكون قيمتها لا - لانريد تحميل الملف --- يعني false (اذا كان الملف اساسا موجود ولم تأتي لحظة التحديث - مثلا الدقيقة 13 عند اخر تحديث)


return تعني برمجيا توقف وعد من حيث اتيت
فمثلا لو تحققت return الاولى هنا(الملف موجود ووقت التحديث الآن) لايكمل بقية اسطر الدالة - بل يعود للدالة التي خرجنا منها InitNews بقيمة true -- وتعني نعم حدث البيانات الآن.

ولو تحققت return الثانية - لان الاولى لم تتحقق (وتعني الملف موجود ولكن لم يحن وقت التحديث) تتوقف وهذه الدالة ويعود للدالة السابقة بقيمة false - يعني لا نريد التحميل او التحديث

واذا فشلت يذهب الى return الثالثة وقيمتها true اجبارية - لان الملف غير موجود ولابد من تحميله.


يوجد دالة مهمة داخل هذه الدالة هي ......

لاشك أنكم عرفتم ان هذه الدالة هي: NewsFileName لأنه لايوجد دالة اخرى غيرها داخل الدالة الخارجية هنا.

هذه الدالة تحديدا هي اسم الملف - او بالأحرى مخصصة لاسم الملف؟
وظيفتها: إجابة السؤال: ماهو اسم الملف على موقع الانترنت الذي سنقرأ منه الأخبار! ؟
بعبارة أخرى: ماهو رابط الاخبار! ؟ أو ماهو الموقع! ؟

يعني واستدعاء آخر لدالة أخرى

لاحظ الشربكة!!!

كل شي مشربك!

بطبيعة الحال لابد تكون دالة نصية - اي نوع string - لان قيمته ااسم ملف - او اسم رابط - على شاكلة www yahoo com -- فكما ترى انها نصوص وليست ارقام او تواريخ او الوان!!