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

بحث واستبدال النص

استبدل fox بـ cat في «The quick brown fox jumps over the lazy dog. The fox is quick.» فيتغير الموضعان: استبدالان تُحصى لك. تُبحث النقاط والأقواس كحروف عادية لا كأنماط. مجانية في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

بحث: fox
استبدال: cat

تحصل على

الكمية: 2
الطول: 62
الطول الأصلي: 62

يحتاج الكتّاب والمحررون وأنابيب الأتمتة باستمرار إلى استبدال عبارة بأخرى عبر كتلة نص دون فتح معالج نصوص كامل أو كتابة سكربت لمرة واحدة. يغطي علم اختياري غير حساس لحالة الأحرف المسودات المختلطة حيث يجب أن يتغيّر The Brand وthe brand معًا. تفشل مصطلحات البحث الفارغة بإدخال غير صالح حتى لا تنفّذ المهام الجماعية no-op صامتًا.

كيف يعمل البحث والاستبدال الحرفي

تفحص الأداة النص كله وتضع النص البديل مكان كل ظهور لعبارة البحث، دون تداخل بين المطابقات. البحث حرفي: النقطة أو القوس في عبارة البحث حرف عادي وليس رمزًا خاصًا، فلا مفاجآت مع الرموز. وإذا تركت النص البديل فارغًا تُحذف كل المطابقات. وتُراعى حالة الأحرف افتراضيًا، ويمكنك تفعيل خيار تجاهلها لتلتقط Hello وHELLO وhello في مرور واحد. وتعرض النتيجة عدد الاستبدالات، ففي المثال تغيّرت fox إلى cat مرتين.

متى تستخدمها ومتى تختار أداة أخرى

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

ما يعنيه البحث والاستبدال ومتى يُستخدم

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

تشمل المصادر النموذجية نصوص تسويق تغيّر فيها اسم منتج، وماكروهات دعم بعناوين URL قديمة، وخلايا CSV برمز قديم، وملاحظات يتكرر فيها خطأ إملائي. يطوي التطابق الاختياري بلا حالة الأحرف حالة الحروف حتى يلتقط مسار واحد Hello وHELLO وhello دون سرد تنويعات. لا تستخدموا هذا المنتج عندما تحتاجون مجموعات التقاط أو lookaround أو محركات regex متعددة الأسطر — تلك نية مختلفة تخدمها أدوات regex مخصصة.

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

تحديثات أسماء العلامات والمنتجات

بدّلوا اسم منتج أو SKU قديمًا بالجديد عبر نصوص تسويق ملصقة وحقول CMS، مع مسار اختياري بلا حالة أحرف للمسودات المختلطة.

تنظيف الرموز في القوالب والماكروهات

احذفوا أو أعيدوا كتابة رموز العناصر النائبة وعناوين URL القديمة في ماكروهات الدعم ومقتطفات البريد والإعداد قبل النشر.

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

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

الاستبدال الاختياري replace هو البديل (افتراضيًا فارغ فيحذف التطابقات). تتضمن الاستجابة result وcount.

ماذا يحدث إذا كان مصطلح البحث فارغًا؟

يُرفض find الفارغ حتى لا تنفّذ الأنابيب no-op صامتًا أو فخ استبدال السلسلة الفارغة في كل مكان؛ ولا تُحاسب تلك الإخفاقات.

هل يمكن التطابق دون الاكتراث بحالة الأحرف؟

يبقى التطابق حرفيًا للأحرف؛ وتُتجاهل حالة الحروف فقط.

هل يدعم find التعبيرات النمطية؟

لا. يُعامل مصطلح البحث دائمًا كسلسلة حرفية. تتطابق النقاط والأقواس وغيرها من أحرف regex الوصفية مع نفسها ليبقى السلوك قابلًا للتنبؤ للمحررين والمهام الجماعية.

كيف أحذف كلمة من النص كله؟

اكتب الكلمة التي تبحث عنها واترك النص البديل فارغًا، فيُحذف كل ظهور لها. وتعرض النتيجة عدد المواضع المحذوفة، فتتأكد من أنه لم يفلت أي موضع.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/find-replace

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

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

curl -X POST https://api.kit.forhosting.com/str/find-replace \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The quick brown fox jumps over the lazy dog. The fox is quick.","find":"fox"}'

const res = await fetch("https://api.kit.forhosting.com/str/find-replace", {
  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. The fox is quick.",
    "find": "fox"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/find-replace",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "The quick brown fox jumps over the lazy dog. The fox is quick.",
    "find": "fox"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/find-replace", 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. The fox is quick.","find":"fox"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"The quick brown fox jumps over the lazy dog. The fox is quick.","find":"fox"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/find-replace", 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. The fox is quick.",
  "find": "fox"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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

تأخذ أداة البحث والاستبدال هذه سلسلة المصدر، ومصطلح بحث غير فارغ، واستبدالًا اختياريًا، ثم تستبدل كل تطابق حرفي وتعيد عقد JSON مستقرًا بالنتيجة وعدد التطابقات وصدى الأصل والمصطلحات المطبّقة. يعمل ودجت المتصفح المجاني على جهازكم؛ وتفرض API المدفوعة مسبقًا $0.002 لكل عنصر ناجح عندما تحتاج الخوادم وSDK نفس التحويل بالجملة.

ما يعنيه البحث والاستبدال ومتى يُستخدم

يرفع مصطلح البحث الفارغ invalid_input، فيحمي المهام الجماعية من فخ استبدال السلسلة الفارغة بين كل حرف.

عقد الإدخال ورفض البحث الفارغ وقراءة الاستجابة

الاستبدال الاختياري replace افتراضيه السلسلة الفارغة فيحذف كل تطابق. استخدموا result وحده عندما تحتاجون السلسلة المنظفة فقط؛ وcount عندما تسجّل أنبوبة كمّ التحرير؛ وoriginal وresult معًا عندما يجب أن تعرض واجهة عرض قبل وبعد. يتبع النص المصدر قواعد الاحتفاظ نفسها لعناصر parse الأخرى في KIT. أرسلوا جسم JSON بالحقل النصي الإلزامي text مضبوطًا على المصدر المراد تحريره والحقل النصي الإلزامي find مضبوطًا على مصطلح بحث غير فارغ. الحالة الاختيارية case_insensitive افتراضيها false للحالة الدقيقة؛ اضبطوها true عندما يجب أن تطابق المسودات المختلطة. تُقبل أسماء بديلة للعملاء الأقدم: text أيضًا كـ input أو value أو s أو content أو source؛ وfind كـ search أو needle أو from أو old؛ وreplace كـ replacement أو with أو to أو new؛ وcase_insensitive كـ ignore_case أو ci أو insensitive. غياب text أو find أو قيمة غير نصية أو find فارغ ترفع invalid_input برسالة تسمّي المشكلة، ولا تُحاسب تلك الإخفاقات على API المدفوعة مسبقًا. عند النجاح تتضمن الاستجابة result بالسلسلة المحرّرة، وtext مساويًا لـ result لراحة الودجت، وoriginal مرددًا الإدخال الدقيق، وfind وreplace كما طُبّقا، وcase_insensitive كقيمة منطقية، وcount كعدد الاستبدالات، وlength وoriginal_length كأطوال أحرف، وmethod دائمًا find_replace. أبقوا الحمولات بأحجام عبارة وفقرة ومستند قصير مناسبة لعزلة Worker لا مقالب متعددة الميغابايت.

استخدام API والتسعير وسير العمل والحدود العملية

استدعوا أداة البحث والاستبدال المجانية في المتصفح لتنظيف اللصق وعروض الصف وتدقيق المحتوى وإعادة التسمية السريعة دون تثبيت أداة سطح مكتب أو كتابة مقتطفات split-join في كل لغة. سير عمل نموذجي يستبدل اسم علامة أو رمز SKU في وصف منتج قبل النشر ثم يتحقق من count لتأكيد تحديث كل إصابة متوقعة. اقرنوا هذه النقطة بأدوات ترتيب المسافات أو محوّلات الحالة عندما تكون الخطوة التالية تنظيف أسلوب، لكن أبقوا البحث والاستبدال هبوطًا خاصًا حتى لا تختلط نية SEO بأدوات المسافات أو slug. لا تتوقعوا إعادة كتابة واعية لـ HTML تتخطى الوسوم، أو حقول دمج مستندات منظمة، أو ترتيبًا خاصًا بالمحليّة يتجاوز التطابق القياسي بلا حالة أحرف — تلك مشاكل منفصلة. استخدموا API KIT المدفوعة مسبقًا عندما يحتاج CMS أو مهمة ETL أو خلفية نموذج أو مكتب دعم أو عميل جوال نفس التحويل تحت الرصيد بمبلغ $0.002 لكل عنصر ناجح؛ وإخفاقات التحقق لا تستهلك الرصيد أبدًا بعد رفض المحرك. وسير آخر يحذف رمزًا مهجورًا بإرسال replace فارغ، أو يطبّع تنويعات الحالة المختلطة بـ case_insensitive true قبل فهرسة البحث. يمكن لمؤلفي SDK توثيق text وfind كحقلين إلزاميين وعرض مثال نجاح متعدد التطابقات ومثال خطأ find فارغ ليرى المكاملون طرفي العقد.

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

QA وfixtures حتمية

تثبّت harnesses الاختبار مخرجات golden للبحث والاستبدال حتى تفشل refactors التي تغيّر قواعد التطابق أو رفض find الفارغ التكامل المستمر فورًا.

أسئلة تقنية

هل أداة البحث واستبدال النص مجانية؟

تعمل أداة المتصفح مجانًا على جهازكم. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل عنصر ناجح؛ ولا تُحاسب إخفاقات التحقق.

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

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

مثال محلول

كيف يعمل البحث والاستبدال الحرفي

متى تستخدمها ومتى تختار أداة أخرى

ما يعنيه البحث والاستبدال ومتى يُستخدم

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

تحديثات أسماء العلامات والمنتجات

تنظيف الرموز في القوالب والماكروهات

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

ما يعنيه البحث والاستبدال ومتى يُستخدم

عقد الإدخال ورفض البحث الفارغ وقراءة الاستجابة

استخدام API والتسعير وسير العمل والحدود العملية

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

QA وfixtures حتمية

أسئلة تقنية

شكرًا