نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

الحقل text

عناصر <input> ذات النوع text تسمح بإنشاء حقول إدخال نصية بسيطة ذات سطرٍ وحيد. <input type="text" name="name"> الخاصية value تحتوي الخاصية value في الحقل text على سلسلة نصية (DOMString) التي تمثل المحتوى الحالي النصي الموجود في حقل الإدخال. يمكن الحصول على قيمة هذه الخاصية باستخدام الخاصية HTMLInputElement.value عبر JavaScript: let theText = myTextInput.value; لا توجد شروط للتحقق من صحة هذا الحقل (راجع قسم «التحقق من الحقل» لمزيدٍ من التفاصيل)، يمكن أن تكون القيمة سلسلةً نصيةً أو قيمةً فارغةً. استخدام حقل الإدخال النصي عناصر ...

الخاصية text-overflow

الخاصية text-overflow في CSS تُحدِّد ماذا سيحدث عند عدم عرض المحتوى الزائد عن صندوقه، فيمكن أن يتم اقتصاص المحتوى، أو عرض ثلاث نقط (المحرف … رمزه U+2026)، أو عرض سلسلة نصية خاصة. بطاقة الخاصية القيمة الابتدائية clip تُطبَّق على الحاويات الكتلية (block container elements). قابلة للوراثة لا قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-overflow: clip; text-overflow: ellipsis; /* <string> سلسلة نصية */ text-overflow: "…"; /* القيم العامة */ text-overflow: inherit; text-overflow: initial; text-overflow: unset; الخاصية text-overflow لا تؤدي إلى خروج المحتوى من صندوقه، ولجعل ...

التابع ‎‎.text()‎‎ في jQuery

يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى العناصر الأحفاد لهم، أو يغيِّر المحتوى النصي للعناصر المطابقة. ‎.text()‎ القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى المحتوى النصي للعناصر الأحفاد أيضًا. ‎‎.text()‎‎ أُضيف مع الإصدار: 1.0. ولا يقبل هذا التابع أية وسائط. يمكن استعمال التابع ‎.text()‎ في مستندات XML ومستندات HTML كلاهما خلافًا للتابع ‎.html()‎. يعيد التابع سلسلة نصية ...

الخاصية text-justify

الخاصية text-justify في CSS تُعرِّف طريقة توزيع النص إذا كانت الخاصية text-align مضبوطةً إلى القيمة justify. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على العناصر السطرية، وخلايا الجداول. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. /* كلمات محجوزة */ text-justify: none; text-justify: auto; text-justify: inter-word; text-justify: inter-character; /* قيم عامة */ text-justify: inherit; text-justify: initial; text-justify: unset; أمثلة مثال عن استخدام مختلف قيم الخاصية text-justify: <p class="none"><code>text-justify: none</code> —<br>تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. ...

الخاصية text-indent

الخاصية text-indent في CSS تُحدِّد مقدار المسافة البادئة التي توضع قبل أسطر النص الموجودة في عنصر كتلي؛ وهذه الخاصية تتحكم بالمسافة البادئة لأوّل سطر افتراضيًا، لكن يمكن استخدام الكلمتين المحجوزتين hanging و each-line لتغيير هذا السلوك (انظر «دعم المتصفحات»). بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على العناصر الكتلية. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدت. /* <length> أطوال */ text-indent: 3mm; text-indent: 40px; /* <percentage> نسبة مئوية*/ text-indent: 15%; /* قيم عامة */ text-indent: inherit; text-indent: initial; text-indent: unset; تبدأ هذه المسافة من الحافة اليسرى لصندوق ...

الخاصية text-shadow

الخاصية text-shadow في CSS تضيف تأثير الظلال على النص، وتقبل تحديد أكثر من ظل (يُفصَل بين قيمها بفاصلة)، وسيُطبَّق الظل على النص وعلى خطوط الزخرفة text-decoration التابعة للعنصر. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* offset-x | offset-y | blur-radius | color */ text-shadow: 1px 1px 2px black; /* color | offset-x | offset-y | blur-radius */ text-shadow: #FC0 1px 0 10px; /* offset-x | offset-y | color */ text-shadow: ...

الخاصية text-transform

الخاصية text-transform في CSS تُحدِّد ما هي حالة الأحرف التي سيُعرَض فيها العنصر؛ إذ يمكن استخدام هذه الخاصية لجعل الأحرف كلها بالحالة الكبيرة (uppercase)، أو بالحالة الصغيرة (lowercase)، أو جعل أوّل حرف من كل كلمة كبيرًا. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. يجدر بالذكر أنَّ هذه الخاصية ليس لها أثر على النصوص العربية. /* الكلمات المحجوزة */ text-transform: capitalize; text-transform: uppercase; text-transform: lowercase; text-transform: none; /* القيم العامة */ text-transform: inherit; text-transform: initial; text-transform: unset; ...

الخاصية text-emphasis

الخاصية text-decoration في CSS تُحدِّد علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر باستثناء الفراغات ومحارف التحكم (control chars، مثل محرف السطر الجديد، ومحرف العودة إلى بداية السطر)؛ وهي خاصيةٌ مختصرة لضبط قيمة أكثر من خاصية عن ضبط علامات التوكيد معًا، وهي تتضمن text-emphasis-style و text-emphasis-color. بطاقة الخاصية القيمة الابتدائية لكل قيمة مختصرة: text-emphasis-style: none text-emphasis-color: currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا، باستثناء قيمة الخاصية text-emphasis-color. الوسائط مرئية القيمة المحسوبة لكل قيمة مختصرة: text-emphasis-style: كما حُدِّدَت. ...

CSS/Topics/Text

الخاصية الوصف direction تضبط اتجاه النص، ونستخدم القيمة rtl معها للإشارة إلى اللغات التي تُكتَب من اليمين إلى اليسار مثل اللغة العربية، و ltr للغات التي تُكتَب من اليسار إلى اليمين مثل اللغة الإنكليزية. لاحظ أنَّ اتجاه النص يُعرَّف عادةً باستخدام الخاصية dir على عنصر <html> لكامل المستند، وليس باستخدام الخاصية direction. letter-spacing تُحدِّد ما هو التباعد بين الأحرف النصية. line-break تُحدِّد سلوك المتصفح في الانتقال إلى سطرٍ جديد عند التعامل مع علامات الترقيم والرموز. overflow-wrap تُحدِّد إذا كان على المتصفح الانتقال إلى سطر جديد ضمن الكلمات نفسها لمنع ...

CSS/Topics/Text

الخاصية الوصف direction تضبط اتجاه النص، ونستخدم القيمة rtl معها للإشارة إلى اللغات التي تُكتَب من اليمين إلى اليسار مثل اللغة العربية، و ltr للغات التي تُكتَب من اليسار إلى اليمين مثل اللغة الإنكليزية. لاحظ أنَّ اتجاه النص يُعرَّف عادةً باستخدام الخاصية dir على عنصر <html> لكامل المستند، وليس باستخدام الخاصية direction. letter-spacing تُحدِّد ما هو التباعد بين الأحرف النصية. line-break تُحدِّد سلوك المتصفح في الانتقال إلى سطرٍ جديد عند التعامل مع علامات الترقيم والرموز. overflow-wrap تُحدِّد إذا كان على المتصفح الانتقال إلى سطر جديد ضمن الكلمات نفسها لمنع ...

الخاصية text-align

الخاصية text-align في CSS تصف كيف تكون محاذاة العناصر السطرية مثل النصوص في الحاويات الكتلية؛ لاحظ أنَّ الخاصية text-align لا تتحكم بمحاذاة العناصر الكتلية، وإنما تتحكم بمحاذاة بالمحتوى السطري الموجود داخلها. بطاقة الخاصية القيمة الابتدائية start، أو قيمة غير محددة ستمثِّل القيمة left إذا كان اتجاه العنصر ltr، و right إذا كان اتجاه النص rtl وذلك في حال كانت القيمة start غير مدعومة في المتصفح. تُطبَّق على الحاويات الكتلية. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت، باستثناء ...

الخاصية text-decoration

الخاصية text-decoration في CSS تُحدِّد شكل خطوط الزخرفة (decorative lines) المستخدمة على النص؛ وهي خاصيةٌ مختصرة لضبط قيمة أكثر من خاصية عن خطوط الزخرفة بآنٍ واحد، وهي تتضمن text-decoration-line و text-decoration-color و text-decoration-style. بطاقة الخاصية القيمة الابتدائية لكل قيمة مختصرة: text-decoration-color: currentcolor text-decoration-style: solid text-decoration-line: none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا، باستثناء قيمة الخاصية text-decoration-color. القيمة المحسوبة طول مطلق أو الكلمة المحجوزة normal. /* كلمات محجوزة */ text-decoration: none; text-decoration: underline red; text-decoration: underline wavy red; /* قيم عامة */ text-decoration: inherit; text-decoration: initial; text-decoration: unset; لاحظ ...

الخاصية text-emphasis-color

الخاصية text-decoration-color في CSS تُحدِّد اللون المستخدم لرسم علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر؛ يمكن ضبط قيمة هذه الخاصية باستعمال الخاصية المختصرة text-emphasis. بطاقة الخاصية القيمة الابتدائية currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم الوسائط مرئية القيمة المحسوبة القيمة اللونية المحسوبة. /* القيمة الابتدائية */ text-emphasis-color: currentColor; /* <color> */ text-emphasis-color: #555; text-emphasis-color: blue; text-emphasis-color: rgba(90, 200, 160, 0.8); text-emphasis-color: transparent; /* القيم العامة */ text-emphasis-color: inherit; text-emphasis-color: initial; text-emphasis-color: unset; أمثلة مثال عن استخدام الخاصية text-emphasis-color على العنصر <strong> مع الخاصية ...

الخاصية text-decoration-style

الخاصية text-decoration-style في CSS تُحدِّد شكل خطوط الزخرفة (decorative lines) المستخدمة على النص (المضبوطة عبر الخاصية text-decoration-line). إذا كنت ستضبط عدِّة خاصيات لتحديد شكل خطوط الزخرفة، فمن المستحسن حينئذٍ استخدام الخاصية المختصرة text-decoration. بطاقة الخاصية القيمة الابتدائية solid تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-decoration-style: solid; text-decoration-style: double; text-decoration-style: dotted; text-decoration-style: dashed; text-decoration-style: wavy; /* القيم العامة */ text-decoration-style: inherit; text-decoration-style: initial; text-decoration-style: unset; لا توفِّر CSS طريقةً مباشرةً لتحديد شكل فريد لكل خط زخرفة مُطبَّق على العنصر، لكن ...

الخاصية text-emphasis-style

الخاصية text-decoration-style في CSS تُحدِّد نوع علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر باستثناء الفراغات ومحارف التحكم (control chars، مثل محرف السطر الجديد، ومحرف العودة إلى بداية السطر)؛ يمكن ضبط قيمة هذه الخاصية باستعمال الخاصية المختصرة text-emphasis. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا الوسائط مرئية القيمة المحسوبة كما حُدِّدَت. /* القيمة الابتدائية */ text-emphasis: none; /* <string> سلاسل نصية */ text-emphasis-style: 'x'; text-emphasis-style: '点'; text-emphasis-style: '\25B2'; text-emphasis-style: '*'; text-emphasis-style: 'foo'; /* لا تستخدم هذه القيمة، ...

الخاصية text-decoration-line

الخاصية text-decoration-line في CSS تُحدِّد نوع خطوط الزخرفة (decorative lines) المستخدمة على النص. إذا كنت ستضبط عدِّة خاصيات لتحديد شكل خطوط الزخرفة، فمن المستحسن حينئذٍ استخدام الخاصية المختصرة text-decoration. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-decoration-line: none; text-decoration-line: underline; text-decoration-line: overline; text-decoration-line: line-through; text-decoration-line: blink; text-decoration-line: underline overline; /* استخدام خطَيّ زخرفة */ text-decoration-line: overline underline line-through; ...

الخاصية text-decoration-color

الخاصية text-decoration-color في CSS تُحدِّد لون خطوط الزخرفة (decorative lines) المستخدمة على النص والمضبوطة عبر الخاصية text-decoration-line؛ وهذا يتضمن الأسطر التي تعلو الخط أو تظهر أدناه أو تمر عبره أو الخطوط المموجة (التي تُشير عادةً إلى أنَّ الكلام فيه خطأ إملائي على سبيل المثال)؛ وسيُطبَّق اللون المضبوط عبر هذه الخاصية على جميع خطوط الزخرفة المُحدَّدة على العنصر. بطاقة الخاصية القيمة الابتدائية currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة قيمة لونية <color>. إذا كنت ستضبط عدِّة ...

HTML/Topics/Text Content

عناصر المحتوى النصي تُستخدَم لتنظيم أجزاء من المحتوى الموجودة في العنصر <body>، وهي مفيدة لتعريف الغرض من المحتوى الموجود داخلها، مما يفيد في فهرسة الصفحة أو زيادة قابلية الوصول إليها. العنصر الوصف <blockquote> يُشير العنصر <blockquote> (اسم هذا العنصر اختصارٌ للعبارة HTML Block Quotation Element) إلى أنَّ النص الموجود داخله هو نص اقتباس طويل. يُعرَض هذا العنصر عادةً مع إضافة محاذاة قبله (راجع قسم الملاحظات في هذه المقالة لمعرفة كيفية تغيير طريقة العرض). يمكن توفير رابط URL لمصدر الاقتباس عبر الخاصية cite، أما التمثيل ...

الخاصية text-align-last

الخاصية text-align-last في CSS تصف كيف تكون محاذاة آخر سطر نصي. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على الحاويات الكتلية. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. /* كلمات محجوزة */ text-align-last: auto; text-align-last: start; text-align-last: end; text-align-last: left; text-align-last: right; text-align-last: center; text-align-last: justify; /* القيم العامة */ text-align-last: inherit; text-align-last: initial; text-align-last: unset; أمثلة مثال عن استخدام جميع الكلمات المحجوزة المدعومة في خاصية text-align-last، وسنكرر كل مثال مرتين، مرةً على فقرةٍ باللغة الإنكليزية (اتجاه النص من اليسار إلى اليمين)، ومرةً على فقرةٍ باللغة العربية (اتجاه النص ...

المكتبة Action Text في ريلز

يوفر Action Text محتوًى نصيًّا غنيًّا والتعديل في ريلز. يحوي على المحرر Trix الذي يعالج كل شيء بدءًا من التنسيق وحتى روابط الاقتباسات والقوائم والصور المضمَّنة ومعارض الصور. يُحفَظ المحتوى النصي المُولَّد عبر المحرر Trix في الوحدة RichText الخاصة به والمرتبطة مع أي وحدة Active Record موجودة في التطبيق. تُخزَّن أية صور (أو مرفقات أخرى) تلقائيًّا باستعمال Active Storage وتُربَط مع الوحدة RichText المضمنة. يمكنك قراءة المزيد حول Action Text في دليل أساسيات Action Text. مصادر صفحة Action Text من ...

الخاصية text-emphasis-position

الخاصية text-decoration-position في CSS تُحدِّد موضع رسم علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر؛ وقد تؤدي هذه الخاصية إلى تغيير ارتفاع السطر إن لم يتسع لعلامة التوكيد. بطاقة الخاصية القيمة الابتدائية over right تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا الوسائط مرئية القيمة المحسوبة كما حُدِّدَت. /* القيمة الابتدائية */ text-emphasis-position: over right; /* الكلمات المحجوزة */ text-emphasis-position: over left; text-emphasis-position: under right; text-emphasis-position: under left; text-emphasis-position: left over; text-emphasis-position: right under; text-emphasis-position: left under; /* القيم العامة */ text-emphasis-position: inherit; text-emphasis-position: initial; text-emphasis-position: unset; أمثلة ...

Python/pathlib/Path/read text

التابع PurePath.read_text في بايثون يعيد هذا التابع المحتوى النصي للملف كسلسلة نصية تم استحداث هذا التابع في النسخة 3.5 البنية العامة >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' المعاملات تأخذ الوسطاء الاختيارية نفس المعاني الخاصة بها في التابع المضمن open القيمة المعادة يعيد هذا التابع المحتوى النصي للملف كسلسلة نصية أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' انظر أيضًا مصادر

HTML/Topics/Inline Text Semantics

تُستخدَم العناصر النصية لإضفاء معنى أو بنية أو تنسيق إلى كلمة أو سطر أو أي نص. العنصر الوصف <a> يُنشِئ العنصر <a> (اسمه اختصار للكلمة anchor) رابطًا فائقًا (hyperlink) لصفحات الويب الأخرى أو للملفات أو لأقسم الصفحة الحالية أو لعنواين البريد الإلكتروني. <abbr> تمثيل اختصار وتوفير شرح له، وعند إضافة الشرح يجب أن تحتوي الخاصية title على الشرح الكامل لهذا الاختصار فقط ولا يسمح بأي قيمة أخرى. <b> تمثيل نص يختلف تنسيقه عن تنسيق النص العادي، دون أن يكون له أهمية أو أولوية على بقية النص، ويُعرَض عادةً ...

Python/pathlib/Path/write text

التابع Path.write_text يفتح الملف المٌشار إليه بالنمط النصي، ويكتب البيانات فيه ثم يُغلقه. >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' <span> </span> <span> </span> تابع مُستحدث في السخة 3.5.

المُنشِئ الحافظ للنوع (Type-Safe Builder) في لغة Kotlin

المُنشِئ الحافظ للنوع (Type-Safe Builder) يُتاح بناءُ المُنشِئ الستاتيكيّ الحافظ للنوع في لغة Kotlin باستخدام الدوال ذات التسمية المعبِّرة كمُنشِئ (builder) بالإضافة إلى قيم حرفية (literals) للدوال مع المستقبِل (receiver)، إذ يسمح المُنشِئ الحافظ للنوع ببناء لغات مُخصَّصة المجال (DSL) بالاعتماد على Kotlin بما يتناسب مع إنشاء بُنى البيانات الهرميّة المعقَّدة بطريقةٍ نصف تصريحية (semi-declarative)، وهذه بعض الأمثلة من حالات استخدامه: توليد ترميزٍ (markup) باستخدام شيفرة Kotlin مثل HTML أو XML تصميم أجزاء واجهات المستخدم (UI) برمجيًا مثل Anko ضبط ...

الخاصّيّات المُعمَّمة (Delegated Properties) في لغة Kotlin

 استخدام الخاصّيّات المُعمَّمة تستطيع في لغة Kotlin تعريف استخدام (implement) الخاصّيّات يدويًا مرارًا وتكرارًا بكل مرةٍ تحتاجها، ولكن من الأسهل تعريف استخدامها مرةً واحدةً وتخزين هذا التعريف في المكتبة (library) للاستفادة منه كلما دعت الحاجة، وهذا يشمل: الخاصّيّات الكسولة (Lazy property): تُحسب قيمتها مرةً واحدةً فقط وذلك عند الوصول إليها للمرّة الأولى. الخاصّيّات المُراقَبة (observable property): إذ يُستدعَى مسؤول الانتظار (listener) عند حدوث أي تغييرٍ في الخاصّيّة. تخزين الخاصّيّات في map بدلًا من حقلٍ منفصلٍ لكلِّ منها. وتشمل لغة Kotlin ...

أنواع البيانات (Data Types) في Kotlin

إن كلَّ عنصرٍ في Kotlin يعد كائنًا إذ يمكن استدعاء الدوال (member functions) والخاصّيّات (properties) عبر أي متغيِّر (variable)، ولبعض الأنواع تمثيلها الداخلي الخاص بها؛ فعلى سبيل المثال تُمثَّل الأعداد والمحارف والقيم المنطقية (boolean) كقيمٍ أساسيّةٍ أثناء التشغيل (runtime) ولكنها بالنسبة للمستخدم مجرّد أصنافٍ عادية، وتناقش هذه الصفحة الأنواع الرئيسيّة للبيانات في Kotlin وهي: الأعداد، والمحارف، والقيم المنطقية (boolean)، والمصفوفات، والسلاسل النصيّة. الأعداد (Numbers) تتعامل لغة Kotlin مع البيانات العدديّة بطريقةٍ مماثلةٍ للغة Java ولكن بفوارق بسيطة، فلا تدعم مثلًا ...

المحدد ‎‎‎:text‎ في jQuery

المحدد ‎:text الوصف يحدِّد جميع عناصر الإدخال <input> ذات النوع text. ‎jQuery( ":text" )‎ أُضيف مع الإصدار: 1.0. يسمح لنا المحدِّد ‎$( ":text" )‎ بتحديد جميع عناصر <input type="text"‎>. يفضَّل أن يُسبق هذا المحدِّد، كما في محدِّدات الصنف الزائف (pseudo-class selectors) التي تبدأ بنقطتين ":"، باسم وسمٍ (tag) أو محدِّد آخر وإلا سيُسبق بالمحدِّد العام "*" بشكل ضمني. بعبارة أخرى، استعمال المحدِّد بالشكل ‎$( ":text" )‎ يكافئ تمامًا ‎$( "*:text" )‎، لذا يجب استعمال ‎$( "input:text" )‎ مثلًا عوضًا عن ...

الدالة CharSequence.indexOf()‎ في Kotlin

تجلب الدالة indexOf()‎ فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.indexOf( char: Char, startIndex: Int = 0, ignoreCase: Boolean = false ): Int fun CharSequence.indexOf( string: String, startIndex: Int = 0, ignoreCase: Boolean = false ): Int المعاملات char المحرف المراد البحث عنه ضمن سلسلة من المحارف. startIndex السلسلة النصية المراد البحث عنها ضمن ...

الدالة Regex.toString()‎ في Kotlin

تحول الدالة toString()‎ تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي). البنية العامة fun toString(): String القيمة المعادة تعاد سلسلة نصية تمثل التعبير النمطي المعطى. أمثلة استعمال الدالة toString()‎ لتحويل تعبير نمطيّ إلى سلسلة نصية: fun main(args: Array<String>) { // يطابق التعبير النمطي التالي القيم العددية val reg = Regex("""-?\d+(\.\d+)?""") println(reg.toString()) // => -?\d+(\.\d+)? } انظر أيضًا الدالة toPattern()‎: تحول كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط).  ...

الدالة substringAfter()‎ في Kotlin

تجلب الدالة substringAfter()‎ كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.substringAfter( delimiter: Char, missingDelimiterValue: String = this ): String (source) fun String.substringAfter( delimiter: String, missingDelimiterValue: String = this ): String المعاملات delimiter المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع بعدها. missingDelimiterValue السلسلة النصية التي ستعاد في حال لم يكن المعامل delimiter موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: this (أي السلسلة النصية المعطاة نفسها). القيم المعادة ...

الدالة Regex.matchEntire()‎ في Kotlin

تحاول الدالة matchEntire()‎ مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. البنية العامة actual fun matchEntire(input: CharSequence): MatchResult? المعاملات input سلسلة المحارف التي يراد تطابق جميع محارفها مع التعبير النمطي المعطى. القيمة المعادة تعاد نسخةٌ من الصنف MatchResult تحتوي على جميع محارف المعامل input إن تطابقت جميع تلك المحارف مع التعبير النمطي المعطى، أو تعاد القيمة null خلاف ذلك. أمثلة استعمال الدالة matchEntire()‎ لمعرفة سلسلة المحارف المطابقة للتعبير النمطي ‎-?\d+(\.\d+)?‎ بشكل كامل: fun main(args: Array<String>) { ...

الدالة CharSequence.groupingBy()‎ في Kotlin

تُنشئ الدالة groupingBy()‎ موردًا (source) من النوع Grouping من سلسلة المحارف التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل محرف. البنية العامة inline fun <K> CharSequence.groupingBy( crossinline keySelector: (Char) -> K ): Grouping<Char, K> الإصدار المطلوب: kotlin 1.1. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات keySelector الدالة المستعملة في استخلاص مفتاح من كل محرف. القيم المعادة يُعاد موردٌ من النوع Grouping من المصفوفة أو المجموعة المعطاة لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold). أمثلة ...

الدالة Regex.find()‎ في Kotlin

تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين. البنية العامة actual fun find( input: CharSequence, startIndex: Int = 0 ): MatchResult? تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء ...

الدالة CharSequence.single()‎ في Kotlin

تتحقَّق الدالة single()‎ من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك. البنية العامة fun CharSequence.single(): Char  inline fun CharSequence.single(     predicate: (Char) -> Boolean ): Char وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالة تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له. القيم المعادة يعاد المحرف ...

الدالة toTitleCase()‎ في Kotlin

تحوّل الدالة toTitleCase()‎ المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. البنية العامة inline fun Char.toTitleCase(): Char وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد الحرف Char المعطى بعد تحويله إلى حرف عنواني. أمثلة تُعرّف الشيفرة الآتية حرفًا باسم x ثم تستدعي الدالة toTitleCase()‎ معه، ثم تطبع الناتج: fun main(args: Array<String>) { ...

الدالة zip()‎ في Kotlin

تنشئ الدالة zip()‎ أزواجًا من محارف سلسلتين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة. البنية العامة infix fun CharSequence.zip( other: CharSequence ): List<Pair<Char, Char>> إن استدعيت الدالة zip()‎ مع سلسلة من المحارف ومع تمرير سلسلة أخرى إليها كمعامل، فستشكل أزواجًا من محارف هاتين السلسلتين لها نفس الفهرس وتضعها في قائمة؛ طول القائمة المعادة يساوي طول أٌقصرهما. inline fun <V> CharSequence.zip( other: CharSequence, transform: (a: Char, b: Char) -> V ): List<V> وإن ...

الدالة isLetterOrDigit()‎ في Kotlin

تتحقق الدالة isLetterOrDigit()‎ إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا. البنية العامة inline fun Char.isLetterOrDigit(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف (character) المعطى حرفًا أبجديًا أو رقمًا، أو تعاد القيمة false خلاف ذلك. أمثلة استعمال الدالة isLetterOrDigit()‎ للتحقق من كون المحرف المراد استعماله حرفًا أبجديًا أو رقمًا: fun main(args: Array<String>) { val ...

الدالة CharSequence.contains()‎ في Kotlin

تتحقق الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها. إن مُرِّر تعبير نمطي إلى هذه الدالة، فستتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك التعبير النمطي. البنية العامة operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean inline operator fun ...

الدالة String.compareTo()‎ في Kotlin

توازن الدالة compareTo()‎ بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف. البنية العامة fun String.compareTo( other: String, ignoreCase: Boolean = false ): Int وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات other السلسلة النصية المراد موازنتها مع السلسلة النصية المعطاة. ignoreCase قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء الموازنة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان. القيم المعادة تعاد ...

الدالة Regex.containsMatchIn()‎ في Kotlin

تتحقق الدالة containsMatchIn()‎ إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه. البنية العامة actual fun containsMatchIn(input: CharSequence): Boolean المعاملات input سلسلة المحارف التي يراد التحقق من تطابق أحد محارفها -على الأقل- مع التعبير النمطي المعطى. القيمة المعادة تعاد القيمة true المنطقية إن بإمكان التعبير النمطي المعطى مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف input، أو تعاد القيمة false خلاف ذلك. أمثلة تنشئ الدالة Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة الأعداد، ثم تُستعمَل ...

الدالة replaceFirst()‎ في Kotlin

تبدل الدالة replaceFirst()‎ محرفًا جديدًا مكان أول ظهور لمحرف قديم، أو سلسلة نصية جديدة مكان أول ظهور لسلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان أول ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف. البنية العامة actual fun String.replaceFirst( oldChar: Char, newChar: Char, ignoreCase: Boolean = false ): String actual fun String.replaceFirst( oldValue: String, newValue: String, ...

الدالة isJavaIdentifierPart()‎ في Kotlin

تتحقق الدالة isJavaIdentifierPart()‎ إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف. البنية العامة inline fun Char.isJavaIdentifierPart(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان من المحتمل أن يكون المحرف المعطى جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف، أو القيمة false خلاف ذلك. أمثلة ...

الصنف ‎‎MatchGroup‎ في Kotlin

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.   الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...

الدالة Regex_0 في Kotlin

أصبحت الدالة Regex_0 مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility). تنشئ هذه الدالة تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية والخيارات المُمرّرة إليها. البنية العامة fun Regex_0(pattern: String, option: RegexOption): Regex منصة التشغيل المطلوبة: JS. المعاملات pattern سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي. option كائن من النوع RegexOption يحوي خيارًا واحدًا من خيارات التعابير النمطية. القيم المعادة يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للخيار option. انظر أيضًا الدالة Regex()‎: تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه. الدالة containsMatchIn()‎: تتحقق ...

الدالة trimEnd()‎ في Kotlin

تحذف الدالة trimEnd()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.   البنية العامة inline fun CharSequence.trimEnd( predicate: (Char) -> Boolean ): CharSequence inline fun String.trimEnd( predicate: (Char) -> Boolean ): String fun CharSequence.trimEnd(vararg chars: Char): CharSequence fun String.trimEnd(vararg chars: Char): String fun CharSequence.trimEnd(): CharSequence inline fun String.trimEnd(): String يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات ...

الدالة String.intern()‎ في Kotlin

تعيد الدالة intern()‎ تمثيلًا معياريًّا (canonical representation) للسلسلة النصية التي استُدعيت معها. البنية العامة inline fun String.intern(): String بيئة التشغيل المطلوبة: JVM. القيم المعادة تعاد سلسلة نصية. أمثلة مثالٌ على استعمال الدالة ()intern: fun main(args: Array<String>) { var str = "hsoub" print(str.intern()) // hsoub } انظر أيضًا الدالة format()‎: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. مصادر صفحة الدالة String.intern()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

الصنف ‎‎Destructured‎ في Kotlin

يوفر الصنف Destructured مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. يسمح الإسناد بالتفكيك باستخراج القيم الموجودة في المصفوفات أو المجموعات أو خاصيات أحد الكائنات ...إلخ. إلى متغيرات مستقلة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. إن كانت المجموعة في التعبير النمطي اختيارية ولم ترصد هذه المجموعة أي عملية تطابق تُذكر، فيمكن حينئذٍ أن تساوي قيمة المكون المقابل لهذه المجموعة سلسلةً نصيةً فارغةً. class Destructured الخاصيات match الدوال component1 component2 component3 component4 component5 component6 component7 ...

الدالة trim()‎ في Kotlin

تحذف الدالة trim()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.trim( predicate: (Char) -> Boolean ): CharSequence inline fun String.trim(predicate: (Char) -> Boolean): String fun CharSequence.trim(vararg chars: Char): CharSequence fun String.trim(vararg chars: Char): String fun CharSequence.trim(): CharSequence inline fun String.trim(): String يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق ...

الدالة CharSequence.chunkedSequence()‎ في Kotlin

تقطِّع الدالة chunkedSequence()‎ سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة. البنية العامة fun CharSequence.chunkedSequence(size: Int): Sequence<String> fun <R> CharSequence.chunkedSequence( size: Int, transform: (CharSequence) -> R ): Sequence<R> بيئة التشغيل المطلوبة: Kotlin 1.2. المعاملات size عدد صحيح يمثل عدد العناصر المراد اقتطاعها ووضعها في كل سلسلة نصية. يجب أن يكون هذا ...

الدالة filterIndexed()‎ في Kotlin

ترشِّح الدالة filterIndexed()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته. البنية العامة inline fun CharSequence.filterIndexed( predicate: (index: Int, Char) -> Boolean ): CharSequence inline fun String.filterIndexed( predicate: (index: Int, Char) -> Boolean ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. يمرر إلى هذه الدالة فهرس المحرف وقيمته أيضًا وتعيد قيمة ...

الدالة toIntOrNull()‎ في Kotlin

تحلّل الدالة toIntOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. البنية العامة fun String.toIntOrNull(): Int? تحلّل الدالة toIntOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، تعيد الدالة القيمة null. fun String.toIntOrNull(radix: Int): Int? بيئة التشغيل المطلوبة: Kotlin 1.1. تحلّل الدالة toIntOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، تعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...

الدالة toSet()‎ في Kotlin

تضيف الدالة toSet()‎ كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر. تحافظ المجموعة المُعادة على ترتيب التكرار (element iteration order) في سلسلة المحارف الأصلية. البنية العامة fun CharSequence.toSet(): Set<Char> القيم المعادة تعاد مجموعة من النوع Set تحوي كل محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة toSet()‎: fun main(args: Array<String>) { println("Hello, world!".toSet()) // [H, e, l, o, ,, , w, r, d, !] ...

الواجهة ‎‎Appendable‎ في Kotlin

actual typealias Appendable = Appendable المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.  الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...

الصنف ‎‎StringBuilder‎ في Kotlin

actual typealias StringBuilder = StringBuilder منصة التشغيل والإصدار المطلوبان: JVM ،Kotlin 1.1 actual class StringBuilder : Appendable, CharSequence منصة التشغيل المطلوبة: JS. الدوال البانية (Constructors) <init> تنشئ الدالة StringBuilder()‎ كائنًا من النوع StringBuilder. الخاصيات length تمثل هذه الخاصية حجم الكائن StringBuilder (عدد محارفه) الذي استدعي معها. الدوال append تضيف هذه الدالة محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. get تجلب هذه الدالة محرفًا ذا فهرس محدَّدٍ من سلسلة محارف الكائن StringBuilder. reverse تعكس هذه الدالة ترتيب محارف الكائن StringBuilder. subSequence تقتطع هذه الدالة جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها. toString تحول هذه ...

الدالة Text.startsWith()‎ في Kotlin

تتحقق الدالة startsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.   البنية العامة fun String.startsWith( prefix: String, ignoreCase: Boolean = false ): Boolean fun CharSequence.startsWith( prefix: CharSequence, ignoreCase: Boolean = false ): Boolean تتحقق الدالة startsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بالبادئة prefix.   fun String.startsWith( prefix: String, startIndex: Int, ...

الواجهة ‎‎MatchNamedGroupCollection‎ في Kotlin

توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم Regex ذلك. interface MatchNamedGroupCollection : MatchGroupCollection الإصدار المطلوب: kotlin 1.1. الدوال (Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الدوال الموروثة (Inherited Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الخاصيات الإضافية (Extension Properties) indices تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). الدوال ...

الدالة regionMatches()‎ في Kotlin

تتحقق الدالة regionMatches()‎ من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا. البنية العامة actual fun CharSequence.regionMatches( thisOffset: Int, other: CharSequence, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean fun String.regionMatches( thisOffset: Int, other: String, otherOffset: Int, length: Int, ...

الدالة Regex.matches()‎ في Kotlin

تتحقق الدالة matches()‎ من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. البنية العامة infix actual fun matches(input: CharSequence): Boolean وجود الكلمة المفتاحية infix يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات input سلسلة من المحارف التي يراد أن يُتحقَق من مطابقتها كلِّيًا لتعبير نمطي معين. القيمة المعادة تعاد القيمة true إن تطابقت جميع محارف السلسلة input مع التعبير النمطي المعطى. أمثلة استعمال الدالة matches()‎ للتحقق من مطابقة ...

الدالة CharSequence.maxBy()‎ في Kotlin

تجلب الدالة maxBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. البنية العامة inline fun <R : Comparable<R>> CharSequence.maxBy( selector: (Char) -> R ): Char? وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات selector دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له. القيم المعادة يعاد المحرف من السلسلة المعطاة والذي أعطى أكبر قيمة عند تطبيق الدالة selector عليه، أو ...

الدالة toLong()‎ في Kotlin

تحلّل الدالة toLong()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. البنية العامة inline actual fun String.toLong(): Long تحلّل الدالة toLong()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline actual fun String.toLong(radix: Int): Long الإصدار المطلوب: Kotlin 1.1. تحلّل الدالة toLong()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما في حال كان المعامل radix المعطى أساسًا غير صالح ...

الدالة subSequence()‎ في Kotlin

تعيد الدالة subSequence()‎ جزءًا محددًا من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.subSequence(range: IntRange): CharSequence inline fun String.subSequence( start: Int, end: Int ): CharSequence هذا الشكل من الدالة قد أُهمِل. المعاملات range مجال من النوع IntRange يحدد الجزء المراد جلبه من سلسلة المحارف المعطاة. start عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه. end عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه. القيم المعادة تعاد ...

الدالة CharSequence.count()‎ في Kotlin

تَعُدُّ الدالة count()‎ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين. البنية العامة inline fun CharSequence.count(): Int inline fun CharSequence.count( predicate: (Char) -> Boolean ): Int وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات predicte دالةٌ تمثل شرط معين يطبق على كل محرف من محارف السلسلة النصية المعطاة، وتعيد مع كل واحد منها قيمة منطقية. القيم المعادة يعاد عدد صحيح يمثل عدد محارف السلسلة المعطاة ...

الدالة CharSequence.lastIndexOfAny()‎ في Kotlin

تجلب الدالة lastIndexOfAny()‎ فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.lastIndexOfAny( chars: CharArray, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int fun CharSequence.lastIndexOfAny( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int المعاملات chars مصفوفة من المحارف التي يراد البحث عنها ضمن سلسلة المحارف المعطاة. strings مجموعةٌ من سلاسل نصية ...

الدالة toHashSet()‎ في Kotlin

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها. البنية العامة fun CharSequence.toHashSet(): HashSet<Char> القيم المعادة يعاد كائن من النوع HashSet يحوي كل محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة toHashSet()‎: fun main(args: Array<String>) { println("hsoub".toHashSet()) // [h, b, s, u, o] println("32.87".toHashSet()) // [8, 2, 3, ., 7] println("wiki".toHashSet()) // [i, k, w] } ...

الدالة String.decapitalize()‎ في Kotlin

تحول الدالة decapitalize()‎ الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف صغير (lowercase). البنية العامة actual fun String.decapitalize(): String القيم المعادة تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف صغير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا صغيرًا أو كانت السلسلة فارغةً.  أمثلة مثالٌ على استعمال الدالة ()decapitalize: fun main(args: Array<String>) { println("abcd".decapitalize()) // abcd println("Abcd".decapitalize()) // abcd } انظر أيضًا الدالة ...

الدالة toUpperCase()‎ في Kotlin

تحوّل الدالة toUpperCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase). البنية العامة inline actual fun Char.toUpperCase(): Char inline actual fun String.toUpperCase(): String inline fun String.toUpperCase(locale: Locale): String المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات locale المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. القيم المعادة يعاد المحرف Char المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية ...

الدالة CharSequence.commonPrefixWith()‎ في Kotlin

تعيد الدالة commonPrefixWith()‎ أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك. البنية العامة fun CharSequence.commonPrefixWith( other: CharSequence, ignoreCase: Boolean = false ): String المعاملات Other سلسلة المحارف التي يراد جلب البادئة المشتركة بينها وبين سلسلة المحارف المعطاة. ignoreCase قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن بادئة مشتركة. ...

الدالة toString()‎ في Kotlin

تحول الدالة toString()‎ العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية. البنية العامة inline actual fun Byte.toString(radix: Int): String inline actual fun Short.toString(radix: Int): String inline actual fun Int.toString(radix: Int): String inline actual fun Long.toString(radix: Int): String الإصدار المطلوب: Kotlin 1.1. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات radix عدد صحيح بين 2 و 36 الذي يُمثِّل الأساس المستعمل في تحويل القيمة العددية إلى سلسلة نصية؛ لاستخدام نظام العد العشري (decimal) ...

الدالة padEnd()‎ في Kotlin

تحشو الدالة padEnd()‎ نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد. البنية العامة fun CharSequence.padEnd( length: Int, padChar: Char = ' ' ): CharSequence fun String.padEnd(length: Int, padChar: Char = ' '): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات length طول اللاحقة المراد ملؤها بالمحرف padChar. padChar المحرف المراد إضافته إلى نهاية سلسلة من المحارف أو سلسلة نصية. القيمة الافتراضية له هي: ' ' ...

الدالة isDigit()‎ في Kotlin

تتحقق الدالة isDigit()‎ إن كان المحرف الذي استٌدعيت معه رقمًا أم لا. البنية العامة inline fun Char.isDigit(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن حال كان المحرف المعطى رقمًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isDigit()‎ للتحقق من عدَّة محارف إن كانت رقمًا أم لا: fun main(args: Array<String>) { val x = 'a' ...

الدالة CharSequence.groupByTo()‎ في Kotlin

تشبه الدالة groupByTo()‎ الدالة groupBy()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة inline fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K ): M inline fun <K, V, M : MutableMap<in K, MutableList<V>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M إن مُرِّر إلى الدالة groupBy()‎ المعامل destination والمعامل keySelector فقط، فستُجمّع محارف السلسلة المعطاة بحسب المفتاح الذي تعيده الدالة ...

الدالة isWhitespace()‎ في Kotlin

تتحقق الدالة isWhitespace()‎ إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace). البنية العامة actual fun Char.isWhitespace(): Boolean القيم المعادة تعاد القيمة true إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isWhitespace()‎ لمعرفة أي المحرفين التاليين هو مسافة بيضاء: fun main(args: Array<String>) { val x = '_' val y = ' ' print(x.isWhitespace()) // false ...

الدالة Regex.split()‎ في Kotlin

تقتطع الدالة split()‎ المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها. البنية العامة actual fun split( input: CharSequence, limit: Int = 0 ): List<String> المعاملات input سلسلة المحارف المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها. limit عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى. القيمة المعادة تعاد قائمة تضم المحارف الموجودة ...

الدالة windowed()‎ في Kotlin

تعيد الدالة windowed()‎ قائمة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة. البنية العامة fun CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<String> الإصدار المطلوب: Kotlin 1.2. تعيد الدالة windowed()‎ قائمة مكونة من سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف ...

الدالة Appendable.append()‎ في Kotlin

تضيف الدالة append()‎ المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. البنية العامة abstract actual fun append(csq: CharSequence?): Appendable abstract actual fun append( csq: CharSequence?, start: Int, end: Int ): Appendable abstract actual fun append(c: Char): Appendable بيئة التشغيل المطلوبة: JS. المعاملات csq سلسلة من المحارف التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى. start عدد صحيح يحدد فهرس المحرف الذي يمثل بداية ...

الدالة trimMargin()‎ في Kotlin

تحذف الدالة trimMargin()‎ جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين (blanks)؛ أي مُكوّنان من مسافات بيضاء (whitespaces). لا تؤثر الدالةُ على الاسطر التي لا تحوي القيمة المحددة بالمعامل marginPrefix المعطى، باستثناء الأسطر البيضاء الأولى والأخيرة. البنية العامة fun String.trimMargin(marginPrefix: String = "|"): String المعاملات marginPrefix سلسلة نصية غير فارغة -أي لا تحوي أية مسافة بيضاة- تستعمل كمحدد للهامش المراد حذفه. القيمة الافتراضية هي: | ...

الدالة replaceAfter()‎ في Kotlin

تبدِّل الدالة replaceAfter()‎ سلسلة نصية مكان كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.replaceAfter( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String fun String.replaceAfter( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String المعاملات delimiter المحرف أو السلسلة النصية التي يراد استبدال كامل الجزء الواقع بعدها. replacement ...

الدالة CharSequence.sumByDouble()‎ في Kotlin

تجمع الدالة sumByDouble()‎ جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumByDouble()‎ والدالة sumBy()‎ هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy()‎ عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممررة إلى sumByDouble()‎ عددًا عشريًّا مضاعفًا (double). البنية العامة inline fun CharSequence.sumByDouble( selector: (Char) -> Double ): Double يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي ...

الدالة CharSequence.forEachIndexed()‎ في Kotlin

تُنفّد الدالةُ forEachIndexed()‎ الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها وعلى فهرس ذلك المحرف. البنية العامة inline fun CharSequence.forEachIndexed( action: (index: Int, Char) -> Unit) وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات action الدالة المراد تنفيذها مع كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف index وقيمته Char. أمثلة مثالٌ على استعمال الدالة ()forEachIndexed: fun main(args: Array<String>) { val str = "Hsoubwiki" ...

الدالة removeRange()‎ في Kotlin

تحذف الدالة removeRange()‎ مجالًا محددًا من سلسلة المحارف أو السلسلة النصية التي استٌدعيت معها. البنية العامة fun CharSequence.removeRange( startIndex: Int, endIndex: Int ): CharSequence inline fun String.removeRange( startIndex: Int, endIndex: Int ): String fun CharSequence.removeRange(range: IntRange): CharSequence inline fun String.removeRange(range: IntRange): String المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد حذفه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد حذفه (لا ...

الدالة text.isISOControl()‎ في Kotlin

تتحقق الدالة isISOControl()‎ إن كان المحرف الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎). البنية العامة inline fun Char.isISOControl(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى هو أحد محارف تحكمISO ‎‎‏، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isISOControl()‎ لمعرفة أيُّ المحرفين التاليين هو من أحد محارف تحكم ISO: fun main(args: Array<String>) { ...

الدالة isNotEmpty()‎ في Kotlin

تتحقق الدالة isNotEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة. البنية العامة inline fun CharSequence.isNotEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف المعطاة غير فارغة، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isNotEmpty()‎: fun main(args: Array<String>) { print("hsoub".isNotEmpty()) // true print(" ".isNotEmpty()) // true ...

الخاصية MatchGroup.range في Kotlin

تمثل الخاصية MatchGroup.range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. البنية العامة val range: IntRange المنصة المطلوبة: JVM. القيم المعادة يعاد مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.value: تمثل قيمة مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.range في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

الدالة CharSequence.lastIndexOf()‎ في Kotlin

تجلب الدالة lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.indexOf( char: Char, startIndex: Int = 0, ignoreCase: Boolean = false ): Int fun CharSequence.indexOf( string: String, startIndex: Int = 0, ignoreCase: Boolean = false ): Int المعاملات char المحرف المراد البحث عنه ضمن سلسلة من المحارف. startIndex السلسلة النصية المراد البحث عنها ضمن سلسلة ...

الدالة StringBuilder.reverse()‎ في Kotlin

تعكس الدالة reverse()‎ ترتيب محارف الكائن StringBuilder. البنية العامة actual fun reverse(): StringBuilder منصة التشغيل المطلوبة: JS. القيمة المعادة يعاد الكائن StringBuilder نفسه المعطى بعد عكس ترتيب محارفه. أمثلة استعمال الدالة reverse()‎ لعكس ترتيب محارف كائن من النوع StringBuilder: fun main(args: Array<String>) { val sb = StringBuilder("hsoub") println(sb.reverse()) // => buosh } انظر أيضًا الدالة append()‎: تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. الدالة toString()‎: تحول الكائن StringBuilder إلى ...

الدالة drop()‎ في Kotlin

تُزيِل الدالة drop()‎ أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.drop(n: Int): CharSequence fun String.drop(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول n محرف. أمثلة مثالٌ عن استعمال الدالة ()drop: fun main(args: Array<String>) { val str = "wiki Hsoub" println(str.drop(0)) // wiki Hsoub ...

الدالة plus()‎ في Kotlin

تضيف الدالة plus()‎ المحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها. البنية العامة inline operator fun Char.plus(other: String): String وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). يدل أيضًا وجود الكلمة المفتاحيّة operator على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى. القيم المعادة تعاد السلسلة النصية other بعد إضافة المحرف المعطى إلى بدايتها. أمثلة استعمال الدالة plus()‎ لإضافة ...

الخاصية Char.directionality في Kotlin

تعيد الخاصية Char.directionality قيمة اتجاهية اليونيكود (Unicode directionality) للمحرف الذي استُدعيت معه. البنية العامة val Char.directionality: CharDirectionality المنصة المطلوبة: JVM. القيم المعادة تعاد قيمة اتجاهية اليونيكود للمحرف المعطى. مثال استعمال الخاصية directionality لمعرفة اتجاهية عدة محارف: fun main(args: Array<String>) { val x = 'a' val y = 'أ' val z = '4' println(x.directionality) // LEFT_TO_RIGHT println(y.directionality) // RIGHT_TO_LEFT_ARABIC println(z.directionality) // EUROPEAN_NUMBER } انظر أيضًا ...

الدالة CharSequence.associateBy()‎ في Kotlin

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة. البنية العامة inline fun <K> CharSequence.associateBy( keySelector: (Char) -> K ): Map<K, Char> inline fun <K, V> CharSequence.associateBy( ...

الدالة CharSequence.lastOrNull()‎ في Kotlin

تجلب الدالة lastOrNull()‎ آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت سلسلة المحارف التي استُدعيت الدالة lastOrNull()‎ معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null. البنية العامة fun CharSequence.lastOrNull(): Char? inline fun CharSequence.lastOrNull( predicate: (Char) -> Boolean ): Char? وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط المراد ...

الدالة CharSequence.foldIndexed()‎ في Kotlin

تجمِّع الدالة foldIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): R (source) وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...

الواجهة ‎‎Appendable‎ في Kotlin

actual typealias Appendable = Appendable المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.  الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...

الخاصية MatchResult.destructured‎ في Kotlin

تمثل الخاصية MatchResult.destructured‎ نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. البنية العامة open val destructured: Destructured القيمة المعادة تعاد نسخةٌ من الصنف Destructured. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم regex لتفكيك مسارات الملفات إلى ثلاث مُركّبات: المجلد (directory) واسم الملف (fileName) والامتداد (extension)، ثم نعرّف سلسلة نصية باسم fullPath تحتوي مسار أحد الملفات، ثم نستخرج من fullPath مجموعات النتائج عبر استدعاء الدالة ...

الدالة CharSequence.flatMap()‎ في Kotlin

تعيد الدالة flatMap()‎ قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun <R> CharSequence.flatMap( transform: (Char) -> Iterable<R> ): List<R> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة، وتعيد قيمة معينة تحل مكانه. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform‎ على كل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()flatMap: fun main(args: ...

الدالة String.format()‎ في Kotlin

تنسِّق الدالة format()‎ سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. البنية العامة inline fun String.format(vararg args: Any?): String بيئة التشغيل المطلوبة: JVM. تستعمل format()‎ السلسلة النصية التي استُدعيت معها كسلسلة تنسيق نصية (format string) وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). inline fun String.Companion.format( format: String, vararg args: Any? ): String بيئة التشغيل المطلوبة: JVM. تستعمل الدالة format()‎ السلسلة النصية format المُمرّرة كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن ...

الدالة isJavaIdentifierPart()‎ في Kotlin

تتحقق الدالة isJavaIdentifierPart()‎ إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف. البنية العامة inline fun Char.isJavaIdentifierPart(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان من المحتمل أن يكون المحرف المعطى جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف، أو القيمة false خلاف ذلك. أمثلة ...

الدالة CharArray.get()‎ في Kotlin

يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): Char وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال الدالة get()‎ لجلب العنصر الثالث من مصفوفة من النوع CharArray: fun main(args: Array<String>) { val int: (Int) -> ...

الصنف ‎‎MatchGroup‎ في Kotlin

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.   الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...

الدالة trimStart()‎ في Kotlin

تحذف الدالة trimStart()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.     البنية العامة inline fun CharSequence.trimStart( predicate: (Char) -> Boolean ): CharSequence inline fun String.trimStart(predicate: (Char) -> Boolean): String fun CharSequence.trimStart(vararg chars: Char): CharSequence fun String.trimStart(vararg chars: Char): String fun CharSequence.trimStart(): CharSequence inline fun String.trimStart(): String يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق ...

عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).