نتائج البحث

تتيح لغة Kotlin إمكانيّة استهداف لغة JavaScript من خلال تحويل (transpiling) شيفرات Kotlin إلى ما يماثلها في JavaScript ؛ إذ تستهدف بالوقت الحاليّ معيارECMAScript 5.1، ومن المُخطَّط له أيضًا التوافق مع معيار ECMAScript 2015 لاحقًا. عند استخدام لغة Kotlin بهدف كتابة شيفرات JavaScript فستُحوَّل الشيفرات المكتوبة بلغة Kotlin (بعدِّها جزءًا من المشروع والمكتبة القياسيّة في Kotlin) إلى شيفرة JavaScript، ولكنّ هذا لا يشمل أيًّا ممّا يتعلَّق ببيئة JDK أو JVM أو Java أو أيّ من منصّاتها أو مكتباتها المُستخدَمة، ويُستبعَد ...

تحذف الدالة distinct()‎ العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. البنية العامة تستدعى الدالة distinct()‎ مع مصفوفة: fun <T> Array<out T>.distinct(): List<T> fun ByteArray.distinct(): List<Byte> fun ShortArray.distinct(): List<Short> fun IntArray.distinct(): List<Int> fun LongArray.distinct(): List<Long> fun FloatArray.distinct(): List<Float> fun DoubleArray.distinct(): List<Double> fun BooleanArray.distinct(): List<Boolean> fun CharArray.distinct(): List<Char> وتستدعى مع مجموعة: fun <T> Iterable<T>.distinct(): List<T> القيم المعادة تُعاد قائمة تحتوي على عناصر المصفوفة ...

تتحقَّق الدالة isNotEmpty()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها فارغةً أم لا. تعمل هذه الدالة بشكل معاكس للدالة isEmpty()‎. البنية العامة يمكن استدعاء الدالة isNotEmpty()‎ مع المصفوفات والمجموعات: inline fun <T> Array<out T>.isNotEmpty(): Boolean inline fun ByteArray.isNotEmpty(): Boolean inline fun ShortArray.isNotEmpty(): Boolean inline fun IntArray.isNotEmpty(): Boolean inline fun LongArray.isNotEmpty(): Boolean inline fun FloatArray.isNotEmpty(): Boolean inline fun DoubleArray.isNotEmpty(): Boolean inline fun BooleanArray.isNotEmpty(): Boolean inline fun CharArray.isNotEmpty(): Boolean inline fun <T> Collection<T>.isNotEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من ...

الانعكاس هو مجموعةٌ من مميّزات اللغة والمكتبات التي تسمح بمراقبة بُنية البرنامج أثناء التنفيذ، إذ تولي لغة Kotlin أهميةً كبرى لكلٍّ من الدوال (functions) والخاصّيّات (properties) وتستمر بتتبُّعها (مثل معرفة اسم أو نوع الخاصّيّة والدالة أثناء التنفيذ) وهذا يرتبط ارتباطًا وثيقًا مع استخدام النمط الوظائفيّ (functional) أو التفاعليّ (reactive). ملاحظة: إن الجزء التنفيذيّ (runtime component) المطلوب في منصّة العمل Java لاستخدام ميزات الانعكاس يُوزَّع كملف ‎.jar مستقلٍّ (kotlin-reflect.jar) وذلك بهدف تخفيض حجم التخزين المطلوب لمكتبة التنفيذ (runtime library) للتطبيقات غير ...

تجلب الدالة lastIndexOf()‎ فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة lastIndexOf()‎ مع المصفوفات، والمجموعات والقوائم: fun <T> Array<out T>.lastIndexOf(element: T): Int fun ByteArray.lastIndexOf(element: Byte): Int fun ShortArray.lastIndexOf(element: Short): Int fun IntArray.lastIndexOf(element: Int): Int fun LongArray.lastIndexOf(element: Long): Int fun FloatArray.lastIndexOf(element: Float): Int fun DoubleArray.lastIndexOf(element: Double): Int fun BooleanArray.lastIndexOf(element: Boolean): Int fun CharArray.lastIndexOf(element: Char): Int fun <T> Iterable<T>.lastIndexOf(element: T): Int fun <T> List<T>.lastIndexOf(element: T): Int القيم المعادة يعاد فهرس آخر ظهور للعنصر المعطى والموجود في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة ‎-1 إن لم ...

تعيد الدالة orEmpty()‎ المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. البنية العامة يمكن استدعاء الدالة orEmpty()‎ مع المصفوفات والمجموعات والقوائم والخرائط والمجموعات التي من النوع Set: inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> inline fun <T> Collection<T>?.orEmpty(): Collection<T> inline fun <T> List<T>?.orEmpty(): List<T> inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> ...

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي. class Byte : Number, Comparable<Byte> الدوال compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تنقص الدالة dec()‎ القيمة ...

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي. class Byte : Number, Comparable<Byte> الدوال compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تنقص الدالة dec()‎ القيمة ...

تستثني الدالة subtract()‎ العناصر المشتركة بين كائنين. تحافظ المجموعة (Set) المُعادة على ترتيب التكرار الخاص بالمجموعة (collection) المعطاة. البنية العامة يمكن استدعاء الدالة subtract()‎ مع المصفوفات والمجموعات التكرارية: infix fun <T> Array<out T>.subtract( other: Iterable<T> ): Set<T> infix fun ByteArray.subtract( other: Iterable<Byte> ): Set<Byte> infix fun ShortArray.subtract( other: Iterable<Short> ): Set<Short> infix fun IntArray.subtract(other: Iterable<Int>): Set<Int> infix fun LongArray.subtract( other: Iterable<Long> ): Set<Long> infix fun FloatArray.subtract( other: Iterable<Float> ): Set<Float> infix ...

تمثل الواجهة CharSequence سلسلةً من المحارف قابلةً للقراءة. interface CharSequence الخاصيات length تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها. الدوال get تجلب الدالة get()‎‎ المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها. subSequence تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها. الدوال الموروثة (Inherited Functions) equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.  hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) ...

تمثل الواجهة CharSequence سلسلةً من المحارف قابلةً للقراءة. interface CharSequence الخاصيات length تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها. الدوال get تجلب الدالة get()‎‎ المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها. subSequence تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها. الدوال الموروثة (Inherited Functions) equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.  hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) ...

تعيد الدالة Any()‎ نسخةً من الصنف Any والذي هو الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ Any. البنية العامة Any() القيم المعادة يعاد كائنٌ (object) من الصنف Any. أمثلة تنشِئ الدالة Any()‎ في الشيفرة الآتية كائنًا من الصنف Anyباسم obj ، ثم يُحدِّد صنف الكائن المُنشَأ وذلك بالاعتماد على خاصيّة الاسم البسيط للصنف (وهي class.simpleName) : fun main(args: Array<String>) {    val obj = Any()    println(" ${obj::class.simpleName}")  // Any } انظر ...

تعيد الدالة Any()‎ نسخةً من الصنف Any والذي هو الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ Any. البنية العامة Any() القيم المعادة يعاد كائنٌ (object) من الصنف Any. أمثلة تنشِئ الدالة Any()‎ في الشيفرة الآتية كائنًا من الصنف Anyباسم obj ، ثم يُحدِّد صنف الكائن المُنشَأ وذلك بالاعتماد على خاصيّة الاسم البسيط للصنف (وهي class.simpleName) : fun main(args: Array<String>) {    val obj = Any()    println(" ${obj::class.simpleName}")  // Any } انظر ...

تعيد الدالة component1()‎ العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط.  البنية العامة يمكن استدعاء الدالة component1()‎ مع المصفوفات والقوائم (list): inline operator fun <T> Array<out T>.component1(): T inline operator fun ByteArray.component1(): Byte inline operator fun ShortArray.component1(): Short inline operator fun IntArray.component1(): Int inline operator fun LongArray.component1(): Long inline operator fun FloatArray.component1(): Float inline operator fun DoubleArray.component1(): Double inline operator fun ...

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

تجلب الدالة indexOf()‎ فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOf()‎ مع المصفوفات، والمجموعات والقوائم: fun <T> Array<out T>.indexOf(element: T): Int fun ByteArray.indexOf(element: Byte): Int fun ShortArray.indexOf(element: Short): Int fun IntArray.indexOf(element: Int): Int fun LongArray.indexOf(element: Long): Int fun FloatArray.indexOf(element: Float): Int fun DoubleArray.indexOf(element: Double): Int fun BooleanArray.indexOf(element: Boolean): Int fun CharArray.indexOf(element: Char): Int fun <T> Iterable<T>.indexOf(element: T): Int fun <T> List<T>.indexOf(element: T): Int المعاملات index العنصر المراد جلب فهرس ...

تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: انعكاسيًا (Reflexive): لكل مرجع x لا يساوي null، يجب أن تُعيد العبارة x.equals(x)‎ القيمة true. تماثليًَا (Symmetric): لكل قيمتين مرجعيتين x و y لا تساويان null، ستعيد العبارة x.equals (y)‎ القيمة true إذا وفقط إذا أعادت العبارة y.equals (x)‎ القيمة true. تواتريًا (Transitive):  لكل القيم المرجعية x و y و z التي لا تساوي null، ستعيد العبارة  x.equals ...

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

يمثل الصنف Array مصفوفة (مصفوفة Java تحديدًا عند استهداف المنصة JVM). يمكن إنشاء نسخ من هذا الصنف باستعمال الدوال ()‎arrayOf و ()‎arrayOfNulls و ()‎emptyArray الخاصة بالمكتبة القياسية. للمزيد من المعلومات حول المصفوفات، ارجع إلى قسم "المصفوفات" في توثيق الأنواع الأساسية. class Array<T> الدوال البانية <int> تنشِئ الدالة Array()‎ البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. الدوال والخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة (array). iterator تعيد هذه الدالة ...

تقطع الدالة slice()‎ جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة. البنية العامة يمكن تمرير مجال محدَّد إلى الدالة slice()‎ كوسيط: fun <T> Array<out T>.slice(indices: IntRange): List<T> fun ByteArray.slice(indices: IntRange): List<Byte> fun ShortArray.slice(indices: IntRange): List<Short> fun IntArray.slice(indices: IntRange): List<Int> fun LongArray.slice(indices: IntRange): List<Long> fun FloatArray.slice(indices: IntRange): List<Float> fun DoubleArray.slice(indices: IntRange): List<Double> fun BooleanArray.slice(indices: IntRange): List<Boolean> fun CharArray.slice(indices: IntRange): List<Char> fun <T> List<T>.slice(indices: IntRange): List<T> أو يمكن تمرير كائن من النوع Iterable إلى الدالة slice()‎ كوسيط: fun <T> Array<out T>.slice(indices: Iterable<Int>): ...

تجلب الدالة indexOfLast()‎ فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfLast()‎ مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfLast( predicate: (T) -> Boolean ): Int inline fun ByteArray.indexOfLast( predicate: (Byte) -> Boolean ): Int inline fun ShortArray.indexOfLast( predicate: (Short) -> Boolean ): Int inline fun IntArray.indexOfLast( predicate: (Int) -> Boolean ): Int inline fun LongArray.indexOfLast( predicate: ...

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

تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. استدعاء هذه الدالة يجب أن يكون: انعكاسيًا (Reflexive): لكل مرجع x لا يساوي null، يجب أن يعيد استدعاء x.equals(x)‎ القيمة true. تماثليًَا (Symmetric): لكل قيمتين مرجعيتين x و y لا تساويان null، سيعيد الاستدعاء x.equals(y)‎ القيمة true إذا، وفقط، إذا أعادت y.equals(x)‎ القيمة true. تواتريًا (Transitive):  لكل القيم المرجعية x و y و z التي لا تساوي null، سيعيد استدعاء x.equals(z)‎ القيمة true إن أعادت x.equals(y)‎ و ...

تجلب الدالة indexOfFirst()‎ فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfFirst()‎ مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfFirst( predicate: (T) -> Boolean ): Int inline fun ByteArray.indexOfFirst( predicate: (Byte) -> Boolean ): Int inline fun ShortArray.indexOfFirst( predicate: (Short) -> Boolean ): Int inline fun IntArray.indexOfFirst( predicate: (Int) -> Boolean ): Int inline fun LongArray.indexOfFirst( ...

تقطع الدالة sliceArray()‎ جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها.  البنية العامة إن مرِّر كائن من النوع Collection إلى الدالة sliceArray()‎، فستُعاد مصفوفة تحوي عناصر المصفوفة التي استُدعيت معها والموجودة في الموقع الذي يحدده الوسيط indices: fun <T> Array<T>.sliceArray( indices: Collection<Int> ): Array<T> fun ByteArray.sliceArray(indices: Collection<Int>): ByteArray fun ShortArray.sliceArray( indices: Collection<Int> ): ShortArray fun IntArray.sliceArray(indices: Collection<Int>): IntArray fun LongArray.sliceArray(indices: Collection<Int>): LongArray fun FloatArray.sliceArray( indices: Collection<Int> ): FloatArray ...

تتحقق الدالة contains()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). يمكن استدعاء contains()‎ مع خريطة بالشكل x in map للتحقق من أنّ العنصر x موجود ضمنها. البنية العامة يمكن استدعاء الدالة contains()‎ مع مصفوفات: operator fun <T> Array<out T>.contains(element: T): Boolean operator fun ByteArray.contains(element: Byte): Boolean operator fun ShortArray.contains(element: Short): Boolean operator fun IntArray.contains(element: Int): Boolean operator fun LongArray.contains(element: Long): Boolean ...

يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray الدوال البانية <init> تنشئ الدالة FloatArray()‎ البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف CharArray مصفوفةً من الأعداد العشرية المضاعفة. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class DoubleArray الدوال البانية (Constructors) <init> تنشئ الدالة DoubleArray()‎ البانية مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة [double]) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray الدوال البانية <int> تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

يمثل الصنف CharArray مصفوفةً من الأعداد العشرية المضاعفة. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class DoubleArray الدوال البانية (Constructors) <init> تنشئ الدالة DoubleArray()‎ البانية مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة [double]) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray الدوال البانية <init> تنشئ الدالة FloatArray()‎ البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray الدوال البانية <int> تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة ...

الإضافات (Extensions) توفِّر لغة Kotlin -كما هو الحال في لغات البرمجة مثل C#‎ و Gosu- إمكانيّة الإضافة على الأصناف (classes) بوظائف جديدةٍ دون اللجوء إلى الوراثة (inheritance) منها أو استخدام أيّ أنماطٍ تصميميّةٍ مثل Secorator، وذلك من خلال تصريحات خاصّة تُدعى الإضافات (extensions)، إذ تدعم لغة Kotlin الدوال الإضافيّة (extension functions) والخاصّيّات الإضافيّة (extension properties). الدوال الإضافيّة (Extension Functions) لتعريف دالةٍ إضافيّةٍ يجب أن يُسبَق اسمها بنوع المستقبِل (receiver type) أي النوع الذي ستتمّ الإضافة عليه، ففي الشيفرة الآتية تُضاف ...

تتحقَّق الدالة single()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك. البنية العامة إن استدعيت الدالة single()‎ مع مصفوفة أو مجموعة أو قائمة دون تمرير أي معامل، فستتحقَّق من احتواء تلك المصفوفة أو المجموعة أو القائمة على عنصر واحد فقط ثمَّ تعيده. وفي حال كانت تلك المصفوفة أو المجموعة أو القائمة فارغةً أو تحوي أكثر من عنصر واحد، فستطلق الدالة single()‎ استثناءً: fun <T> Array<out T>.single(): T fun ByteArray.single(): ...

تنشئ الدالة MatchGroup()‎ البانية كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. البنية العامة MatchGroup(actual value: String, range: IntRange) منصة التشغيل المطلوبة: JVM. MatchGroup(actual value: String) منصة التشغيل المطلوبة: JS. المعاملات value قيمة مجموعة النتائج التي تم الحصول عليها. range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. الخاصية range متوافرة على منصة JVM فقط. القيم المعادة يعاد كائن من النوع MatchGroup. أمثلة في الشيفرة الآتية  نعرّف كائنًا من ...

تنشئ الدالة MatchGroup()‎ البانية كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. البنية العامة MatchGroup(actual value: String, range: IntRange) منصة التشغيل المطلوبة: JVM. MatchGroup(actual value: String) منصة التشغيل المطلوبة: JS. المعاملات value قيمة مجموعة النتائج التي تم الحصول عليها. range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. الخاصية range متوافرة على منصة JVM فقط. القيم المعادة يعاد كائن من النوع MatchGroup. أمثلة في الشيفرة الآتية  نعرّف كائنًا من ...

الخاصية border-top-left-radius في CSS تضبط تدوير الركن العلوي الأيسر من العنصر. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم النسب المئوية نسبة من البُعد الموافق للقيمة من إطار العنصر. القيمة المحسوبة قيمتان للطول <length>، أو نسبتان مئويتان <percentage>. /* الركن سيكون دائريًا */ /* border-top-left-radius: radius */ border-top-left-radius: 3px; /* نسب مئوية */ border-top-left-radius: 20%; /* الركن سيكون دائريًا إن كان العنصر مربعًا */ border-top-left-radius: 20% 20%; /* كما في القاعدة السابقة، أي 20% من العرض و 20% ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. نوع الكائن الناتج يتعلق بنوع الطرف الثاني للعملية.  البنية العامة int - numeric → numeric_result‎ المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين int و numeric. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  أمثلة مثال على استخدام المعامل -‎: 20 - 3 #=> 17 6 - 0.4 ...

يعيد المعامل - مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة الأخرى. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. يوازن المعامل - العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary - other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى. أمثلة مثالٌ عن استعمال المعامل -: [ 1, 1, 2, 2, 3, 3, ...

يجري المعامل ‎* عملية الضرب على الأعداد العقدية. البنية العامة cmp * numeric → complex المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية الضرب. numeric عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية الضرب. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن عملية الضرب بين العدد العقدي cmp والعدد numeric. أمثلة أمثلة عن استخدام المعامل *: Complex(2, 3) * Complex(2, 3) #=> (-5+12i) Complex(900) * Complex(1) #=> (900+0i) Complex(-2, 9) * ...

يتحقق المعامل == من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى. إذا لم يكن الكائن من نوع سلسلة نصية، فيمكن استعمال الدالة to_s لتحويله إلى سلسلة نصية إذا أمكن ذلك. البنية العامة str == obj → true or false المعاملات str سلسلة نصية تمثل الطرف الأول من عملية التحقق. obj الكائن المُراد التحقق من مساواته مع السلسلة النصية str. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية str مساويةً للكائن obj ...

يبدِّل المعامل [] عند استدعائه بالشكل ‎[]=‎‎ سلسلةً نصيةً محدَّدةً مكان جزءٍ محدَّد أو كامل محتوى سلسلة نصية أخرى. البنية العامة str[integer] = new_str str[integer, integer] = new_str str[range] = aString str[regexp] = new_str str[regexp, integer] = new_str str[regexp, name] = new_str str[other_str] = new_str يحدَّد الجزء المراد تبديله من السلسلة النصية str بالطريقة نفسها المذكورة في المعامل []. إن كان طول السلسلة النصية المعطاة لا يطابق طول السلسلة النصية (أو الجزء المحدّد) المراد تبديله، فستُعدَّل السلسلة النصية المعطاة تلك وفقًا لذلك. إن كان التعبير النمطي أو ...

يعيد المعامل ~ مكمل العدد الذي استُدعي معه، إذ يقلب قيمة كل بت من بتات العدد. نظريًا، يُعد طول الأعداد الصحيحة لا نهائيًا، لذلك فإنّ النتيجة تُحسب كما لو كان هناك عدد غير محدود من البتات التي قيمتها واحد إلى اليسار. في التمثيل الست عشري (hex representations)، يتم التعبير عن ذلك بوضع نقطتين إلى يسار الرقم. البنية العامة ~int → integer‎ القيمة المعادة يعاد مكمل العدد الذي استُدعي معه، إذ يقلب قيمة كل بت من بتات العدد. أمثلة ...

يعيد المعامل `` مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell). تُستخدَم الصياغة المضمَّنة ‎%x{...}‎‎ هذا المعامل. تُضبَط حالة العملية (process status) إلى القيمة ‎$?‎‎. البنية العامة `cmd` → string‎ المعاملات cmd يمثل التعليمة المراد تنفيذها. القيمة المعادة يعاد مجرى المخرجات القياسي لتنفيذ تعليمة cmd في صدفة فرعية (subshell). أمثلة مثال على استخدام المعامل ``‎: `date` #=> "Wed Apr ...

يعيد المعامل %‎ باقي عملية القسمة الصحيحة بين عددين. البنية العامة int % other → real المعاملات int عدد صحيح يمثل الطرف الأول في عملية القسمة. other عدد صحيح يمثل الطرف الثاني في عملية القسمة. القيمة المعادة يعاد باقي عملية القسمة الصحيحة للعدد int على other. أمثلة مثال على استخدام المعامل %‎: 20 % 3 #=> 2 6 % 3 #=> 0 انظر أيضا المعامل *: يعيد ناتج ...

يوازن المعامل < بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj > other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة ‎1‎ (أي كان الكائن obj أكبر من الكائن other)، وإلا فستُعَاد القيمة false. أمثلة أمثلة عن استخدام المعامل <: "a" > "f" ; # false "a" > "A" ; # true 3 > 5 ; # false انظر أيضًا المعامل >: يوازن ...

يمثِّل المعامل - الأحادي إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. البنية العامة -num → numeric‎ القيمة المعادة يعاد العدد المعطى بعد ضربه بإشارة الناقص (أي عكس إشارة)؛ فيعاد عدد سالب إن كان العدد المعطى موجبًا والعكس صحيح. انظر أيضا المعامل +: يمثِّل إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. المعامل <=>: يوازن بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. مصادر قسم المعامل -‎ في الصنف ...

يعيد المعامل *‎ ناتج عملية ضرب عدد عشري بعدد آخر. البنية العامة float * other → float  المعاملات float عدد عشري يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية الضرب بين العددين float و other. أمثلة مثال على استخدام المعامل *‎: 20.0 * 3 #=> 60.0 6.0 * 3.4 #=> 20.4 انظر أيضا التابع modulo: يعيد ...

يعيد المعامل /‎ ناتج عملية القسمة بين عددين. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  البنية العامة int / numeric → numeric_result‎ المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric  عدد يمثل الطرف الثاني للعملية. القيمة المُعادة يُعاد ناتج عملية القسمة بين العددين int و numeric. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  أمثلة مثال على استخدام المعامل /‎: 20 / 3 #=> 6 20 / 3.0 ...

يضبط المعامل [] عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسم name إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك. البنية العامة ENV[name] = value يجب أن يكون المعامل name سلسلة نصية. المعاملات name سلسلة نصية تمثِّل اسم متغير البيئة المراد ضبط قيمته. انظر أيضًا التابع []‎: يعيد قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.  التابع store: يضبط قيمة متغير بيئة ذي ...

ينسخ المعامل * سلسلة نصية عددًا محدَّدًا من المرات ثم يضعها في سلسلة نصية جديدة. البنية العامة str * integer → new_str المعاملات str السلسلة النصية المضروبة بالعدد integer لنسخها n مرة. integer عدد صحيح موجب يمثِّل عدد المرات التي يراد فيها نسخ السلسلة النصية str. القيمة المعادة تعاد سلسلة نصية جديدة مؤلفة من integer نسخة من السلسلة النصية str المعطاة. أمثلة مثال على استخدام المعامل *: "Ho! " * 3 #=> "Ho! Ho! Ho! " "Ho! " * ...

يجري المعامل | العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. يعيد القيمة false إن كانت قيمة هذا الكائن هي nil أو false، وإلا فسيعيد القيمة true. البنية العامة false | obj→true or false nil| obj→true or false‎ القيمة المعادة يعيد القيمة false إن كانت قيمة الكائن obj تساوي nil أو false؛ خلا ذلك، تعاد القيمة true. انظر أيضا المعامل &: يجري العملية AND المنطقية على الكائن المعطى والقيمة nil أو false. المعامل ^: يجري العملية XOR المنطقية على الكائن المعطى ...

يزيح المعامل << العدد الصحيح المعطى إلى اليمين بقدار محدَّد من المنازل، أو إلى اليسار إن كانت قيمة مقدار الإزاحة سالبةً. البنية العامة int >> count → integer القيمة المعادة تعاد قيمة العدد int بعد إزاحتها إلى اليمين بمقدار count موضع، أو إلى اليسار إن كان count سالبًا. أمثلة مثال على استخدام المعامل <<: 20 >> 3 #=> 2 20 >> 2 #=> 5 20 >> -2 #=> 80 انظر أيضا المعامل >>: يزيح ...

يعيد المعامل => القيمة true إن كانت قيمة العدد العشري الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه. البنية العامة float <= real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة float أصغر من أو تساوي قيمة real. ملاحظة: نتيجة NaN <= NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل =>: 20.3 <= 3 #=> false 20.30 <= 30 ...

يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة ary + other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تضم المصفوفة ary والمصفوفة other_ary معًا. أمثلة مثالٌ عن استخدام المعامل +: [ 1, 2, 3 ] + [ 4, 5 ] #=> [ 1, 2, 3, 4, 5 ] a = [ "a", "b", "c" ] c = a + [ "d", "e", "f" ] c ...

يوازن المعامل <=> بين توقيتين. البنية العامة time <=> other_time → -1, 0, +1 or nil‎ القيمة المعادة تعاد إحدى القيم ‎-1 أو 0 أو ‎+1 حسب ما إذا كان التوقيت time أصفر من أو يساوي أو أكبر من التوقيت other_time. تعاد القيمة nil إن لم بالإمكان الموازنة بين القيمتين. أمثلة مثال على استخدام المعامل <=>‎: t = Time.now #=> 2007-11-19 08:12:12 -0600 t2 = t + 2592000 #=> 2007-12-19 08:12:12 -0600 t <=> ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كان العدد الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي. هذا المعامل هو أساس عمليات الموازنة في الصنف Comparable. إذا كانت القيمتان غير قابلتين للمقارنة، فستُعاد القيمة nil. البنية العامة int <=> numeric → -1, 0, +1, or nil  القيمة المعادة يعاد العدد الصحيح ‎-1 أو 0 أو ‎+1 إذا كان العدد int أصغر من أو يساوي أو أكبر ...

يعد المعامل === معامل تساوي الحالة (Case Equality)، إذ يتحقق من تطابق تعبير نمطي مع سلسلة نصية. ويُستخدم أيضًا في العبارات case. وضع تعبير نمطي حرفي (regular expression literal) عقِب المعامل === يسمح لك بمقارنته مع سلسلة نصية. البنية العامة rxp === str→ true or false‎ القيمة المعادة تعاد القيمة true إن تطابق التعبير النمطي rxp مع السلسلة النصية أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ===‎: a = "HELLO" case a when /\A[a-z]*\z/; print "Lower case\n" when /\A[A-Z]*\z/; ...

يتحقق المعامل == من تساوي عدد جذري مع عدد آخر. البنية العامة rat == object → true or false‎ القيمة المعادة تعاد القيمة true إن كان rat يساوي object عدديًا، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام التابع ==‎: Rational(2, 3) == Rational(2, 3) #=> true Rational(5) == 5 #=> true Rational(0) == 0.0 ...

يوازن المعامل ‎‎‎<=‎ بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj <= other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة ‎-1‎ أو 0 (أي كان obj أًصغر من أو يساوي الكائن other)، وإلا فسيعيد false. أمثلة أمثلة عن استخدام المعامل =>: "a" <= "a" ; #=> true "a" <= "A" ; #=> false 3 <= 5 ; #=> true انظر أيضًا المعامل ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي. يوازن كل كائن من كل مصفوفة باستخدام المعامل <=>. يوازن بين المصفوفات عنصرًا عنصرًا؛ بعبارة أخرى، يوازن العنصر الأول من المصفوفة الأولى مع العنصر الأول من المصفوفة الثانية باستخدام المعامل <=>، ثم يوازن العنصر الثاني فالثالث وهكذا دواليك. متى ما أعطيت نتيجة مغايرة للصفر لأيٍّ من تلك الموازنات التي تجرى على العناصر تباعًا ...

يتحقق المعامل ‎== من تساوي عددين عقديين. البنية العامة cmp == object → true or false المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية المقارنة. object عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية المقارنة. القيمة المعادة تُعاد القيمة true  إن كان cmp يساوي object عدديًّا، أو تعاد القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: Complex(2, 3) == Complex(2, 3) #=> true Complex(5) == 5 ...

يعدُّ المعامل [] مرجعًا للخاصيات (Attribute Reference)، إذ يُعيد قيمة متغير محلي الليف fiber) local variable، أو الليف الأصلي للمهمة الفرعية الحالية إن لم يكن المتغير موجودًا داخل ليف) باستخدام إما رمز أو سلسلة نصية. إن لم يكن المتغير المعطى (انظر فقرة البنية العامة) موجودًا، فستعاد nil. [ Thread.new { Thread.current["name"] = "A" }, Thread.new { Thread.current[:name] = "B" }, Thread.new { Thread.current["name"] = "C" } ].each do |th| th.join puts "#{th.inspect}: #{th[:name]}" end‎ هذا سوف ينتج: ...

إن استُعمِل المعامل - بالشكل ‎-Float، فسيعيد القيمة المعاكسة للعدد Float العشري (أي القيمة السالبة إن كان Float موجبًا أو العكس بالعكس). البنية العامة -float → float المعاملات float عدد عشري يراد عكس إشارته. القيمة المعادة يعاد العدد العشري المعاكس للعدد float (أي قيمة موجبة إن كان float سالبًا والعكس صحيح). أمثلة مثال على استخدام المعامل -‎: -(21.0 + 4) #=> -25.0 -(-6.0) #=> 6.0 انظر أيضا ...

يمثِّل المعامل + الأحادي إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. البنية العامة +num → num‎ القيمة المعادة يعاد العدد الذي استُدعي معه. انظر أيضا المعامل -: يمثِّل إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. المعامل <=>: يوازن بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. مصادر قسم المعامل +‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يجري المعامل & العملية And المنطقية على الكائن المعطى والقيمة nil أو false. يعيد المعامل القيمة false دائمًا. يُقيَّم هذا الكائن obj المعطى باعتباره دومًا معاملًا يُمرَّر إلى تابع عند استدعائه. ليس هنالك اختبارٌ لوجود «دارة قصيرة» (short-circuit) في هذه الحالة. البنية العامة false & obj→ false nil & obj → false‎ القيمة المعادة تعاد القيمة false دومًا مهما كانت قيمة الكائن obj. انظر أيضا المعاملor: يجري العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. المعامل ^: يجري العملية ...

يعيد المعامل ‎<=‎ القيمة true إن كانت الوحدة Module التي تقع على يساره صنفًا فرعيًّا من الوحدة التي تقع على يمينه أو كانت الوحدتان متساويتين تمامًا، أو يعيد القيمة nil إذا لم تكن بينهما أية علاقة (فكر في هذه العلاقة من منظور تعريف الأصناف: "الصنف A < الصنفB" يستلزم "A < B"). البنية العامة mod <= other→ true, false, or nil‎ القيمة المعادة تعاد القيمة true إن كان mod صنفًا فرعيًا من other أو كان يساويه، أو تعاد القيمة nil ...

يعيد المعامل < القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من قيمة العدد الآخر الواقع على يمينه. البنية العامة float > real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة float أكبر من قيمة real، وإلا فستعاد false. ملاحظة: نتيجة NaN > NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل <: 30.0 > 3 #=> true 20.0 > 30 ...

يوازن المعامل <=> بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. البنية العامة number <=> other → 0 or nil‎ القيمة المعادة تعاد القيمة 0 إن كان number يساوي other، وإلا فستُعاد القيمة nil. انظر أيضا المعامل +: يمثِّل إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. المعامل -: يمثِّل إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. التابع eql?‎: يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه ...

يجلب المعامل [] محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة. عند تمرير تعبير نمطي (Regexp) إلى المعامل []، يعيد الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط (capture)، ...

محدد العناصر التي لها الخاصية [name] الوصف يختار هذا المحدد العناصر التي تمتلك خاصية معينة مهما كانت قيمتها. jQuery( "[attribute]" )‎ أضيف مع الإصدار: 1.0. attribute اسم الخاصية المراد البحث عنها. أمثلة إضافة قيمة الخاصية id إلى المحتوى النصي للعنصر الذي يمتلك الخاصية id : <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>attributeHas demo</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div>no id</div> <div id="hey">with id</div> <div id="there">has an id</div> <div>nope</div> <script> // .one() نستعمل التابع // لكي يُنفَّذ معالج الأحداث مرةً واحدةً على الأكثر لكل عنصر ولكل حدث $( "div[id]" ).one( "click", ...

يعيد المعامل & مصفوفةً جديدةً تحتوي على العناصر المشتركة بين مصفوفتين دون تكرارها. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. توازن العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary & other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تحتوي على العناصر المشتركة بين المصفوفة ary والمصفوفة other_ary دون تكرارها. أمثلة مثالٌ عن استخدام المعامل &: [ 1, 1, 3, 5 ] & [ 3, 2, 1 ] ...

يعيد التابع ENV[]‎ قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. البنية العامة ENV[name] → value المعاملات name اسم متغير البيئة المراد جلب قيمته. القيمة المعادة تُعاد سلسلة نصي تمثِّل قيمة متغير البيئة name، أو تعاد القيمة nil في حال لم يكن المتغير ذو الاسم name موجودًا. انظر أيضًا المعامل []: يضبط عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسم name إلى القيمة value. التابع store: يضبط قيمة ...

يُلحق المعامل >> الكائن المُعطى بالسلسلة النصية. في حال كان هذا الكائن عددًا صحيحًا، فإنه يُعتبر نقطة ترميز (codepoint) ويُحول إلى المحرف المقابل له قبل أن يضاف إلى السلسلة النصية. البنية العامة str << obj → str str << integer → str القيمة المعادة تعاد السلسلة النصية str مضافًا إليها الكائن obj أو العدد integer الصحيح بعد تحويله إلى المحرف المقابل له. أمثلة مثال على استخدام المعامل >>: a = "hello " a << "world" #=> "hello world" a << 33 ...

يربط المعامل [] عند استدعائه بالشكل hsh[key] = value القيمة value المعطاة بالمفتاح key في الجدول Hash. البنية العامة hsh[key] = value → value المعاملات key المفتاح الذي يراد ربط القيمة value المعطاة به. القيمة المعادة تعاد القيمة value نفسها بعد ربطها بالمفتاح key. أمثلة مثال على استعمال المعامل []: h = { "a" => 100, "b" => 200 } h["a"] = 9 h["c"] = 4 h #=> {"a"=>9, "b"=>200, "c"=>4} h.store("d", 42) #=> 42 h #=> {"a"=>9, "b"=>200, "c"=>4, "d"=>42} انتبه إلى ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. البنية العامة float - other → float المعاملات float عدد صحيح يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين float و other.  أمثلة مثال على استخدام المعامل -‎: 20.0 - 3 #=> 17.0 6.0 - 0.4 #=> 5.6 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: ...

يزيح المعامل >> العدد الصحيح المعطى إلى اليسار بقدار محدَّد من المنازل، أو إلى اليمين إن كانت قيمة مقدار الإزاحة سالبةً. البنية العامة int << count → integer القيمة المعادة تعاد قيمة العدد int بعد إزاحتها إلى اليسار بمقدار count موضع، أو إلى اليمين إن كان count سالبًا. أمثلة مثال على استخدام المعامل >>: 20 << 3 #=> 32 20 << 2 #=> 16 20 << -2 #=> ...

يجري المعامل ^ العملية XOR المنطقية على الكائن المعطى والقيمة nil أو false. إن كانت قيمة هذا الكائن هي nil أو false، فستُعاد القيمة false؛ خلاف ذلك، ستُعاد القيمة true. البنية العامة false ^ obj → true or false nil^ obj → true or false‎ القيمة المعادة إن كانت قيمة الكائن obj تساوي nil أو false، فستُعاد القيمة false؛ خلا ذلك، ستُعاد القيمة true. انظر أيضا المعامل &: يجري العملية AND المنطقية على الكائن المعطى والقيمة nil أو false. المعاملor: يجري العملية ...

يجري المعامل ‎- عملية الطرح بين عددين عقديين. البنية العامة cmp - numeric → complex المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية الطرح. numeric عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية الطرح. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن طرح العددين cmp و numeric. أمثلة أمثلة عن استخدام المعامل -: Complex(2, 3) - Complex(2, 3) #=> (0+0i) Complex(900) - Complex(1) #=> (899+0i) Complex(-2, 9) - Complex(-9, 2) ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. البنية العامة float - other → float المعاملات float عدد صحيح يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين float و other.  أمثلة مثال على استخدام المعامل -‎: 20.0 - 3 #=> 17.0 6.0 - 0.4 #=> 5.6 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: ...

يتحقق المعامل == من تساوي تعبيران نمطيان. تتحقق عملية التساوي من كون نمطاهما (patterns) متطابقين، وكان لهما نفس رمز مجموعة الحروف (character set code)، وكانت لهما نفس القيمة casefold?‎. البنية العامة rxp == other_rxp→ true or false‎ القيمة المعادة تُعاد القيمة true في حال كان التعبيران النمطيان متساويان، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام المعامل ==‎: /abc/ == /abc/x #=> false /abc/ == /abc/i #=> false /abc/ == /abc/u #=> false /abc/u ...

يعيد المعامل **‎ ناتج عملية رفع للعدد int الأساس إلى قوة العدد numeric (الأس). النتيجة يمكن أن تكون من النوع Integer أو Float أو Rational أو Complex. البنية العامة int ** numeric → numeric_result المعاملات int عدد صحيح يمثل الطرف الأول (الأساس) في للعملية. numeric عدد يمثل الطرف الثاني (الأس) للعملية. يمكن أن يكون هذا العدد سالبا أو كسريًا. القيمة المعادة يعاد ناتج عملية رفع المعامل int إلى قوة المعامل numeric. النتيجة يمكن أن تكون من النوع Integer أو Float أو Rational ...

يعيد المعامل **‎ ناتج عملية رفع عدد عشري (الأساس) إلى قوة عدد محدد (الأس). البنية العامة float ** other → float المعاملات float عدد عشري يمثل الطرف الأول (الأساس) في للعملية. other عدد يمثل الطرف الثاني (الأس) للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية رفع المعامل float إلى قوة المعامل other. أمثلة مثال على استخدام التابع **‎: 2.0**3 #=> 8.0 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. التابع modulo: يعيد باقي عملية القسمة بين عدد عشري وعدد آخر. مصادر ...

يتحقق المعامل === من تساوي كائن مع كائن آخر. بالنسبة للصنف Object هذا المعامل مكافئ أساسًا لاستدعاء المعامل ‎==‎، ولكن عادةً ما يعاد تعريفه من قبل الأصناف المنحدرة منه (descendants) لاستخدامه مع العبارات case. البنية العامة obj === other→ true or false‎ القيمة المعادة تعاد القيمة false إن كان obj يساوي الكائن other، أو تعاد القيمة true خلاف ذلك. انظر أيضًا المعامل &: يجري العملية AND المنطقية على القيمة true وقيمة الكائن المعطى، ويُعيد القيمة false إن كان الكائن يساوي nil ...

يتحقق المعامل === إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى (انظر فقرة البنية العامة) متساويين. البنية العامة system_call_error === other → true or false‎ القيمة المعادة تعاد القيمة true إن كان الاستثناء system_call_error كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء other متساويين. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع new: ينشئ الصنف Errno المناسب لرمز خطإٍ نظامي معروف ...

يُعيد المعامل - الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى. البنية العامة time - other_time → float time - numeric → time‎ القيمة المعادة يعاد عدد عشري يمثِّل عدد الثواني الناتجة عن طرح التوقيت time من التوقيت other_time (أي الفرق بينهما)، أو يطرح العدد numeric (بواحدة الثانية) من التوقيت time. أمثلة مثال على استخدام المعامل -‎: t = Time.now #=> 2007-11-19 08:23:10 -0600 t2 = t + 2592000 #=> ...

ينفذ المعامل * عملية الضرب. البنية العامة rat * numeric → numeric‎ ‎القيمة المعادة يعيد ناتج عملية الضرب بين العدد الجذري rat وبين العدد numeric. أمثلة مثال على استخدام التابع *‎: Rational(2, 3) * Rational(2, 3) #=> (4/9) Rational(900) * Rational(1) #=> (900/1) Rational(-2, 9) * Rational(-9, 2) #=> (1/1) Rational(9, 8) * 4 #=> ...

يعيد المعامل =< القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من أو تساوي قيمة العدد الآخر الواقع على يمينه. البنية العامة float >= real → true or false القيمة المعادة يعاد القيمة true إن كانت قيمة float أكبر من أو تساوي قيمة real، وإلا فستعاد القيمة false. ملاحظة: نتيجة NaN >= NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل =<: 20.0 >= 3 #=> true 20.0 >= ...

يعيد المعامل - عند استدعائه بالشكل str- نسخةً مطابقةً ومجمدةً للسلسلة النصية str في حال كانت غير مجمدة. أما إذا كانت مجمدة، فسيعيد التابع السلسلة النصية نفسها. البنية العامة -str → str (frozen) القيمة المعادة تُعاد نسخة مطابقة ومجمدة من السلسلة النصية str إن كانت هذه السلسلة غير مجمدة، أو تُعاد السلسلة النصية نفسها إن كانت مجمدة. أمثلة مثال على استعمال المعامل -: n1= “Hello” n1<<”World” #=> “HelloWorld” n2= -n1 n2<<”Guys” #=> FrozenError (can't modify frozen String) انظر أيضًا ...

يطبِّق المعامل % السلسلة النصية الواقعة على يساره التي تعد سلسلة تنسيق معيارية على الكائن المعطى الواقع على يمينه ثم يعيد الناتج. إن حوت سلسلة التنسيق أكثر من من عنصر نائب، فيجب أنذاك أن يكون الكائن الذي ستطبق عليه مصفوفةً أو كائنًا من النوع Hash يحوي القيم التي ستأخذ مكان العناصر النائبة المقابلة. البنية العامة str % arg → new_str المعاملات str سلسلة التنسيق التي ستُطبَّق على محتوى المعامل arg. لمزيد من التفاصيل حول صياغة سلسلة التنسيق، اطلع على صفحة ...

يتحقق المعامل == من تساوي مجالين مع بعضهما بعضًا. يكون مجالان متساويين إن كان كل منهما من النوع Range وكان لهما نفس عنصري البداية والنهاية (بمقارنتهما بالمعامل ==)، وكان لهما أيضًا نفس الضبط exclude_end?‎. البنية العامة rng == obj → true or false‎ القيمة المعاد تعاد القيمة true إن كان الكائن obj من النوع Range ومساويًا للمجال rng. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع ==‎: (0..2) == (0..2) ...

يتحقق المعامل == من تساوي كائنين من النوع UnboundMethod. يكون كائنان من النوع UnboundMethod متساويين إن كانا مرتبطين بنفس الكائن، وكانا يشيران إلى نفس تعريف التابع، وكان لهما نفس الصنف أو الوحدة المالكة. البنية العامة meth == other_meth → true or false‎ القيمة المعادة تعاد القيمة true إن كان الكائنان meth و other_meth متساويين، أو تعاد القيمة false خلاف ذلك. انظر أيضًا التابع eql?‎: يتحقق من تساوي تابعين غير مربوطين. مصادر قسم المعامل ==‎ في الصنف UnboundMethod‎ في توثيق ...

إن استعمل المعامل * مع مصفوفة وسلسلة نصية، فسيُكافئ حينئذٍ العبارة ary.join(str)‎. أمَّا إن استعمل مع مصفوفة وعدد، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. البنية العامة ary * int → new_ary ary * str → new_string القيم المعادة تعاد مصفوفة أو سلسلة نصية جديدة. أمثلة مثالٌ عن استخدام المعامل * مرةً مع عدد وأخرى مع سلسلة نصية: [ 1, 2, 3 ] * 3 #=> [ 1, 2, ...

يعيد المعامل => القيمة true إن كانت قيمة العدد الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه. البنية العامة int <= real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة int أصغر من أو تساوي قيمة real. أمثلة مثال على استخدام المعامل =>: 20 <= 3 #=> false 20 <= 30 #=> true 3 <= 3 #=> true انظر أيضا المعامل >>: ...

يضيف المعامل + عددًا من الثواني (ربما يكون عدد كسري) إلى التوقيت المعطى، ثم يُعيد تلك القيمة كتوقيت جديد. البنية العامة time + numeric → time‎ القيمة المعادة يعاد توقيتٌ جديدٌ ناتج عن جمع التوقيت time مع العدد numeric. أمثلة مثال على استخدام التابع +‎: t = Time.now #=> 2007-11-19 08:22:21 -0600 t + (60 * 60 * 24) #=> 2007-11-20 08:22:21 -0600‎ انظر أيضًا المعامل -: يُعيد الفرق بالثانية بين وقتين، ...