تدفقات السلاسل النصية في C++: التحليل والبناء باستخدام stringstream

تدفق يعيش داخل سلسلة نصية

أنت تعرف بالفعل cin و cout - تدفقان موصولان بلوحة المفاتيح والشاشة. تدفق السلسلة النصية هو الفكرة نفسها، إلا أن البيانات تعيش بدلاً من ذلك في std::string داخل الذاكرة. تكتب إليه بـ << وتسحب منه القيم بـ >>، تماماً مثل تدفقات الطرفية، لكن لا شيء يمسّ الطرفية.

تحل هذه الفكرة الواحدة مشكلتين يوميتين: تحليل النص وتفكيكه إلى قيم ذات أنواع، وبناء سلسلة نصية منسّقة من أجزاء مختلطة. كل شيء يعيش في الترويسة <sstream> ويأتي في ثلاثة أنواع:

• istringstream - للقراءة فقط، لتحليل المدخلات.
• ostringstream - للكتابة فقط، لبناء المخرجات.
• stringstream - في كلا الاتجاهين.

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    stringstream ss;
    ss << "score: " << 42 << ", level: " << 7;

    cout << ss.str() << "\n";   // اسحب المخزن المؤقت بأكمله مجدداً كسلسلة نصية
}

يعيد ss.str() كل ما كُتب حتى الآن كـ string عادية. أجرى مشغّلو << التنسيق نفسه من int إلى نص الذي يفعله cout - أنت فقط التقطت النتيجة بدلاً من طباعتها.

التحليل: استخراج قيم ذات أنواع

تظهر القوة الحقيقية مع >>. أعطِ تدفقاً بعض النص، ويقوم الاستخراج بتحويل كل رمز إلى النوع الذي تطلبه، متجاوزاً المسافات بينها. هذه هي الطريقة النظيفة لتقسيم سطر واحد إلى عدة حقول ذات أنواع:

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    string line = "Ada 36 5.5";
    istringstream iss(line);

    string name;
    int age;
    double rating;
    iss >> name >> age >> rating;   // كل >> يلتقط الرمز التالي المفصول بمسافة

    cout << name << " is " << age << " (rated " << rating << ")\n";
}

يقرأ كل >> حتى المسافة التالية ويحوّل: "Ada" إلى string، و"36" إلى int، و"5.5" إلى double. لاحظ istringstream هنا - النوع المخصص للإدخال فقط يوضّح أنك تقوم بالتحليل لا غير.

تحويل السلاسل النصية إلى أرقام (بأمان)

من المهام المتكررة تحويل سلسلة نصية واحدة مثل "42" إلى int. يفعل stringstream ذلك، ويخبرك أيضاً بما إذا كان النص رقماً صالحاً فعلاً - وهو ما لا يفعله atoi أبداً:

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    string text = "123abc";

    stringstream ss(text);
    int value;
    if (ss >> value) {
        cout << "Parsed: " << value << "\n";
    } else {
        cout << "Not a valid number\n";
    }

    cout << "Got " << value << " from \"" << text << "\"\n";
}

هنا يقرأ ss >> value القيمة 123، ويتوقف عند a، وينجح - لذا تحقّق دائماً من السلسلة النصية بأكملها إن كان ذلك مهماً. يتمثل الفحص المتين في قراءة الرقم ثم التأكد من عدم بقاء أي شيء ذي معنى. للتحويلات البسيطة ذات القيمة الواحدة، فإن std::stoi و std::stod وأمثالها (مشروحة مع تحويل الأنواع) أقصر؛ لجأ إلى stringstream عندما تحمل سلسلة نصية واحدة عدة قيم مختلطة.

تقسيم سلسلة نصية حسب فاصل

يُعد تقسيم النص أكثر مهام تدفق السلاسل النصية بحثاً على Google. اجمع بين تدفق وstd::getline، الذي يمكنه القراءة حتى أي محرف فاصل، لا سطر جديد فحسب:

#include <iostream>
#include <sstream>
#include <string>
#include <vector>
using namespace std;

int main() {
    string csv = "red,green,blue,yellow";
    stringstream ss(csv);

    vector<string> parts;
    string token;
    while (getline(ss, token, ',')) {   // الوسيط الثالث هو الفاصل
        parts.push_back(token);
    }

    for (const string& p : parts) cout << "[" << p << "] ";
    cout << "\n";
}

يكرّر نمط while (getline(...)) حتى ينفد التدفق، لأن getline يعيد التدفق، ويُقيَّم التدفق على أنه false بمجرد ألا يبقى شيء. احذف الوسيط الثالث فتقسم بدلاً من ذلك حسب الرموز المفصولة بمسافات باستخدام >> - اختر الفاصل الذي تستخدمه بياناتك.

بناء السلاسل النصية في الذاكرة

في الاتجاه الآخر، يجمّع ostringstream سلسلة نصية منسّقة دون خطر تجاوز المخزن المؤقت الذي في sprintf ولا الدمج اليدوي الهش. وهو مثالي لأسطر السجلات أو أسماء الملفات أو الرسائل المؤلّفة من أرقام ونص:

#include <iostream>
#include <iomanip>
#include <sstream>
#include <string>
using namespace std;

int main() {
    int day = 5, month = 6, year = 2026;

    ostringstream oss;
    oss << year << "-"
        << setw(2) << setfill('0') << month << "-"
        << setw(2) << setfill('0') << day;

    string filename = "backup_" + oss.str() + ".zip";
    cout << filename << "\n";   // backup_2026-06-05.zip
}

كل تنسيق <iomanip> الذي قد تستخدمه مع cout - setw و setfill و setprecision و hex - يعمل بالطريقة نفسها على تدفق السلسلة النصية، فتحصل على مخرجات محشوّة أو ذات عرض ثابت أو ست عشرية مُلتقطة مباشرة في string.

المطبّ: أعد الضبط قبل إعادة الاستخدام

الفخ الذي يقع فيه الجميع هو إعادة استخدام تدفق دون إعادة ضبطه. بمجرد أن يبلغ التدفق نهاية بياناته، تنغلق رايتاه eof و fail، وكل >> لاحق لا يفعل شيئاً بصمت - لا خطأ، بل قيم قديمة فحسب:

stringstream ss("10");
int a, b;
ss >> a;            // a = 10، التدفق الآن عند النهاية -> رُفعت راية eof
ss.str("20");       // حمّل نصاً جديداً...
ss >> b;            // يفشل بصمت - رايات الخطأ لا تزال مرفوعة، و b دون تغيير

يجب أن تمسح حالة الخطأ و المحتوى معاً. الترتيب الصحيح هو clear() أولاً، ثم str():

#include <iostream>
#include <sstream>
using namespace std;

int main() {
    stringstream ss("10");
    int a, b;
    ss >> a;

    ss.clear();      // أعد ضبط رايتي eof/fail
    ss.str("20");    // استبدل المخزن المؤقت
    ss >> b;

    cout << a << " " << b << "\n";   // 10 20
}

خطآن متصلان: يعيد ss.clear() ضبط الرايات لكنه لا يفرّغ المخزن المؤقت (استخدم ss.str("") لذلك)، وstringstream الذي تواصل الإضافة إليه بـ << سيستمر في النمو - أنشئ واحداً جديداً داخل الحلقة بدلاً من إعادة استخدام واحد متّسخ في كل تكرار.

التالي: المصفوفات

أعطتك تدفقات السلاسل النصية وسيلة نظيفة لتحويل النص إلى قيم ذات أنواع والعودة مجدداً - غالباً قائمة كاملة منها، مثل الـ vector الذي ملأته أثناء تقسيم CSV. لتخزين وفهرسة مجموعات ثابتة من تلك القيم، تحتاج إلى أبسط حاوية في اللغة. سنتناول بعد ذلك المصفوفات: كيفية الإعلان عنها، وفهرستها، والمرور عليها بالحلقات، وتفادي الوصول خارج الحدود الذي يسبّب الكثير من السلوك غير المعرَّف في C++.