الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

مكتبة لمعالجة سلسلة PHP مع دعم متعدد البايت. متوافق مع PHP 5.4+، PHP 7+، وHHVM.

 s('string')->toTitleCase()->ensureRight('y') == 'Stringy'

راجع الفرع 1.x أو الفرع 2.x للحصول على الوثائق الأقدم.

  • لماذا؟

  • تثبيت

  • OO والتسلسل

  • الواجهات المنفذة

  • إنشاء PHP 5.6

  • StaticStringy

  • أساليب الطبقة

    • يخلق

  • طرق المثيل

إلحاق في بين com.camelize
حرف انهيار وايت سبيس يتضمن يحتوي على الكل
يحتوي علىأي countSubstr Dasherize تحديد
ينتهي مع ينتهي مع أي تأكد من اليسار ضمان الحق
أولاً getEncoding hasLowerCase hasUpperCase
htmlDecode htmlEncode أنسنة مؤشر
indexOfLast إدراج isAlpha هو أبجدي رقمي
isBase64 isBlank isHexadecimal isJson
isLowerCase isSerialized isUpperCase آخر
طول خطوط longCommonPrefix longCommonSuffix
longCommonSubstring LowerCaseFirst وسادة com.padBoth
PadLeft com.padRight إضافة مسبقة regexReplace
RemoveLeft RemoveRight يكرر يستبدل
يعكس SafeTruncate خلط slugify
شريحة ينقسم يبدأ مع يبدأ مع أي
stripWhitespace substr تحيط SwapCase
مرتب عنوان toAscii toBoolean
toLowerCase toSpaces toTabs toTitleCase
toUpperCase تقليم TrimLeft TrimRight
اقتطاع وأكد UpperCamelize UpperCaseFirst

  • ملحقات

  • الاختبارات

  • رخصة

لماذا؟

ويرجع ذلك جزئيًا إلى نقص دعم البايتات المتعددة (بما في ذلك UTF-8) عبر العديد من وظائف السلسلة القياسية في PHP. ولكن أيضًا لتقديم غلاف OO حول الوظائف المتوافقة مع وحدات mbstring متعددة البايت. يتعامل Stringy مع بعض المراوغات، ويوفر وظائف إضافية، ونأمل أن يجعل التعامل مع السلاسل أسهل قليلًا!

 // مكتبة قياسيةstrtoupper('fòôbàř');       // 'FòôBàř'strlen('fòôbàř');           // 10// mbstringmb_strtoupper('fòôbàř');    // 'FÒÔBÀŘ'mb_strlen('fòôbàř');        // '6'// Stringys('fòôbàř')->toUpperCase(); // 'FÒÔBÀŘ's('fòôbàř')->length();      // '6'

تثبيت

إذا كنت تستخدم Composer لإدارة التبعيات، فيمكنك تضمين ما يلي في ملف Composer.json الخاص بك:

 "يتطلب": {"danielstjules/stringy": "~3.1.0"}

وبعد ذلك، بعد تشغيل composer update أو php composer.phar update ، يمكنك تحميل الفصل باستخدام التحميل التلقائي للملحن:

 يتطلب "بائع/autoload.php"؛

بخلاف ذلك، يمكنك ببساطة طلب الملف مباشرة:

 require_once 'المسار/إلى/Stringy/src/Stringy.php'؛

وفي كلتا الحالتين، أقترح استخدام اسم مستعار.

 استخدم StringyStringy كـ S؛

يرجى ملاحظة أن Stringy يعتمد على وحدة mbstring لدعمها الأساسي متعدد البايت. إذا لم يتم العثور على الوحدة، فسوف يستخدم Stringy Symfony/polyfill-mbstring. ex-mbstring هي وحدة غير افتراضية، ولكنها شائعة جدًا. على سبيل المثال، مع debian وubuntu، يتم تضمينه في libapache2-mod-php5، وphp5-cli، وphp5-fpm. بالنسبة لمستخدمي OSX، يعد هذا الإعداد افتراضيًا لأي إصدار PHP مثبت مع homebrew. إذا كنت تقوم بتجميع PHP من البداية، فيمكن تضمينه مع علامة --enable-mbstring .

OO والتسلسل

توفر المكتبة تسلسل طريقة OO، كما هو موضح أدناه:

 استخدم StringyStringy كـ S;echo S::create('fòô bàř')->collapseWhitespace()->swapCase(); // 'FÒÔ BÀŘ'

لدى StringyStringy طريقة __toString()، والتي تُرجع السلسلة الحالية عند استخدام الكائن في سياق سلسلة، على سبيل المثال: (string) S::create('foo') // 'foo'

الواجهات المنفذة

تطبق StringyStringy واجهة IteratorAggregate ، مما يعني أنه يمكن استخدام foreach مع مثيل للفئة:

 $stringy = S::create('fòôbàř');foreach ($stringy as $char) {echo $char;
}// 'فوبار'

يقوم بتنفيذ واجهة Countable ، مما يتيح استخدام count() لاسترداد عدد الأحرف في السلسلة:

 $stringy = S::create('fòô');count($stringy);  // 3

علاوة على ذلك، تم تنفيذ واجهة ArrayAccess . ونتيجة لذلك، يمكن استخدام isset() للتحقق من وجود حرف في فهرس معين. وبما أن StringyStringy غير قابل للتغيير، فإن أي استدعاء لـ offsetSet أو offsetUnset سيؤدي إلى حدوث استثناء. ومع ذلك، فقد تم تنفيذ offsetGet ، وهو يقبل الفهارس الموجبة والسالبة. تؤدي الفهارس غير الصالحة إلى OutOfBoundsException .

 $stringy = S::create('bàř');echo $stringy[2];     // 'ř'echo $stringy[-2];    // 'à'isset($stringy[-4]);  // false$stringy[3];          // OutOfBoundsException$stringy[2] = 'a';    // استثناء

إنشاء PHP 5.6

اعتبارًا من PHP 5.6، أصبحت use function متاحة لاستيراد الوظائف. يعرض Stringy دالة ذات مساحة اسم، Stringycreate ، والتي تصدر نفس السلوك مثل StringyStringy::create() . إذا كنت تستخدم PHP 5.6، أو وقت تشغيل آخر يدعم بناء جملة use function ، فيمكنك الاستفادة من واجهة برمجة التطبيقات الأكثر بساطة كما هو موضح أدناه:

 استخدم الوظيفة Stringycreate as s;// بدلاً من: S::create('fòô bàř')s('fòô bàř')->collapseWhitespace()->swapCase();

StaticStringy

تتوفر كافة الأساليب المدرجة ضمن "طرق المثيل" كجزء من برنامج تضمين ثابت. بالنسبة إلى أساليب StaticStringy، من المتوقع أن يكون الترميز الاختياري هو الوسيطة الأخيرة. لم يتم تحويل القيمة المرجعة، وبالتالي قد تكون من النوع Stringy، أو عدد صحيح، أو منطقي، وما إلى ذلك.

 استخدم StringyStaticStringy كـ S;// يترجم إلى Stringy::create('fòôbàř')->slice(0, 3);// يُرجع كائن Stringy بالسلسلة "fòô"S::slice('fòôbàř', 0, 3)؛

أساليب الطبقة

إنشاء (مختلط $str [، $encoding ])

ينشئ كائنًا متسلسلًا ويعين كلاً من خصائص str والتشفير للقيم المقدمة. يتم إرسال $str إلى سلسلة قبل التعيين، وإذا لم يتم تحديد $encoding، فسيتم تعيينه افتراضيًا على mb_internal_encoding(). ثم تقوم بإرجاع الكائن الذي تمت تهيئته. يرمي InvalidArgumentException إذا كانت الوسيطة الأولى عبارة عن مصفوفة أو كائن بدون أسلوب __toString.

 $stringy = S::create('fòôbàř'); // "فوبار"

طرق المثيل

الكائنات الخيطية غير قابلة للتغيير. جميع الأمثلة أدناه تستخدم استيراد دالة PHP 5.6، وتركيب جملة المصفوفة القصيرة PHP 5.4. ويفترضون أيضًا أن التشفير الذي تم إرجاعه بواسطة mb_internal_encoding() هو UTF-8. لمزيد من التفاصيل، راجع وثائق طريقة الإنشاء أعلاه، بالإضافة إلى الملاحظات حول إنشاء PHP 5.6.

إلحاق (سلسلة $ سلسلة)

إرجاع سلسلة جديدة مع إضافة سلسلة $.

 s('fòô')->append('bàř'); // 'فوبار'
في (مؤشر $ int)

إرجاع الحرف عند $index، مع الفهارس التي تبدأ من 0.

 s('fòôbàř')->at(3); // "ب"
بين (سلسلة $start، سلسلة $end [، int $offset])

إرجاع السلسلة الفرعية بين $start و$end، إذا وجدت، أو سلسلة فارغة. قد يتم توفير إزاحة اختيارية يمكن من خلالها بدء البحث عن سلسلة البداية.

 s('{foo} و {bar}')->between('{', '}'); // "فو"
كاميليز ()

تُرجع نسخة CamelCase من السلسلة. يقوم بقص المسافات المحيطة، وتكبير الحروف التي تتبع الأرقام، والمسافات، والشرطات والشرطات السفلية، وإزالة المسافات، والشرطات، وكذلك الشرطات السفلية.

 s('Camel-Case')->camelize(); // "حالة الجمل"
الأحرف ()

إرجاع مصفوفة تتكون من الأحرف الموجودة في السلسلة.

 s('fòôbàř')->chars(); // ['f', 'ò', 'ô', 'b', 'à', 'ř']
انهيار مسافة بيضاء ()

يقوم بقص السلسلة واستبدال أحرف المسافات البيضاء المتتالية بمسافة واحدة. يتضمن ذلك علامات التبويب وأحرف الأسطر الجديدة، بالإضافة إلى المسافات البيضاء متعددة البايت مثل المساحة الرفيعة والمساحة الإيديوغرافية.

 s(' Ο συγγραφέας ')->collapseWhitespace(); // """"""""""""""""""
يحتوي على (سلسلة $needle [، boolean $caseSensitive = true ])

يُرجع صحيحًا إذا كانت السلسلة تحتوي على $needle، ويُرجع خطأً بخلاف ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('Ο συγγραφέας είπε')->يحتوي على('συγγραφέας'); // حقيقي
يحتوي على الكل (صفيف $ الإبر [، منطقي $caseSensitive = صحيح ])

يُرجع صحيحًا إذا كانت السلسلة تحتوي على جميع الإبر $، ويُرجع خطأً في حالة عدم ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('foo & bar')->containsAll(['foo', 'bar']); // حقيقي
يحتوي على أي (صفيف $ الإبر [، منطقي $caseSensitive = صحيح ])

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أي إبر $، ويُرجع خطأً بخلاف ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('str يحتوي على foo')->containsAny(['foo', 'bar']); // حقيقي
countSubstr(سلسلة $substring [، منطقية $caseSensitive = true ])

إرجاع عدد مرات ظهور السلسلة الفرعية $ في السلسلة المحددة. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('Ο συγγραφέας είπε')->countSubstr('α'); // 2
داشيريزي()

إرجاع أحرف صغيرة وسلسلة مشذبة مفصولة بشرطات. يتم إدراج الشرطات قبل الأحرف الكبيرة (باستثناء الحرف الأول من السلسلة)، وبدلاً من المسافات والشرطات السفلية.

 s('fooBar')->dasherize(); // "فو بار"
المحدد (محدد $ int)

تُرجع سلسلة صغيرة ومقتطعة مفصولة بالمحدد المحدد. يتم إدراج المحددات قبل الأحرف الكبيرة (باستثناء الحرف الأول من السلسلة)، وبدلاً من المسافات والشرطات والشرطات السفلية. لا يتم تحويل محددات ألفا إلى أحرف صغيرة.

 s('fooBar')->delimit('::'); // 'فو::بار'
ينتهي مع (سلسلة $substring [، منطقية $caseSensitive = صحيح ])

يُرجع صحيحًا إذا كانت السلسلة تنتهي بسلسلة فرعية $، ويُرجع خطأً بخلاف ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('fòôbàř')->endsWith('bàř'); // حقيقي
endWithAny(string[] $substrings [, boolean $caseSensitive = true ])

يُرجع صحيحًا إذا كانت السلسلة تنتهي بأي من السلاسل الفرعية $، ويُرجع خطأً في حالة خلاف ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('fòôbàř')->endsWithAny(['bàř', 'baz']); // حقيقي
ضمان اليسار (سلسلة $ سلسلة فرعية)

يضمن أن السلسلة تبدأ بـ $substring. إذا لم يحدث ذلك، فهو مُسبق.

 s('foobar')->ensureLeft('http://'); // 'http://foobar'
ضمان الحق (سلسلة $ سلسلة فرعية)

يضمن أن السلسلة تنتهي بـ $substring. إذا لم يحدث ذلك، يتم إلحاقه.

 s('foobar')->ensureRight('.com'); // "فوبار.كوم"
الأول (كثافة العمليات $ ن)

إرجاع الأحرف $n الأولى من السلسلة.

 s('fòôbàř')->first(3); // "فو"
الحصول على الترميز ()

إرجاع الترميز المستخدم بواسطة كائن Stringy.

 s('fòôbàř')->getEncoding(); // "UTF-8"
hasLowerCase()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على حرف صغير، ويُرجع خطأً في حالة عدم ذلك.

 s('fòôbàř')->hasLowerCase(); // حقيقي
hasUpperCase()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على حرف كبير، ويُرجع خطأً في حالة عدم ذلك.

 s('fòôbàř')->hasUpperCase(); // خطأ شنيع
HTMLDecode()

تحويل كافة كيانات HTML إلى أحرفها القابلة للتطبيق. اسم مستعار لـ html_entity_decode. للحصول على قائمة بالأعلام، راجع http://php.net/manual/en/function.html-entity-decode.php

 s('&')->htmlDecode(); // '&'
HTMLEncode()

تحويل كافة الأحرف القابلة للتطبيق إلى كيانات HTML. اسم مستعار لـ htmlentities. ارجع إلى http://php.net/manual/en/function.htmlentities.php للحصول على قائمة بالأعلام.

 s('&')->htmlEncode(); // '&'
أنسنة ()

تكبير الكلمة الأولى من السلسلة، واستبدال الشرطة السفلية بمسافات، وإزالة '_id'.

 s('author_id')->إضفاء طابع إنساني(); // 'مؤلف'
IndexOf(string $needle [, $offset = 0 ]);

إرجاع فهرس التواجد الأول لـ $needle في السلسلة، وخطأ إذا لم يتم العثور عليه. يقبل إزاحة اختيارية يبدأ منها البحث. يتم البحث عن فهرس سلبي من النهاية

 s('string')->indexOf('ing'); // 3
IndexOfLast(string $needle [, $offset = 0 ]);

إرجاع فهرس آخر تواجد لـ $needle في السلسلة، وخطأ إذا لم يتم العثور عليه. يقبل إزاحة اختيارية يبدأ منها البحث. قد تكون الإزاحات سالبة عند حسابها من الحرف الأخير في السلسلة.

 s('foobarfoo')->indexOfLast('foo'); // 10
إدراج (مؤشر $ int، سلسلة فرعية $)

يُدرج سلسلة فرعية $ في السلسلة الموجودة في الفهرس $ المقدم.

 s('fòôbř')->insert('à', 4); // 'فوبار'
isAlpha()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أحرف أبجدية فقط، ويُرجع خطأً في حالة عدم ذلك.

 s('丹尼爾')->isAlpha(); // حقيقي
أبجدية رقمية()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أحرف أبجدية ورقمية فقط، ويُرجع خطأً في حالة عدم ذلك.

 s('دانيال1')->isAlphanumeric(); // حقيقي
isBase64()

يُرجع صحيحًا إذا كانت السلسلة بترميز base64، ويُرجع خطأً في حالة عدم ذلك.

 s('Zm9vYmFy')->isBase64(); // حقيقي
فارغ()

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

 s("nt vf")->isBlank(); // حقيقي
هو سداسي عشري ()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أحرف سداسية عشرية فقط، ويُرجع خطأً في حالة عدم ذلك.

 s('A102F')->isHexadecimal(); // حقيقي
isJson()

يُرجع صحيحًا إذا كانت السلسلة JSON، ويُرجع خطأً في حالة عدم ذلك. على عكس json_decode في PHP 5.x، تتوافق هذه الطريقة مع PHP 7 وموزعي JSON الآخرين، حيث لا تعتبر السلسلة الفارغة صالحة JSON.

 s('{"foo": "bar"}')->isJson(); // حقيقي
isLowerCase()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أحرف صغيرة فقط، ويُرجع خطأً في حالة عدم ذلك.

 s('fòôbàř')->isLowerCase(); // حقيقي
غير متسلسل ()

يُرجع صحيحًا إذا كانت السلسلة مُتسلسلة، ويُرجع خطأً في حالة عدم ذلك.

 s('a:1:{s:3:"foo";s:3:"bar";}')->isSerialized(); // حقيقي
isUpperCase()

يُرجع صحيحًا إذا كانت السلسلة تحتوي على أحرف كبيرة فقط، ويُرجع خطأً في حالة عدم ذلك.

 s('FÒÔBÀŘ')->isUpperCase(); // حقيقي
الأخير (كثافة العمليات $ ن)

إرجاع آخر $n أحرف من السلسلة.

 s('fòôbàř')->الأخير(3); // 'حاجِز'
طول()

إرجاع طول السلسلة. اسم مستعار للدالة mb_strlen() في PHP.

 s('fòôbàř')->length(); // 6
خطوط ()

الانقسامات على الأسطر الجديدة والإرجاع إلى أول السطر، مما يؤدي إلى إرجاع مجموعة من الكائنات Stringy المقابلة للأسطر الموجودة في السلسلة.

 s("fòôrnbàřn")->lines(); // ['fòô'، 'bàř'، '']
الأطولCommonPrefix(سلسلة $otherStr)

تُرجع أطول بادئة مشتركة بين السلسلة النصية و$otherStr.

 s('foobar')->longestCommonPrefix('foobaz'); // "فوبا"
الأطولCommonSuffix(سلسلة $otherStr)

تُرجع أطول لاحقة مشتركة بين السلسلة النصية و$otherStr.

 s('fòôbàř')->longestCommonSuffix('fòrbàř'); // 'حاجِز'
الأطولCommonSubstring(سلسلة $otherStr)

تُرجع أطول سلسلة فرعية مشتركة بين السلسلة و$otherStr. وفي حالة الروابط، فإنها ترجع ما حدث أولا.

 s('foobar')->longestCommonSubstring('boofar'); // "أوو"
لوريركيسفيرست ()

يحول الحرف الأول من السلسلة المتوفرة إلى أحرف صغيرة.

 s('Σ foo')->lowerCaseFirst(); // "σ فو"
Pad(int $length [, string $padStr = ' ' [، string $padType = 'right' ]])

يسند السلسلة إلى طول معين باستخدام $padStr. إذا كان الطول أقل من أو يساوي طول السلسلة، فلن يتم استخدام أي حشوة. السلسلة الافتراضية المستخدمة للحشو هي مسافة، والنوع الافتراضي (أحد "يسار" و"يمين" و"كلاهما") هو "يمين". يرمي InvalidArgumentException إذا لم يكن $padType واحدًا من تلك القيم الثلاث.

 s('fòôbàř')->pad(9, '-/', 'left'); // '-/-fòôbàř'
PadBoth(int $length [, string $padStr = ' ' ])

تقوم بإرجاع سلسلة جديدة بطول معين بحيث يكون كلا جانبي السلسلة مبطنين. الاسم المستعار لـ ()pad مع $padType لـ "كلاهما".

 s('foo bar')->padBoth(9, ' '); // 'فو بار'
PadLeft(int $length [, string $padStr = ' ' ])

إرجاع سلسلة جديدة بطول معين بحيث تكون بداية السلسلة مبطنة. الاسم المستعار للوسادة () مع $padType من 'left'.

 s('foo bar')->padLeft(9, ' '); // "شريط فو"
PadRight(int $length [, string $padStr = ' ' ])

إرجاع سلسلة جديدة بطول معين بحيث تكون نهاية السلسلة مبطنة. الاسم المستعار لـ ()pad مع $padType من 'right'.

 s('foo bar')->padRight(10, '_*'); // 'فو بار_*_'
بادئة (سلسلة $ سلسلة)

إرجاع سلسلة جديدة تبدأ بـ $string.

 s('bàř')->prepend('fòô'); // 'فوبار'
regexReplace(سلسلة $pattern، سلسلة $replacement [، string $options = 'msr'])

يستبدل كل تكرارات $pattern في $str بـ $replacement. اسم مستعار لـ mb_ereg_replace(). لاحظ أن الخيار 'i' مع الأنماط متعددة البايت في mb_ereg_replace() يتطلب PHP 5.6+ للحصول على النتائج الصحيحة. ويرجع ذلك إلى نقص الدعم في الإصدار المجمع من Oniguruma في PHP <5.6، والإصدارات الحالية من HHVM (3.8 وما دونه).

 s('fòô ')->regexReplace('f[òô]+s', 'bàř'); // 'bàř's('fò')->regexReplace('(ò)', '1ô'); // "فو"
إزالة اليسار (سلسلة $ سلسلة فرعية)

إرجاع سلسلة جديدة مع إزالة البادئة $substring، إذا كانت موجودة.

 s('fòôbàř')->removeLeft('fòô'); // 'حاجِز'
إزالة اليمين (سلسلة $ سلسلة فرعية)

إرجاع سلسلة جديدة مع إزالة اللاحقة $substring، إذا كانت موجودة.

 s('fòôbàř')->removeRight('bàř'); // "فو"
تكرار (كثافة العمليات $ المضاعف)

إرجاع سلسلة متكررة نظرا لمضاعف. اسم مستعار لـ str_repeat.

 الصورة('α')->كرر(3); // "ألفا ألفا"
استبدال (سلسلة $ البحث، سلسلة $ استبدال)

يستبدل كل تكرارات $search في $str بـ $replacement.

 s('fòô bàř fòô bàř')->replace('fòô ', ''); // "بار بار"
يعكس()

إرجاع سلسلة معكوسة. نسخة متعددة البايت من strrev ().

 s('fòôbàř')->reverse(); // "رابوف"
SafeTruncate(int $length [, string $substring = '' ])

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

 s('ما هي خططك اليوم؟')->safeTruncate(22, '...');// 'ما هي خططك...'
خلط()

دالة str_shuffle() متعددة البايت. تقوم بإرجاع سلسلة بأحرفها بترتيب عشوائي.

 s('fòôbàř')->shuffle(); // "أروبوف"
slugify([، سلسلة $replacement = '-' [، سلسلة $language = 'en']])

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

 s('استخدام سلاسل مثل fòô bàř')->slugify(); // "استخدام السلاسل مثل شريط foo"
شريحة (int $start [، int $end ])

تُرجع السلسلة الفرعية التي تبدأ من $start، وحتى، ولكن لا تتضمن الفهرس المحدد بواسطة $end. إذا تم حذف $end، فستستخرج الدالة السلسلة المتبقية. إذا كانت $end سالبة، فسيتم حسابها من نهاية السلسلة.

 s('fòôbàř')->slice(3, -1); // "با"
انقسام (سلسلة نمط $ [، حد $ الحد])

يقسم السلسلة باستخدام التعبير العادي المقدم، ويعيد مصفوفة من الكائنات Stringy. سيؤدي الحد الصحيح الاختياري $limit إلى اقتطاع النتائج.

 s('foo,bar,baz')->split(',', 2); // ["فو"، "شريط"]
يبدأ مع (سلسلة $substring [، منطقية $caseSensitive = صحيح ])

يُرجع صحيحًا إذا كانت السلسلة تبدأ بسلسلة فرعية $، ويُرجع خطأً بخلاف ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // حقيقي
startWithAny(string[] $substrings [, boolean $caseSensitive = true ])

يُرجع صحيحًا إذا كانت السلسلة تبدأ بأي من السلاسل الفرعية $، ويُرجع خطأً في حالة عدم ذلك. بشكل افتراضي، تكون المقارنة حساسة لحالة الأحرف، ولكن يمكن جعلها غير حساسة عن طريق تعيين $caseSensitive إلى false.

 s('FÒÔbàřbaz')->startsWithAny(['fòô', 'bàř'], false); // حقيقي
stripWhitespace()

تجريد جميع أحرف المسافة البيضاء. يتضمن ذلك علامات التبويب وأحرف الأسطر الجديدة، بالإضافة إلى المسافات البيضاء متعددة البايت مثل المساحة الرفيعة والمساحة الإيديوغرافية.

 s(' Ο συγγραφέας ')->stripWhitespace(); // """""""""""""
substr(int $start [, int $ length ])

تُرجع السلسلة الفرعية التي تبدأ من $start بالطول $ المحدد. وهي تختلف عن الدالة mb_substr() في أن توفير $ length null سيؤدي إلى إرجاع بقية السلسلة، بدلاً من سلسلة فارغة.

 s('fòôbàř')->substr(2, 3); // 'أوبا'
محيطي (سلسلة $ سلسلة فرعية)

يحيط بسلسلة مع السلسلة الفرعية المحددة.

 s(' ͜ ')-> محيطي('ʘ'); // 'ʘ ͜ ʘ'
مبادلة ()

إرجاع نسخة مبادلة حالة من السلسلة.

 s('Ντανικ')->swapCase(); // 'الاسم'
مرتب()

إرجاع سلسلة تحتوي على علامات اقتباس ذكية وأحرف حذف وشرطات من Windows-1252 (تُستخدم عادةً في مستندات Word) مع استبدالها بمكافئاتها من ASCII.

 s('"أرى..."')->مرتب(); // '"أرى..."'
عنوان ([، مجموعة تجاهل $])

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

 $ignore = ['at', 'by', 'for', 'in', 'of', 'on', 'out', 'to', 'the'];s('أحب مشاهدة التلفزيون' )->titleize($ignore);// "أحب مشاهدة التلفاز"
toAscii([, string $language = 'en' [, bool $removeUnsupported = true ]])

إرجاع نسخة ASCII من السلسلة. يتم استبدال مجموعة من الأحرف غير ASCII بأقرب نظيراتها من ASCII، ويتم إزالة الباقي بشكل افتراضي. يمكن توفير اللغة أو الإعدادات المحلية للسلسلة المصدر للترجمة الصوتية الخاصة باللغة بأي من التنسيقات التالية: en، أو en_GB، أو en-GB. على سبيل المثال، يؤدي تمرير "de" إلى تعيين "äöü" إلى "aeoeue" بدلاً من "aou" كما هو الحال في اللغات الأخرى.

 s('fòôbàř')->toAscii(); // 'foobar's('äöü')->toAscii(); // 'aou's('äöü')->toAscii('de'); // "أيويو"
toBoolean()

تقوم بإرجاع تمثيل منطقي لقيمة السلسلة المنطقية المحددة. على سبيل المثال، ستعرض القيم "true" و"1" و"on" و"yes" القيمة true. ستعرض "خطأ" و"0" و"إيقاف" و"لا" خطأ. وفي جميع الحالات يتم تجاهل الحالة. بالنسبة للسلاسل الرقمية الأخرى، ستحدد علاماتها القيمة المرجعة. بالإضافة إلى ذلك، فإن السلاسل الفارغة التي تتكون من مسافة بيضاء فقط ستُرجع خطأ. بالنسبة لجميع السلاسل الأخرى، تكون القيمة المرجعة نتيجة لعملية تحويل منطقية.

 s('OFF')->toBoolean(); // خطأ شنيع
toLowerCase()

تحويل كافة الأحرف في السلسلة إلى أحرف صغيرة. اسم مستعار لـ mb_strtolower() الخاص بـ PHP.

 s('FÒÔBÀŘ')->toLowerCase(); // "فوبار"
toSpaces([, tabLength = 4 ])

يحول كل علامة تبويب في السلسلة إلى عدد معين من المسافات، كما هو محدد بواسطة $tabLength. بشكل افتراضي، يتم تحويل كل علامة تبويب إلى 4 مسافات متتالية.

 s(' Stringpeech = "Hi"')->toSpaces(); // 'سلسلة الكلام = "مرحبًا"'
toTabs([, tabLength = 4 ])

يحول كل تواجد لعدد متتالي من المسافات، كما هو محدد بواسطة $tabLength، إلى علامة تبويب. بشكل افتراضي، يتم تحويل كل 4 مسافات متتالية إلى علامة تبويب.

 s(' fòô bàř')->toTabs();// ' fòô bàř'
toTitleCase()

تحويل الحرف الأول من كل كلمة في السلسلة إلى أحرف كبيرة.

 s('fòô bàř')->toTitleCase(); // "فو بار"
toUpperCase()

تحويل كافة الأحرف في السلسلة إلى أحرف كبيرة. اسم مستعار لـ mb_strtoupper() الخاص بـ PHP.

 s('fòôbàř')->toUpperCase(); // "FÒÔBÀŘ"
تقليم ([، سلسلة $ أحرف])

إرجاع سلسلة مع إزالة المسافة البيضاء من بداية السلسلة ونهايتها. يدعم إزالة المسافات البيضاء يونيكود. يقبل سلسلة اختيارية من الأحرف لتجريدها بدلاً من الإعدادات الافتراضية.

 s(' fòôbàř ')->trim(); // "فوبار"
TrimLeft([، سلسلة $chars])

إرجاع سلسلة مع إزالة المسافة البيضاء من بداية السلسلة. يدعم إزالة المسافات البيضاء يونيكود. يقبل سلسلة اختيارية من الأحرف لتجريدها بدلاً من الإعدادات الافتراضية.

 s(' fòôbàř ')->trimLeft(); // 'فوبار'
TrimRight([، سلسلة $chars])

إرجاع سلسلة مع إزالة المسافة البيضاء من نهاية السلسلة. يدعم إزالة المسافات البيضاء يونيكود. يقبل سلسلة اختيارية من الأحرف لتجريدها بدلاً من الإعدادات الافتراضية.

 s(' fòôbàř ')->trimRight(); // ' فوبار'
اقتطاع (int $ length [، string $substring = '' ])

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

 s('ما هي خططك اليوم؟')->truncate(19, '...'); // "ما هي تفضيلاتك..."
تم التأكيد ()

تُرجع سلسلة صغيرة ومقتطعة مفصولة بشرطات سفلية. يتم إدراج الشرطات السفلية قبل الأحرف الكبيرة (باستثناء الحرف الأول من السلسلة)، وبدلاً من المسافات والشرطات.

 s('TestUCase')->underscore(); // "اختبار_u_case"
العلويCamelize()

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

 s('علبة الجمل العلوية')->upperCamelize(); // "UpperCamelCase"
UpperCaseFirst()

يحول الحرف الأول من السلسلة المتوفرة إلى أحرف كبيرة.

 s('σ foo')->upperCaseFirst(); // 'Σ فو'

ملحقات

فيما يلي قائمة بالمكتبات التي تمتد Stringy:

  • SliceableStringy: شرائح سلسلة تشبه Python في PHP

  • SubStringy: طرق السلسلة الفرعية المتقدمة

الاختبارات

من دليل المشروع، يمكن إجراء الاختبارات باستخدام phpunit

رخصة

تم إصداره بموجب ترخيص MIT - راجع LICENSE.txt للحصول على التفاصيل.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل