اقتطاع النص
بحد أقصى 20 يصبح النص The quick brown fox jumps over the lazy dog هو The quick brown f...، أي 20 محرفًا بالضبط مع النقاط. أما النص الذي يتسع أصلًا فيعود دون تغيير. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- The quick brown fox jumps over the lazy dog
- الطول
- 20
- الإدخال
- The quick brown fox jumps over the lazy dog
- النص
- The quick brown f...
- الطول الأصلي
- 43
- طول النتيجة
- 20
أداة اقتطاع النص تقصّر سلسلة نصية إلى حد أقصى لطول العرض وتضيف علامة حذف عندما لا يتسع النص الأصلي. أدخل النص العادي والطول الصحيح الذي تريد أن تلتزم به النتيجة؛ وتعيد الأداة السلسلة المقصورة وما إذا طبّق الاقتطاع وطولي الأصل والنتيجة ورسالة موجزة. ويمكنك اختياريا تفعيل وضع حدود الكلمات بحيث يفضّل القطع عند آخر مسافة قبل الحد بدلا من شطر كلمة في منتصفها. المعاينات وخلايا الجداول وعناوين البطاقات ومقتطفات SEO وفقاعات الدردشة ونصوص الإشعارات كلها تحتاج إلى قاعدة الطول الصارمة نفسها دون فتح محرر كامل أو استدعاء نموذج إعادة صياغة.
ماذا يعني الاقتطاع مع علامة الحذف مقارنة بإعادة الصياغة أو التنظيف
الاقتطاع قيد عرض صارم: يحتفظ ببادئة من السلسلة المصدر، وعندما يكون المصدر أطول من الطول المسموح يعلّم الحذف بلاحقة علامة حذف. وهذا يختلف عن تنظيف المسافات الزائدة الذي يزيل الحواف فقط، ويختلف عن التقصير بالذكاء الاصطناعي الذي يعيد كتابة المعنى في كلمات أقل. هنا الحد الأقصى للطول هو طول النتيجة بأكملها بما في ذلك علامة الحذف عند الحاجة إلى القطع.
إذا كان نصك يتسع أصلا، تعيد الأداة النص دون تغيير وتضبط truncated على false حتى يتجاوز المستدعون عناصر الواجهة التي توحي بوجود محتوى مخفي. الأطوال الأقل من واحد غير مقبولة أبدا: فمعاينة بعرض صفري ليست عقدا مفيدا للبطاقات أو الجداول أو الإشعارات، والحدود السالبة دائما أخطاء في العميل. النص الفارغ مع طول صالح مسموح به ويُعاد فارغا دون علامة حذف، مما يمنع تعطل خطوط المعالجة التي تمرر حقولا اختيارية لمجرد أن العنوان فارغ.
حالات الاستخدام
عناوين البطاقات ومعاينات خلايا الجداول
قصّ أسماء المنتجات وصفوف القوائم إلى ميزانية أحرف ثابتة مع علامة حذف مرئية حتى تبقى الواجهات الكثيفة متناسقة دون تجاوز في التخطيط.
اختبارات وحدة لمنسقات العرض
ولّد اقتطاعات صارمة ومرنة معروفة الصحة مع رفض الأطوال الأقل من واحد لمساعدات الواجهة الأمامية وخطوط معاينة CMS.
الأسئلة الشائعة
هل يشمل الطول علامة الحذف؟
نعم. عند تطبيق الاقتطاع لا يتجاوز طول السلسلة المعادة length حرفا بما في ذلك لاحقة علامة الحذف. وإذا كان الأصل يتسع أصلا فإنه يعاد دون تغيير ودون إضافة علامة حذف.
ماذا يحدث إذا كان الطول صفرا أو سالبا؟
يجب أن يكون الطول عددا صحيحا لا يقل عن واحد؛ والحدود الأقل من واحد مرفوضة ولا تحتسب أبدا.
هل هذا مثل التقصير بالذكاء الاصطناعي؟
لا. هذه القدرة قطع بادئة حتمي مع علامة حذف ولا تعيد كتابة المعنى. استخدم أداة تقصير بنموذج لغوي عندما تحتاج إعادة صياغة مضغوطة بدلا من قيد عرض صارم.
هل يمكن تجنب قطع الكلمة في منتصفها؟
نعم. فعّل خيار حدود الكلمات فيتراجع القطع إلى آخر مسافة قبل الحد، لتنتهي النتيجة بكلمة كاملة. وإن لم توجد مسافة يُقطع النص عند الحد نفسه.
هل يمكن استخدام نهاية غير النقاط الثلاث؟
نعم، يمكنك اختيار علامة حذف خاصة بك. وهي تُحسب ضمن الطول الأقصى ولا يجوز أن تكون أطول منه، وإلا رُفض الاقتطاع بدل اختلاق علامة مبتورة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/str/truncate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"The quick brown fox jumps over the lazy dog","length":20}'const res = await fetch("https://api.kit.forhosting.com/str/truncate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "The quick brown fox jumps over the lazy dog",
"length": 20
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/truncate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "The quick brown fox jumps over the lazy dog",
"length": 20
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/truncate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"The quick brown fox jumps over the lazy dog","length":20}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"The quick brown fox jumps over the lazy dog","length":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/truncate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "The quick brown fox jumps over the lazy dog",
"length": 20
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.truncate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_chars | 100000 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
أي طول أقل من واحد يرفض بخطأ invalid_input واضح حتى لا تتعامل عمليات التحقق من النماذج وCI مع سقف صفري أو سالب على أنه نجاح. المسار منطق نصي حتمي خالص — لا شبكة ولا بذور عشوائية ولا اعتماد على التوقيت — لذا تُرجع أداة المتصفح المجانية وواجهة API المدفوعة مسبقا JSON نفسه في كل مرة تستدعيها فيها.
ماذا يعني الاقتطاع مع علامة الحذف مقارنة بإعادة الصياغة أو التنظيف
وإذا لم يتسع، يحسب الحلال ميزانية محتوى تساوي الطول مطروحا منه طول علامة الحذف، ويأخذ بادئة ضمن تلك الميزانية، ويتراجع اختياريا إلى آخر مسافة عندما تكون word_boundary مساوية true، ويزيل المسافات الطرفية من البادئة المحتفظ بها حتى لا تقف علامة الحذف بعد فجوة معلقة، ثم يلحق علامة الحذف. الحتمية مقصودة: النص والطول وراية word_boundary وسلسلة علامة الحذف نفسها تنتج دائما result_length نفسه وراية truncated نفسها والرسالة نفسها، مما يجعل الاختبارات الذهبية وفحوص Worker متعدد المناطق مقابل المتصفح موثوقة.
كيفية استدعاء API وماذا تحتوي الاستجابة
أرسل جسم JSON يتضمن text المطلوب (بأسماء بديلة input وvalue وstring وs وcontent وbody) وlength المطلوب (بأسماء بديلة max_length وmax وn وlimit وmax_len). يجب أن يكون الطول عددا صحيحا من واحد إلى مئة ألف شاملا؛ والقيم الأقل من واحد وغير الصحيحة والحدود المتجاوزة للحجم تعد invalid_input. الحقل الاختياري word_boundary (بأسماء بديلة word وsoft وon_word) افتراضه false ويقبل true أو false. الحقل الاختياري ellipsis (بأسماء بديلة suffix وending وmarker) افتراضه ثلاث نقاط ASCII وقد يكون أي سلسلة حتى اثنين وثلاثين حرفا؛ وعندما يلزم الاقتطاع يجب ألا تكون علامة الحذف أطول من length وإلا فشل الطلب بدلا من اختلاق علامة مقصوصة. يجب أن يبقى النص ضمن مئة ألف حرف حتى لا يستنزف طلب واحد ذاكرة Worker أو المتصفح. عند النجاح تعيد الاستجابة input كسلسلة أصلية وtext كسلسلة نهائية للعرض وlength كحد أقصى مطلوب وoriginal_length وresult_length كعددي أحرف وtruncated كقيمة منطقية وword_boundary كالراية التي أرسلتها (أو الافتراضي) وellipsis كلاحقة مستخدمة وused_word_boundary عند تطبيق قطع مرن وmessage كملخص إنجليزي موجز. فشل التحقق — غياب text أو length أو نص غير نصي أو طول غير صحيح أو أقل من واحد أو حمولة متضخمة أو علامة حذف لا تتسع ضمن الحد عند الحاجة للقطع — يعيد invalid_input ولا يحتسب أبدا. التسعير ثابت $0.002 لكل طلب ناجح بوحدة item وسعر وحدة هامشي صفري.
نصائح عملية وحدود وعمليات بحث ذات صلة
استخدم هذه القدرة عندما يكون قصد البحث اقتطاع نص أو إضافة علامة حذف عند حد أقصى للطول أو قطع مرن عند حدود الكلمات عبر الإنترنت. علامات الحذف المخصصة مثل حرف علامة الحذف الأفقية الأحادي في Unicode أو وسم more بين قوسين تعمل ما دام طولها ضمن الميزانية. هذه الصفحة ليست ملخصا بالذكاء الاصطناعي ولا عداد فقرات أو كلمات ولا محول حالة أحرف للعناوين ولا منظفا لحواف الأسطر فقط. فحوص الذهاب والإياب للاختبارات سهلة: مرر جملة طويلة بطول عشرين وتوقع truncated مساوية true وresult_length لا يتجاوز عشرين؛ وفعّل word_boundary على عبارة متعددة الكلمات وتوقع ألا يقع آخر حرف محتفظ به داخل كلمة عند وجود مسافة سابقة؛ وأرسل طولا صفريا أو صحيحا سالبا وتوقع invalid_input يذكر طولا أقل من واحد. فضّل القطع الصارم عندما تحتاج شبكة أحرف ثابتة مثل سجلات monospace؛ وفضّل word_boundary للعناوين والمعاينات الموجهة للبشر حيث تبدو القطوع في منتصف الكلمة مشوهة. فضّل text.shorten عندما تحتاج ضغطا يحفظ المعنى ضمن ميزانية كلمات باستخدام نموذج لغوي؛ وفضّل str.trim_lines عندما تحتاج فقط تنظيف المسافات سطرا بسطر؛ وفضّل هذه القدرة عندما قرر المنتج أصلا حدا أقصى صارما لطول العرض ويجب إظهار بادئة أمينة. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المدفوع مسبقا، مما يبقي التحقق من النماذج واختبارات CI السلبية رخيصة. وعند تدريب المراجعين، اعرض الجملة نفسها في الوضعين الصارم والمرن ليروا أن موضع القطع وراية used_word_boundary فقط يتغيران بينما تبقى قاعدة علامة الحذف ثابتة.
حالات التكامل
حدود مقتطفات الإشعارات والدردشة
قصّر رسائل الدفع الصادرة والرسائل داخل التطبيق إلى سقوف أطوال المنصات مع تجنب اختياري للقطع في منتصف الكلمة في وضع word_boundary.
أسئلة تقنية
ماذا يفعل word_boundary؟
عندما تكون true يفضّل القطع عند آخر مسافة قبل ميزانية المحتوى حتى لا تشطر الكلمات في منتصفها. وإذا لم توجد مسافة مناسبة يرجع إلى قطع صارم بالأحرف.
هل أداة اقتطاع النص مجانية؟
أداة المتصفح مجانية وتعمل محليا. أما استدعاءات API فتستخدم رصيد KIT المدفوع مسبقا بمقدار $0.002 لكل طلب ناجح؛ والمهام الفاشلة لا تحتسب أبدا.