نتائج البحث

يعيد التابع قائمة بأسماء الأعمدة. البنية العامة keys() القيمة المعادة يعيد التابع قائمة بأسماء الأعمدة، وتكون هذه القائمة العنصر الأول في كلّ صفّ tuple في قيمة الخاصية Cursor.description بعد إجراء الاستعلام مباشرة. ملاحظة: أضيف دعم عملية التقطيع في الإصدار 3.5 من اللغة. أمثلة لنفترض أنّنا هيّأنا جدولًا على النحو التالي: conn = sqlite3.connect(":memory:") c = conn.cursor() c.execute('''create table stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("""insert into stocks values ('2006-01-05','BUY','RHAT',100,35.14)""") conn.commit() c.close() يمكننا ...

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

يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي. البنية العامة ZipFile.extractall(path=None, members=None, pwd=None) ‎المعاملات ‎path يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه. members معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist()‎. pwd كلمة المرور المستخدمة لتعمية الملفات. تحذير لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). ...

كما في أيّة لغة برمجة فإن لغة Kotlin تحتوي على تعابير للتحكم بالتدفق، وهي: تعبير if، وتعبير when، وحلقة for، وحلقة while. وتدعم كذلك الكلمتين المفتاحيّتَين continue و break المستخدَمتَين في الحلقات (راجع أوامر الرجوع والقفز returns and jump). تعبير if يُعدُّ الشرط if في لغة Kotlin تعبيرًا يعيد قيمة، وبالتالي لا حاجة للصيغة condition ? then : else لأن تعبير if يقوم بهذا الدور كما في الشيفرة الآتية: // الاستخدام الاعتيادي var max = a if (a < b) max = b // ...

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

تُعيِّن مُحدِّدات الوصول قابليةَ الوصول إلى كلٍّ من الأصناف (classes) والكائنات (objects) والواجهات (interfaces) والدوال (functions) والخاصّيّات (properties) ودوال الوصول إليها من النوع setters (لأن مُحدِّد الوصول إلى getter مماثلٌ للوصول إلى الخاصّيّة نفسها)، وهناك أربعة أنواعٍ من المُحدِّدات وهي: private و protected و internal و public والنوع الافتراضيّ منها هو public (يُستخدم عند عدم وجود تصريحٍ عن إحداها)، وفيما يلي شرح لكيفيّة تطبيق المُحدِّدات على أنواعٍ مختلفةٍ من التصريحات (declarations). الحزم (Packages) يمكن تعريف كلٍّ من الدوال والخاصّيّات والأصناف ...

يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل، ويجري استخراج معلومات الملف الخاص به بأكبر دقة ممكنة. البنية العامة TarFile.extract(member, path="", set_attrs=True, *, numeric_owner=False) المعاملات member ‎يمكن للعضو المراد استخراجه من الأرشيف أن يكون اسم ملف filename أو كائن TarInfo. path يمكن تعيين مجلد مختلف باستخدام المعامل path الذي يمكن أن يكون كائنًا شبيهًا بالمسارات path-like object. ملاحظة: أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل path في الإصدار 3.6 من بايثون. set_attrs إن ...

 الكلمات المفتاحيّة الثابتة (Hard Keywords) تُعدُّ الكلمات الآتية كلماتٍ مفتاحيّةً في لغة Kotlin وليس ممكنًا استخدامها كمُعرِّفات (identifiers): as تُستخدَم في التحويلات ما بين الأنواع (typecasts) تُحدِّد تسميةً بديلةً (alias) عند عملية الاستيراد (import) as?‎ للتحويلات الحافظة للنوع (safe type casts) break لإنهاء تنفيذ الحلقات (loops) class للتصريح عن الأصناف continue  للاستمرار بالخطوة التالية لأقرب حلقة محيطة (enclosing) do للبدء بحلقة do/while (والتي يُختبَر الشرط فيها لاحقًا) else لتعريف فرعٍ (branch) من تعبير الشرط if والذي سيُنفَّذ عندما يكون الشرط بالقيمة false false ...

يُعيد التابع length عدد أعضاء البنية. البنية العامة length → integer‎ القيمة المعادة يعاد عدد أعضاء البنية. أمثلة مثال على استخدام التابع length‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.length #=> 3‎ انظر أيضًا التابع inspect: يعيد سلسلة نصية تحتوي وصفًا لهذه البنية. التابع members: يُعيد أعضاء البنية على هيئة مصفوفة من الرموز. مصادر قسم التابع length‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يتحقق التابع include?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة include?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع include?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") ...

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

يتحقق التابع value?‎ إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. البنية العامة value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها وارتباطها بمفتاح في الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع ...

يتحقق التابع has_key?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة has_key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_key?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") ...

يتحقق التابع key?‎ إذا كان مفتاحٌ محدَّدٌ موجودًا في الكائن Hash المستدعى معه. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده في الكائن الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع key?‎: h = { "a" => 100, "b" => ...

الكائن JSON يحتوي على الدوال التي تُفسِّر صيغة JavaScript Object Notation (اختصارًا JSON) وتحوّل القيم إلى صيغة JSON. ليس الغرض من هذا الكائن هو تهيئته أو بناؤه (عبر المعامل new)، وليس له عملٌ خاصٌ به باستثناء وجود دالتين تابعتين له. الوصف صيغة JSON هي صيغة لتخزين الكائنات والمصفوفات والأعداد والسلاسل النصية والقيم المنطقية والقيمة null؛ وهي مبنية على صيغة JavaScript لكنها تختلف عنها، فبعض شيفرات JavaScript ليست صالحةً في JSON، وبعض شيفرات JSON ليس صالحةً في JavaScript. الجدول الآتي يعرض ...

يمرر التابع select قيم كل أعضاء البنية إلى الكتلة المعطاة ويعيد مصفوفة تحتوي قيم الأعضاء التي أعادت الكتلة معها القيمة true. هذا التابع يكافئ التابع Enumerable.select. البنية العامة select {|obj| block } → array select → enumerator‎ القيمة المعادة تعاد مصفوفة تحوي أعضاء البنية التي أعيدت القيمة true معها بعد تمريرها إلى الكتلة block المعطاة. يعاد كائن من النوع enumerator إن لم تعطَ الكتلة block. أمثلة مثال على استخدام التابع select‎: Lots = Struct.new(:a, :b, :c, :d, :e, :f) l = ...

التصريح عن الخاصّيّات (Declaring Properties) قد تحتوي الأصناف في لغة Kotlin على الخاصّيّات المعرَّفة إما كقيمٍ متغيّرةٍ عبر الكلمة المفتاحيّة var أو كقيمٍ ثابتةٍ للقراءة فقط (read-only) عبر الكلمة المفتاحيّة val، مثل: class Address { var name: String = ... var street: String = ... var city: String = ... var state: String? = ... var zip: String = ... } إذ يُمكن الوصول للخصائص عبر اسمها ...

مقدمة مع إضافة الأصناف إلى TypeScript ونسخة ES6، فقد ظهرت كذلك حاجةٌ إلى ميزات إضافية لدعم تعديل الأصناف وعناصر الأصناف أو توصيفها (annotating). توفّر المزخرفات (Decorators) طريقة لإضافة توصيفات وبنية برمجة وصفيّة (meta-programming) لتصريحات الأصناف وعناصرها. المزخرفات حاليًّا اقتراح في المرحلة 2 (stage 2 proposal) في JavaScript وهي متوفّرة كميّزة تجريبيّة في TypeScript. ملاحظة: المزخرفات ميّزة تجريبيّة قد تتغيّر في النسخ الجديدة مستقبلًا. لتفعيل الدعم التجريبي للمزخرفات، عليك تفعيل خيار المترجم ‎experimentalDecorators‎ إما على سطر الأوامر أو في ملفّ ‎tsconfig.json‎ ...

مقدمة تسمح لنا الثوابت المتعدّدة بتعريف مجموعة مُسمّاةٍ من الثوابت (set of named constants). استخدام الثوابت المتعدّدة يُسهّل توضيحَ نية استعمال الشيفرة أو إنشاء مجموعة حالات مختلفة. تُوفّر TypeScript كلا من الثوابت المتعددة المعتمِدة على الأعداد وتلك المُعتمِدة على السلاسل النصية كذلك. الثوابت المتعددة العددية (Numeric enums) سنبدأ بالثوابت المتعددة العددية، والتي ستكون مألوفة لمن هو آتٍ من لغات البرمجة الأخرى. يُمكن تعريف ثابت متعدّد بالكلمة المفتاحية ‎enum‎: enum Direction { Up = 1, ...

تهيئة الكائن لإنشاء كائن جديد، استخدم التعبير البرمجي new لتهيئة كائن من صنفٍ ما (class): <?php class foo { function do_foo() { echo "Doing foo."; } } $bar = new foo; $bar->do_foo(); ?> راجع فصل الأصناف والكائنات (Classes and Objects) للمزيد من المعلومات. التحويل إلى كائن إذا حوّلنا كائنًا إلى كائنٍ آخر فلن يُعدَّل فيه شيء، أما إذا حولنا قيمةً من أي نوعٍ آخر إلى كائن، فستُنشَأ نسخةً جديدةً من ...