إضافة بادئة لكل سطر
ضع العلامة نفسها في بداية كل سطر: مع شرطتين مائلتين ومسافة بادئةً، تصبح الأسطر first line وsecond line وthird line ثلاثة أسطر معلَّقة. وعلامة # تعلّق نصوص الطرفية، وعلامة أكبر من تقتبس البريد. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- first line second line third line
- البادئة
- //
- المُدخَل
- first line second line third line
- عدد الأسطر
- 3
- الأسطر
- // first line, // second line, // third line
- مع بادئة
- // first line // second line // third line
تحوّل أداة إضافة بادئة إلى كل سطر لصقًا خامًا من الشيفرة أو نص رسالة أو ملاحظات أو قائمة تحقق إلى كتلة معلَّمة بشكل موحّد يمكنكم وضعها في التذاكر والمراجعات والتوثيق. أدخلوا أي سلسلة غير فارغة من سطر واحد أو عدة أسطر مع البادئة التي تريدونها في بداية كل سطر—من الخيارات الشائعة الشرطة المائلة المزدوجة ومسافة لتعليقات JavaScript، والرمز # ومسافة لتعليقات shell أو Python، وعلامة أكبر-من ومسافة لاقتباسات بأسلوب البريد، أو مسافتان وشرطة للقوائم المزاحَة. توحّد الأداة فواصل Windows وMac الكلاسيكي، وتقسم عند كل فاصل سطر، وتُسبق كل مقطع بالبادئة، بما في ذلك الأسطر الداخلية الفارغة، فتبقى شكل الوثيقة مستقرًا.
كيف تعمل إضافة بادئة إلى كل سطر
تُعد إضافة بادئة إلى الأسطر من أقدم أنماط التحرير الجماعي في البرمجة والكتابة التقنية: يحصل كل سطر مرئي على نفس العلامة الأمامية حتى يمكنكم تعليق كتلة كاملة أو اقتباس رسالة أو تعليم قائمة دون النقر سطرًا بسطر في المحرر. تنفّذ هذه القدرة تلك القاعدة اليومية على النص العادي لا على مستندات النص الغني أو مؤشرات IDE المتعددة. أولًا تُفحص المدخلات: text المفقود أو قيمة غير نصية أو سلسلة فارغة بعد إزالة المسافات تُرفض حتى لا تبدو اللصقات الفارغة نجاحًا.
تُوحَّد الفواصل بحيث يصبح Windows CRLF وMac الكلاسيكي CR وUnix LF شكل LF واحدًا قبل التقسيم. ثم يقسم الفاصل السلسلة عند كل LF؛ كل مقطع ناتج—بما في ذلك المقاطع الفارغة بين فواصل متتالية—هو سطر ويتلقى نفس البادئة في البداية. محتوى داخل كل سطر يبقى دون تغيير: يُعدَّل بداية السطر فقط.
عندما تحتاجون أرقامًا متسلسلة بدل علامة ثابتة استخدموا قدرة ترقيم الأسطر؛ وعندما تحتاجون إزالة المسافات من حواف الأسطر استخدموا أداة تقليم لكل سطر. تقتصر هذه الصفحة على إلحاق سلسلة مختارة ببداية كل سطر من النص العادي.
نصائح عملية وحدود ومتى تستخدمون هذه الأداة
استخدموا هذه القدرة عندما تكون نية البحث إضافة بادئة لكل سطر أو إلحاق نص ببدايات الأسطر أو تعليق كتلة شيفرة أو اقتباس كل سطر من رسالة. الصقوا مقتطف شيفرة واضبطوا prefix على شرطة مائلة مزدوجة ومسافة لتعليقه في ملاحظة مراجعة؛ استخدموا # ومسافة لسكربتات shell؛ استخدموا أكبر-من ومسافة لتحويل رد ملصوق إلى اقتباس كتلي؛ استخدموا مسافتين وشرطة لتحويل أسطر بسيطة إلى علامة قائمة متداخلة. راعوا فواصل النهاية المقصودة: LF نهائي ينشئ مقطعًا أخيرًا فارغًا يتلقى البادئة رغم ذلك، بما يطابق معاملة كثير من المحررات لفواصل نهاية الملف.
الأسطر المفردة الطويلة جدًا ما زالت تُحسب سطرًا واحدًا لكل منها؛ الأداة لا تلف حسب عرض الأحرف. تُسبق مصادر HTML وMarkdown كسلاسل خام؛ أزيلوا العلامات أولًا إن أردتم أسطر نثر مرئية فقط. هذه الصفحة ليست مرقّم أسطر متسلسلًا ولا أداة تقليم لكل سطر ولا محرك بحث واستبدال ولا مؤشر متعدد كامل في IDE.
فضّلوا ترقيم الأسطر عندما يجب على المراجعين الاستشهاد بفهارس دقيقة؛ وفضّلوا التقليم لكل سطر عندما تكون المشكلة مسافات أولية غير منتظمة؛ وفضّلوا هذه القدرة عندما يحتاج كل سطر نفس العلامة الثابتة. عند تعليم أسلوب الشيفرة أضيفوا البادئة لنفس المقتطف مرتين بعلامات مختلفة حتى يرى المتعلمون اختلاف صياغة التعليقات بين اللغات مع بقاء التحويل مستقرًا.
حالات الاستخدام
تعليق كتل الشيفرة
الصقوا مقتطفًا واضبطوا prefix على "// " أو "# " لتحصلوا على كتلة معلَّقة بالكامل جاهزة للتذاكر والمراجعات أو ملاحظات التعطيل المؤقت.
اقتباس ردود البريد والدردشة
أضيفوا "> " في بداية كل سطر لتحويل رسالة ملصوقة إلى اقتباس كلاسيكي بأسلوب البريد للردود والتوثيق.
بناء قوائم معلَّمة أو مزاحَة
أضيفوا " - " أو "* " أو علامة مخصصة إلى أسطر بسيطة لتشارك قوائم التحقق والملاحظات أسلوب قائمة متسقًا.
الأسئلة الشائعة
كيف تُعرَّف الأسطر؟
بعد توحيد CRLF وCR إلى LF يُقسَم النص عند كل LF. كل مقطع—بما في ذلك الفارغ بين فواصل متتالية—يتلقى نفس البادئة في البداية.
هل يمكن أن تكون البادئة فارغة؟
نعم. سلسلة prefix فارغة مسموحة وتعمل كـ no-op بعد توحيد الفواصل. البادئات غير النصية أو المفرطة الحجم (أكثر من 256 حرفًا) تُرفض.
هل تضيف أرقام أسطر متسلسلة؟
لا. تُسبق كل سطر بنفس السلسلة الثابتة. استخدموا أداة ترقيم أسطر عندما تحتاجون تسميات بأسلوب 1. و2. و3.
هل تحصل الأسطر الفارغة على البادئة أيضًا؟
نعم. تُضاف البادئة نفسها إلى الأسطر الفارغة في وسط النص، فيبقى شكل المستند ثابتًا. وإذا انتهى النص بفاصل أسطر، يحصل السطر الفارغ الأخير على البادئة كذلك.
ما البادئات الأكثر استخدامًا؟
شرطتان مائلتان ومسافة لتعليق الشيفرة، وعلامة # ومسافة لنصوص الطرفية وبايثون، وعلامة أكبر من ومسافة لاقتباس البريد، ومسافتان وشرطة لإنشاء قائمة مزاحة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/str/prefix-lines \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"first line\nsecond line\nthird line","prefix":"// "}'const res = await fetch("https://api.kit.forhosting.com/str/prefix-lines", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "first line\nsecond line\nthird line",
"prefix": "// "
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/prefix-lines",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "first line\nsecond line\nthird line",
"prefix": "// "
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/prefix-lines", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"first line\\nsecond line\\nthird line","prefix":"// "}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"first line\nsecond line\nthird line","prefix":"// "}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/prefix-lines", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "first line\nsecond line\nthird line",
"prefix": "// "
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.prefix_lines",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_chars | 100000 |
max_prefix_chars | 256 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
يُرفض النص الفارغ أو المكوّن من مسافات فقط بخطأ واضح invalid_input حتى لا تعامل الأتمتة نموذجًا فارغًا كتحويل ناجح. المسار منطق سلاسل صرف—بلا شبكة ولا بذور عشوائية ولا اعتماد على الساعة—فيعيد منفّذ المتصفح المجاني وواجهة API المدفوعة مسبقًا نفس JSON في كل استدعاء.
كيف تعمل إضافة بادئة إلى كل سطر
حقل prefix مطلوب كسلسلة وقد يكون فارغًا إن أردتم فقط توحيد فواصل الأسطر؛ البادئات غير النصية أو المفرطة الحجم تفشل بـ invalid_input.
كيفية استدعاء API ومحتوى الاستجابة
قد تكون سلسلة prefix فارغة ويجب ألا تتجاوز مئتين وستة وخمسين حرفًا، مما يغطي فواتح تعليقات متعددة الأحرف وعلامات اقتباس Markdown وأنماط مسافة بادئة قصيرة دون السماح بإساءة استخدام متعددة الكيلوبايت. فضّلوا إرسال جسم الوثيقة الخام بفواصل أسطره الحقيقية بدل دمج كل شيء في سطر واحد عندما تريدون بادئات متعددة الأسطر حقيقية. أرسلوا جسم JSON بحقلين نصيين مطلوبين: text (أسماء بديلة input وvalue وstring وs وcontent وbody) وprefix (أسماء بديلة pre وhead وmarker وbullet). يجب أن تكون قيمة text غير فارغة بعد إزالة المسافات وألا تتجاوز مئة ألف حرف حتى لا يستنزف طلب واحد ذاكرة Worker أو المتصفح بلصقات ضخمة. عند النجاح تعيد الاستجابة input كالسلسلة الأصلية المرسلة، وtext كالسلسلة العاملة بعد التقليم، وprefix كالعلامة الفعلية، وline_count كعدد المقاطع ذات البادئة، وlines كمصفوفة مرتبة من سلاسل الأسطر ذات البادئة الكاملة، وprefixed كتلك الأسطر الموصولة بـ LF، وmessage كملخص إنجليزي قصير يبيّن كم سطرًا أُضيفت إليه البادئة وبأي علامة. فشل التحقق—text مفقود أو قيمة غير نصية أو حمولة مفرطة أو محتوى فارغ بعد التقليم أو prefix مفقود أو غير نصي أو prefix طويل جدًا—يعيد invalid_input ولا يُحاسب. التسعير مبلغ ثابت $0.002 لكل طلب ناجح بوحدة item. عند الدمج أكدوا على prefixed أو lines للقائمة الكاملة وعلى line_count للإجمالي، وعاملوا invalid_input كخطأ من العميل في إرسال النماذج الفارغة لا كحدث فوترة.
نصائح عملية وحدود ومتى تستخدمون هذه الأداة
فحوصات الذهاب والإياب للاختبارات سهلة: مرّروا ثلاثة أسطر قصيرة مفصولة بـ LF مع prefix "// " وتوقعوا line_count ثلاثة وكل عنصر في lines يبدأ بتلك العلامة؛ أرسلوا عمدًا سلسلة فارغة أو مسافات لـ text لتأكيد invalid_input والرسالة التي تطلب سلسلة غير فارغة. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المدفوع مسبقًا، مما يبقي التحقق من النماذج واختبارات CI السلبية رخيصة.
أسئلة تقنية
ماذا يحدث عند إدخال فارغ؟
text المفقود أو القيم غير النصية أو السلاسل الفارغة بعد التقليم تعيد invalid_input ولا تُحاسب. prefix المفقود أو غير النصي يفشل في التحقق أيضًا.
هل أداة البادئة مجانية؟
أداة المتصفح مجانية وتعمل محليًا. استدعاءات API تستخدم رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل طلب ناجح؛ المهام الفاشلة لا تُحاسب أبدًا.