string remove first

شفرة المصدر الأخرى

1.0.0

تنزيل

حول ستليب...

نحن نؤمن بمستقبل يكون فيه الويب بيئة مفضلة للحسابات الرقمية. للمساعدة في تحقيق هذا المستقبل، قمنا ببناء stdlib. stdlib هي مكتبة قياسية، مع التركيز على الحساب العددي والعلمي، مكتوبة بلغة JavaScript (و C) للتنفيذ في المتصفحات وفي Node.js.

المكتبة قابلة للتحلل بالكامل، حيث تم تصميمها بحيث يمكنك تبديل واجهات برمجة التطبيقات والوظائف ومزجها ومطابقتها لتلبية تفضيلاتك وحالات الاستخدام المحددة.

عند استخدام stdlib، يمكنك التأكد تمامًا من أنك تستخدم التعليمات البرمجية الأكثر دقة وصرامة وكتابة جيدة ودراسة وتوثيقًا واختبارها وقياسها وعالية الجودة.

للانضمام إلينا في جلب الحوسبة الرقمية إلى الويب، ابدأ بمراجعتنا على GitHub، ويرجى التفكير في دعم stdlib ماليًا. نحن نقدر بشدة دعمكم المستمر!

RemoveFirst

حالة البناء

قم بإزالة الحرف (الأحرف) الأول من السلسلة.

تثبيت

npm install @stdlib/string-remove-first

بدلاً عن ذلك،

لتحميل الحزمة في موقع ويب عبر علامة script بدون التثبيت والمجمعات، استخدم وحدة ES المتوفرة في فرع esm (راجع الملف التمهيدي).
إذا كنت تستخدم Deno، قم بزيارة فرع deno (راجع الملف التمهيدي للحصول على تعليمات الاستخدام).
للاستخدام في بيئات Observable، أو في بيئات المتصفح/العقدة، استخدم إصدار Universal Module Definition (UMD) المتوفر في فرع umd (راجع README).
لاستخدامها كأداة مساعدة عامة لسطر الأوامر، قم بتثبيت حزمة واجهة سطر الأوامر (CLI) المقابلة عالميًا.

يلخص ملف Branchs.md الفروع المتوفرة ويعرض رسمًا تخطيطيًا يوضح العلاقات بينها.

لعرض تعليمات التثبيت والاستخدام الخاصة بكل إصدار فرعي، تأكد من الانتقال بشكل صريح إلى ملفات README الخاصة بكل فرع، كما هو مرتبط أعلاه.

الاستخدام

 var removeFirst = require ( '@stdlib/string-remove-first' ) ;

RemoveFirst( str[, n][, options] )

يزيل الحرف (الأحرف) الأول من string .

 var out = removeFirst ( 'last man standing' ) ;
// returns 'ast man standing'

out = removeFirst ( 'Hidden Treasures' ) ;
// returns 'idden Treasures'

تدعم الوظيفة الخيارات التالية:

الوضع : نوع الأحرف المراد إرجاعها. يجب أن يكون واحدًا مما يلي:
- 'grapheme' : مجموعات grapheme. مناسب للسلاسل التي تحتوي على أحرف مرئية يمكن أن تمتد إلى عدة نقاط رمز Unicode (على سبيل المثال، الرموز التعبيرية).
- 'code_point' : نقاط كود Unicode. مناسب للسلاسل التي تحتوي على أحرف مرئية تتكون من أكثر من وحدة ترميز Unicode (على سبيل المثال، الرموز الإيديوغرافية وعلامات الترقيم والأبجدية الرقمية الرياضية).
- 'code_unit' : وحدات كود UTF-16. مناسب للسلاسل التي تحتوي على حروف مرئية مستمدة من المستوى الأساسي متعدد اللغات (BMP) (على سبيل المثال، الحروف الشائعة، مثل الحروف الهجائية اللاتينية واليونانية والسيريلية).
الافتراضي: 'grapheme' .

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

 var out = removeFirst ( 'foo bar' , 4 ) ;
// returns 'bar'

out = removeFirst ( 'foo bar' , 10 ) ;
// returns ''

ملحوظات

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

أمثلة

 var removeFirst = require ( '@stdlib/string-remove-first' ) ;

var str = removeFirst ( 'last man standing' ) ;
// returns 'ast man standing'

str = removeFirst ( 'presidential election' ) ;
// returns 'residential election'

str = removeFirst ( 'JavaScript' ) ;
// returns 'avaScript'

str = removeFirst ( 'Hidden Treasures' ) ;
// returns 'idden Treasures'

str = removeFirst ( 'The Last of the Mohicans' , 4 ) ;
// returns 'Last of the Mohicans'

str = removeFirst ( '?????' , 2 ) ;
// returns '???'

str = removeFirst ( '?????' , 10 ) ;
// returns ''

سطر الأوامر

تثبيت

لاستخدامها كأداة مساعدة عامة، قم بتثبيت حزمة واجهة سطر الأوامر (CLI) بشكل عام

npm install -g @stdlib/string-remove-first-cli

الاستخدام

 Usage: remove-first [options] [<string>]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
         --n                   Number of characters to remove. Default: 1.
         --split sep           Delimiter for stdin data. Default: '/\r?\n/'.
         --mode mode           Type of character to return. Default: 'grapheme'.

ملحوظات

إذا كان فاصل الانقسام تعبيرًا عاديًا، فتأكد من أن خيار split إما تم تهريبه بشكل صحيح أو وضعه بين علامتي اقتباس.
```
 # Not escaped...
$ echo -n $' beep n boop ' | remove-first --split / r ? n /

# Escaped...
$ echo -n $' beep n boop ' | remove-first --split / \ r ? \ n/
```
يتجاهل التنفيذ المحددات الزائدة.

أمثلة

$ remove-first beep
eep

لاستخدامه كدفق قياسي،

$ echo -n ' beepnboop ' | remove-first --n=2
be
bo

افتراضيًا، عند استخدامه كتدفق قياسي، يفترض التنفيذ بيانات محددة بسطر جديد. لتحديد محدد بديل، قم بتعيين خيار split .

$ echo -n ' beeptboop ' | remove-first --split ' t '
eep
oop

انظر أيضا

@stdlib/string-remove-last : إزالة الحرف (الحروف) الأخيرة من السلسلة.

يلاحظ

هذه الحزمة جزء من مكتبة stdlib القياسية لـ JavaScript وNode.js، مع التركيز على الحوسبة الرقمية والعلمية. توفر المكتبة مجموعة من المكتبات القوية وعالية الأداء للرياضيات والإحصاء والتدفقات والمرافق والمزيد.

لمزيد من المعلومات حول المشروع، وتقديم تقارير الأخطاء وطلبات الميزات، والإرشادات حول كيفية تطوير stdlib، راجع مستودع المشروع الرئيسي.