تحليل سلاسل أرقام الصفحات في C#: دليل شامل

عند العمل مع تطبيقات البرمجيات، وخاصة تلك التي تتضمن الطباعة أو المحتوى المقسم إلى صفحات، قد تواجه الحاجة إلى تحليل أرقام الصفحات من مدخلات المستخدم. قد يكون تنسيق الإدخال الشائع عبارة عن مزيج من أرقام الصفحات المفصولة بفواصل أو شرطات، مثل “1,3,5-10,12”. تكمن الصعوبة في تحويل هذه السلسلة إلى قائمة بأرقام الصفحات الفردية، وهو ما يفضل العديد من المطورين التعامل معه تلقائيًا بدلاً من إنشاء حل مخصص من الصفر.

المشكلة: تحليل سلاسل أرقام الصفحات

قد تتساءل: هل تحتوي C# على دعم مدمج لتحليل سلاسل أرقام الصفحات؟ الإجابة هي أنه على الرغم من أن C# لا تحتوي على دالة مدمجة مخصصة لهذه المهمة بالذات، إلا أنها توفر أدوات تسمح لنا بإنشاء حل فعال. الهدف العام هو أخذ سلسلة من أرقام الصفحات وإخراج قائمة كاملة من تلك الأرقام الفردية، مع توسيع أي نطاقات يتم الإشارة إليها بالشرطة (على سبيل المثال، يجب أن يتم توسيع “5-10” إلى “5,6,7,8,9,10”).

الحل: تنفيذ محلل مخصص

تحليل خطوة بخطوة

لتحقيق هدفنا، يمكننا استخدام مزيج من معالجة السلاسل ومجموعات C#. يصف الإطار أدناه العملية:

1. تقسيم السلسلة: ابدأ بتقسيم السلسلة المدخلة عند كل فاصلة لتقسيمها إلى مكونات فردية. قد تكون كل مكون إما رقمًا منفردًا أو مجموعة من الأرقام.
2. تحليل الأرقام: استخدم int.TryParse() لتحديد ما إذا كان المقطع هو عدد صحيح فردي.
3. التعامل مع النطاقات: إذا كان المقطع يحتوي على شرطة (على سبيل المثال، “5-10”)، قم بتقسيم المقطع لاحقًا لاستخراج أرقام البداية والنهاية. تحقق من أن البداية أقل من أو تساوي النهاية.
4. إنشاء النطاق: استخدم طريقة Enumerable.Range() لإنشاء جميع القيم الصحيحة ضمن النطاق المحدد.
5. تقديم النتائج: أخيرًا، قم بإرجاع جميع الأرقام المحللة إلى المستدعي للاستخدام الإضافي.

مثال على الكود

إليك تنفيذ عينة يلخص المنطق أعلاه في C#:

foreach (string s في "1,3,5-10,12".Split(',')) 
{
    // محاولة لتحليل أرقام الصفحات الفردية
    int num;
    if (int.TryParse(s, out num)) 
    {
        yield return num; // إرجاع الرقم الفردي
        continue; // الانتقال إلى التكرار التالي
    }

    // خلاف ذلك التعامل مع النطاق
    string[] subs = s.Split('-');
    int start, end;

    // تحليل البداية والنهاية للنطاق
    if (subs.Length > 1 &&
        int.TryParse(subs[0], out start) &&
        int.TryParse(subs[1], out end) && 
        end >= start) 
    {
        // إنشاء نطاق من الأرقام من البداية إلى النهاية
        int rangeLength = end - start + 1;
        foreach (int i في Enumerable.Range(start, rangeLength)) 
        {
            yield return i; // إرجاع كل رقم في النطاق
        }
    }
}

شرح الكود

• تقسيم الإدخال: نستخدم طريقة .Split(',') لتقسيم السلسلة المدخلة إلى قطع قابلة للإدارة.
• تحليل الأرقام: استخدام int.TryParse() يسمح لنا بالتحقق بشكل آمن مما إذا كان يمكن تحويل مقطع من السلسلة إلى عدد صحيح دون إثارة استثناء.
• التعامل مع النطاقات: بالنسبة للمقاطع التي تحتوي على شرطة، نقوم بالتحقق والتقسيم لاستخراج نقاط البداية والنهاية.
• تقديم القيم: تسمح عبارة yield للطريقة بإرجاع القيم واحدة تلو الأخرى، مما يجعلها أكثر كفاءة في الاستدعاءات للمحلل.

الخاتمة

قد يبدو تحليل سلاسل أرقام الصفحات في C# مروعًا في البداية، لكن باستخدام النهج الصحيح، يمكن أن يصبح الأمر مباشرًا وفعالًا. من خلال الاستفادة من معالجة السلاسل والهيكليات الأساسية في C#، يمكنك التعامل مع مجموعة متنوعة من تنسيقات الإدخال دون إعادة اختراع العجلة. تتيح لك هذه الطريقة توسيع وتكييف حلك لحالات أكثر تعقيدًا في حال الحاجة.

للتلخيص، بدلاً من البحث عن ميزة مدمجة، يمكنك بثقة إنشاء دالة مخصصة تلبي احتياجاتك - مما يجعل الكود لديك أكثر نظافة وعملية التطوير أكثر سلاسة.

لا تتردد في تعديل هذا النهج لمشروعاتك ومشاركة تجربتك في التعليقات أدناه!