ForHosting KIT · النصوص والذكاء الاصطناعي

ترقيم قائمة بفهارس تبدأ من الصفر أو الواحد

حوّل أحمر وأخضر وأزرق إلى 0: أحمر و1: أخضر و2: أزرق، أو ابدأ من 1 للقرّاء. يبقى الترتيب والعناصر المكررة والفارغة كما هي تمامًا، ولا يُضاف إلا الرقم والفاصل. مجانية في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

العناصر: red, green, blue
أساس الفهرس: 0
الفاصل: :

تحصل على

المعدَّد: 0: red, 1: green, 2: blue
النص: 0: red 1: green 2: blue
الكمية: 3

تحوّل أداة تعداد القائمة مع الفهرس مصفوفة مرتبة من السلاسل إلى تسميات واضحة يسهل الرجوع إليها. تختارون بدء العد من الصفر أو الواحد، وتحددون فاصلًا قصيرًا، فتحصلون على مصفوفة من العناصر المنسقة ونسخة نصية موصولة بفواصل أسطر. يبقى ترتيب العناصر ونصها الأصلي كما هو تمامًا، ولا يضاف سوى الفهرس والفاصل. يفيد ذلك عندما تحتاج الشيفرة أو الوثائق أو ملاحظات المراجعة أو المطالبات أو البيانات المصدرة إلى تسميات ثابتة يمكن للأشخاص والأنظمة الاستشهاد بها بلا التباس.

اختاروا اصطلاح الفهرسة الملائم لجمهوركم

حددوا أولًا ما إذا كان ينبغي أن تحمل التسمية الأولى الرقم صفر أم واحد. تلائم الفهرسة من الصفر النتائج التي ستقارن بمواضع المصفوفات في JavaScript أو Python أو غيرهما من بيئات البرمجة، لأن الرقم الظاهر يطابق الموضع المستخدم في الشيفرة مباشرة. أما الفهرسة من الواحد فعادة ما تكون أوضح لقراء التعليمات وجداول الأعمال وقوائم التحقق والاستبيانات والمراجعات التحريرية.

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

استخدموا فاصلًا يجعل كل تسمية سهلة القراءة

يدرج الفاصل حرفيًا بين الفهرس المحسوب وكل عنصر أصلي. القيمة الافتراضية نقطتان رأسيتان تتبعهما مسافة، فتظهر تسميات مثل <code>0: أحمر</code>. يمكنكم بدلًا من ذلك استعمال نقطة ومسافة للقوائم المرقمة المألوفة، أو قوس إغلاق لخيارات الإجابة المختصرة، أو علامة جدولة لمعالجة الجداول اللاحقة، أو سهم ظاهر عندما تكون النتيجة مخصصة للسجلات.

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

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

ادمجوا النتائج المنظمة والنصية بأمان

تتضمن الاستجابة <code>enumerated</code>، وهي مصفوفة تحتوي سلسلة منسقة لكل عنصر إدخال، و<code>text</code> الذي يجمع السلاسل نفسها بفواصل أسطر. استخدموا المصفوفة عندما سيجري برنامج آخر تحويل العناصر أو ترشيحها أو تسلسلها أو عرضها منفصلة. واستخدموا النص عند كتابة كتلة نص عادي أو إعداد رسالة أو إنشاء قسم في مطالبة أو نسخ النتيجة إلى وثيقة.

تعرض الاستجابة أيضًا العدد وأساس الفهرس والفاصل المختارين، مما يجعل قرار التنسيق صريحًا للتدقيق وتصحيح الأخطاء. يرفض التحقق المصفوفات المفقودة أو الفارغة والعناصر غير النصية والأسس غير المدعومة والأحجام المفرطة.

حالات الاستخدام

إعداد تعليمات سهلة القراءة

أنشئوا خطوات تبدأ من الواحد مع نقطة أو قوس أو نقطتين رأسيتين أو فاصل آخر ملائم.

إنشاء قوائم مراجعة قابلة للإحالة

امنحوا كل ملاحظة أو مقترح تسمية موضعية ثابتة يستطيع المراجعون الاستشهاد بها.

الأسئلة الشائعة

ما الفاصل الافتراضي؟

الفاصل الافتراضي نقطتان رأسيتان تتبعهما مسافة واحدة، فتظهر عناصر مثل 0: مثال.

هل تغير العملية نص العناصر أو ترتيبها؟

لا. تحافظ على كل سلسلة وموضعها، ولا تضيف إلا بادئة الفهرس والفاصل.

أي صيغة إخراج ينبغي استخدامها؟

استخدموا enumerated لمصفوفة منظمة أو text للعناصر نفسها موصولة بفواصل أسطر.

هل أبدأ العد من 0 أم من 1؟

اختر 0 عندما يجب أن تطابق الأرقام المواضع داخل برنامج، لأن معظم لغات البرمجة تعد من الصفر. واختر 1 للتعليمات وجداول الأعمال وقوائم التحقق وخيارات الإجابة، حيث يتوقع القارئ أن يكون العنصر الأول رقم واحد.

ماذا يحدث إذا كان العنصر يبدأ برقم أصلًا؟

يبقى الرقم الموجود كما هو بعد الفهرس الجديد، لأن الأداة لا تفسر نص العناصر. وإذا أردت استبدال الترقيم القديم فاحذفه أولًا ثم رقّم القائمة.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/str/enumerate-with-index

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/str/enumerate-with-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["red","green","blue"]}'

const res = await fetch("https://api.kit.forhosting.com/str/enumerate-with-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "red",
      "green",
      "blue"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/enumerate-with-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "items": [
        "red",
        "green",
        "blue"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/enumerate-with-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"items":["red","green","blue"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["red","green","blue"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/enumerate-with-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "items": [
    "red",
    "green",
    "blue"
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.enumerate_with_index",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_items`	10000
`max_item_chars`	10000
`max_separator_chars`	32

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

العملية حتمية ولا تستخدم الشبكة، وتكلف $0.002 لكل طلب API.

اختاروا اصطلاح الفهرسة الملائم لجمهوركم

اضبطوا <code>index_base</code> على 0 أو 1؛ وترفض القيم الأخرى كي لا تنتج إزاحة عرضية مراجع مضللة.

ادمجوا النتائج المنظمة والنصية بأمان

تنتج مدخلات JSON المتطابقة مخرجات JSON متطابقة دائمًا، بلا أختام زمنية أو عشوائية أو اتصالات بعيدة أو تنسيق أرقام معتمد على المنطقة. في سير العمل الآلي، تعاملوا مع <code>invalid_input</code> كطلب تصحيح، وأصلحوا الحقل المذكور ثم أعيدوا المحاولة. تكلف كل عملية API مبلغ $0.002 مهما كان أساس الفهرس المختار.

حالات التكامل

تسمية الخيارات للشيفرة وواجهات API

أنشئوا تسميات تبدأ من الصفر وتطابق مباشرة مواضع المصفوفة التي يستخدمها منطق التطبيق.

أسئلة تقنية

هل يمكن أن تبدأ الفهرسة من الصفر أو الواحد؟

نعم. اضبطوا index_base على 0 للبدء من الصفر أو على 1 للبدء من الواحد.

كم تبلغ تكلفة الطلب؟

يكلف كل طلب API مبلغ $0.002. ولا يغير أساس الفهرس أو الفاصل السعر.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

اختاروا اصطلاح الفهرسة الملائم لجمهوركم

استخدموا فاصلًا يجعل كل تسمية سهلة القراءة

ادمجوا النتائج المنظمة والنصية بأمان

حالات الاستخدام

إعداد تعليمات سهلة القراءة

إنشاء قوائم مراجعة قابلة للإحالة

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

اختاروا اصطلاح الفهرسة الملائم لجمهوركم

ادمجوا النتائج المنظمة والنصية بأمان

حالات التكامل

تسمية الخيارات للشيفرة وواجهات API

أسئلة تقنية

شكرًا