حزمة مساعدة للأرقام العربية

السلام عليكم

اسم الحزمة: حزمة مساعدة للأرقام العربية arabic number utility
إصدارة الحزمة: v1.0
فكرة الحزمة:
الجافا تعتبر الأرقام خارج موضوع locality
بمعنى آخر لا تكتب الأرقام بالطريقة العربية
(أقصد الأرقام الهندية و الصفر فيها على شكل نقطة
بينما الأرقام العربية الصفر فيها على شكل دائرة)
طبعاً البعض سيقول هذا شيء جيد
لأنها تعيد لنا أرقامنا العربية
المشكلة أن الكثير من الفئات في المجتمع تعتبر العكس
عدا عن أن هناك فئة مثل الأطفال لا تعرف الأرقام العربية الحقيقية
وعندما تبرمج برنامج موجه للأطفال فيه أرقام
مثل عملية الضرب والجمع والطرح وهكذا
فأنت بحاجة إلى الأرقام الهندية حتى يستطيع الطفل الفهم

قصة الحزمة:
هذه الحزمة ليست خاصة بي
أقصد أن الفكرة ليست خاصة بي
الفكرة للأخ محمد فتحي من منتديات الفريق العربي للبرمجة
دوري في الموضوع التعديل على الحزمة لكي تضم بعض الدوال المساعدة
تعديل الحزمة لكي تصبح آمنة للخيوط thread safe

ملاحظة بسيطة:
(سأعبر في كل كلامي عن الأرقام عربية الأًصل بالأرقام الإنجليزية
وعن الأرقام هندية الأًصل بالأرقام العربية تلافياً للالتباس)

محتويات الحزمة:
1- تحتوي الحزمة على ثوابت تمثل الأرقام العربية
في الترميز الموحد unicode من 0 إلى 9

2- تحتوي الحزمة على دالة convertEnglishToArabic
وتقوم بالتحويل الرقم الإنجليزي المدخل على هيئة String إلى الرقم العربي
على هيئة String
هذه الدالة تتميز عن الفئة java.awt.font.NumericShaper
في أنها تقوم بتحويل . إلى ,
طبعاً الأمر واضح أن الأرقام العربية تحتوي على الصفر كنقطة لذا للتمييز بين الفاصلة
والرقم صفر نستخدم الفاصلة ذات اللفة

3- تحتوي الحزمة على الدالة convertDoubleToArabic
وهي مسؤولة عن تحويل الأرقام بالصيغة double إلى الأرقام العربية بالصيغة string

الدالتين 2 و 3 تستخدمان في العرض وبدونهم تظهر الأرقام الإنجليزية على الشاشة

4- تحتوي الحزمة على الدالة convertArabicToEnglish
وتقوم بتحويل الأرقام العربية إلى الأرقام الإنجليزية

5- تحتوي الحزمة على الدالة convertArabicToDouble
وتقوم بالعملية العكسية بحيث تقوم بتحويل الأرقام العربية الموجودة في String
إلى أرقام إنجليزية ووضعها في متغير من النوع double

الدالة 4 يمكن الاستفادة منها عند القيام بإنشاء برامج متعددة اللغات
للتغيير من لغة إلى لغة يفضل تحويل الأرقام بين اللغات
الدالة 5 يمكن الاستفادة منها عند الحاجة لإجراء العمليات على الأرقام الموجودة
بالصيغة العربية حيث لا يمكنك تحويلها مباشرة باستخدام Douple.parseDpuble

6- تحتوي الحزمة على الدالة isArabicDigit
والتي تساعدك في التأكد من أن الحرف هو رقم عربي
7- تحتوي الحزمة على الدالة isIntegerArabicNumber
والتي تساعدك في التأكد من أن العدد عدد عربي صحيح
8- تحتوي الحزمة على الدالة isDoubleArabicNumber
والتي تساعدك في التأكد من أن العدد عدد عربي عشري
أمثلة على العدد العشري المقبول
عدد بدون فاصلة
عدد ثم فاصلة ثم عدد
فاصلة ثم عدد
أمثلة غير مقبولة
فاصلة لوحدها
جملة String لا تحتوي على شيء
أي حروف
عدد ثم فاصلة بدون عدد بعد الفاصلة

تحميل الحزمة:
arabicNumbers-code (189)
arabicNumbers-jar (166)

أية اقتراحات أو استفسارات أرحب بكم على مدونتي
أو على موقع الفريق العربي للبرمجة
أو حتى على بريدي الإلكتروني
أحب أن أشكر الأخ المتميز محمد فتحي
الذي سمح لي بنشر الحزمة على مدونتي
وأتمنى من الله أن يوفقه لما فيه خير الدنيا و الآخرة

معلومات عن مطوور الحزمة:
م.علاء محمد الصالحي
خريج الجامعة الإسلامية بغزة
أعمل كمطور نظم في الجامعة الإسلامية بغزة

تحياتي

6 Responses to “حزمة مساعدة للأرقام العربية”

  1. محمد فتحى قال:

    حزمة جميلة ومفيدة جدا أخ علاء

    وأشكرك على ذكر اسمى فى الموضوع

    للامام دائما

  2. admin قال:

    أنا من يتوجب عليه شكرك يا محمد
    أتمنى لك التوفيق دائماً

  3. سامح محمود قال:

    الف شكرا يا معلمين على الكلاس الرائعة
    بالتوفيق .

  4. admin قال:

    منور يا سامح
    الحمد لله أنك استفدت منها :)

    تحياتي

  5. مشكور اخي علاء , ودمت في تقدم ورقي , ننتظر منك كل ما هو جديد ومُبدَع

  6. admin قال:

    هذه الحزمة ليست خاصة بي
    أقصد أن الفكرة ليست خاصة بي
    الفكرة للأخ محمد فتحي من منتديات الفريق العربي للبرمجة
    دوري في الموضوع التعديل على الحزمة لكي تضم بعض الدوال المساعدة
    تعديل الحزمة لكي تصبح آمنة للخيوط thread safe

    تحياتي

Leave a Reply