السلطان
  1. الرئيسية
  2. التوثيق
  3. المرجع

المصطلحات العربية

صفحات التوثيق

المصطلحات العربية

تعامل السلطان العربية لغةً أصيلة في الشيفرة المصدرية وفي المترجم. هذه الصفحة هي المرجع المعتمد للمفردات: تهجئات الكلمات المفتاحية والأنواع ومفاهيم المترجم والأسماء العامة في المكتبة القياسية بالعربية، مع مقابلاتها الإنجليزية. وهي موجهة إلى المبرمجين الذين يقرؤون السلطان العربية أو يكتبونها، وإلى المساهمين الذين يسمّون واجهات برمجية جديدة.

السجلات المعجمية في tools/generate/registry/ هي المرجع الحاسم لتهجئة الكلمات المفتاحية والأنواع بدقة، ولا تضيف هذه الصفحة تهجئات بديلة. عند مقارنة المعرّفات تُوحَّد صور الألف آ وأ وإ إلى ا ويُتجاهل التطويل (tools/generate/registry/identifier_policy_registry.def).

اللغة

الكلمات المفتاحية

الإنجليزية العربية المعنى
def عرف تعريف دالة
let دع التصريح بقيمة
return أرجع الرجوع من دالة
if إذا فرع شرطي
else وإلا الفرع البديل
while طالما حلقة while («ما دام»)
for لكل حلقة for
break اخرج_من_حلقة الخروج من الحلقة الحالية
continue تابع_حلقة الانتقال إلى الدورة التالية من الحلقة الحالية
type نوع التصريح بنوع
match طابق مطابقة الأنماط
with مع بداية فرع المطابقة
mutable متغير غلاف القابلية للتغيير
public عام تصريح عام
extern خارجي التصريح بدالة خارجية
import استورد استيراد وحدة
as مثل صيغة التحويل بين الأنواع
unsafe غير_آمن سياق غير آمن

دالة الدخول إلى البرنامج اسمها main بالإنجليزية والرئيسية («الدالة الرئيسية») بالعربية: عرف الرئيسية(): عدد { … }.

الأنواع المدمجة

الإنجليزية العربية
any أي
bool منطقي
string نص
char حرف
int عدد
uint طبيعي (عدد طبيعي: عدد صحيح ≥ 0، يشمل الصفر)
void فراغ
i8, i16, i32, i64 ص8, ص16, ص32, ص64
u8, u16, u32, u64 ط8, ط16, ط32, ط64
f32, f64 ع32, ع64

تُقرأ طبيعي أيضًا بمعنى «عادي» (normal) في نصوص الأعداد العائمة، ولذلك يسمّي تحويل الأعداد العائمة العشرية أصغر قيمة عادية باسم أصغر_عادي_عائم (compiler/msir/decimal_float_bits.sn)؛ أما أصغر_طبيعي فهو فقط دالة المكتبة القياسية التي تعيد الأصغر من عددين طبيعيين.

أنواع الحاويات المدمجة

هذه الأسماء سياقية: لا تدل على النوع إلا في موضع نوع أو موضع منشئ.

الإنجليزية العربية المنشئات
option اختياري some/Some = موجود, none/None = لا_شيء
result نتيجة ok/Ok = نجح, err/Err = خطأ
vector متجه

الانتشار وحالات الفشل أثناء التشغيل

إنهيار هي التهجئة المعتمدة لـ panic، بهمزة تحت الألف؛ وانهيار المكتوبة بلا همزة تدل على المعرّف نفسه. وهي دالة في المكتبة القياسية مبنية على إنهاء العملية في المكتبة القياسية، مثل اخرج / exit، وليست عملية بدائية في المترجم ولا رمزًا معجميًا؛ والمترجم يعرف أنها لا تعود أبدًا (انظر الأخطاء). الأسماء المخفية التي يولّدها المترجم عند التوسيع (انتشار__N…، نقطة_دخول__…) معرّفات عادية ذات بادئة محجوزة لا يصرّح بها أي مصدر.

الإنجليزية العربية المعنى
? ؟ (U+061F) معامل الانتشار: آخر لاحقة في الطرف الأيمن من العبارة (الرمز استفهام، QUESTION_OPERATOR)
panic إنهيار عملية الإيقاف: تطبع رسالة وتنهي البرنامج (std.process.panic)
SULTANC-RUNTIME-PROGRAM-ERROR انتهى_البرنامج_بخطأ هوية فشل تشغيل: أعادت main خطأ ("the program ended with an error" / «انتهى البرنامج بخطأ»)
SULTANC-RUNTIME-PROGRAM-STOPPED توقف_البرنامج هوية فشل تشغيل: توقف البرنامج ("the program stopped" / «توقف البرنامج»)
runtime.assertion-failed سبب_تشغيل_فشل_تأكيد سبب الإيقاف عند فشل تأكيد ("An assertion failed" / «فشل تأكيد»)
— اطبع_فشل_تشغيل المسار الوحيد لطباعة فشل التشغيل (std.process.failure)
— البرنامج_بالإنجليزية هل يتكلم البرنامج الإنجليزية: اللغة الأساسية لـ لغة_من_البيئة() ليست ar
— أبلغ_عن_خطأ_نقطة_الدخول الإبلاغ عن الخطأ الذي أعادته main
— إطار_فشل_تشغيل إطار iSpeak لفشل التشغيل (std.process.failure_text، يكتبه المترجم)

التهجئات المعاد تسميتها

أُعيدت تسمية بعض التهجئات العربية لأن الكلمة القديمة لم تكن تعني المفهوم. وباستثناء دالة الدخول، ما زالت التهجئة القديمة مقبولة اسمًا بديلًا مهجورًا (deprecated alias). وهي تُترجم تمامًا كالتهجئة الجديدة، ويُصدر المترجم ذاتي الاستضافة تحذيرًا واحدًا عند كل استعمال، SULTANC-SYNTAX-DEPRECATED-SPELLING، يذكر فيه التهجئتين القديمة والجديدة (أما Stage0 فيقبل التهجئة القديمة دون تحذير). التهجئات الإنجليزية لا تتغير أبدًا.

الإنجليزية العربية القديمة (مهجورة) العربية الجديدة السبب
while بينما طالما طالما تعني «ما دام»، وهذا ما تختبره الحلقة. أما بينما فظرف زمان («أثناء»، «في حين»)، وهي ترجمة حرفية للكلمة الإنجليزية while.
دالة الدخول main لقب المشروع «القلعة» (أُزيل، بلا اسم بديل) الرئيسية الرئيسية تعني «الدالة الرئيسية»، وهو المصطلح المعتاد. الاسم القديم، «القلعة»، كان لقبًا للمشروع؛ ولم يعد معروفًا إطلاقًا، فالبرنامج الذي ما زالت دالة دخوله الوحيدة تحمله يُبلغ عن SULTANC-ENTRYPOINT-NOT-FOUND.
option اختيار اختياري اختياري صفة بمعنى «غير إلزامي»، وهي الكلمة المعتادة لحقل أو قيمة اختيارية. أما اختيار فاسم يدل على فعل الاختيار نفسه (وفي المترجم يعني انتقاء التعليمات).
some / Some بعض (اختيار.بعض) موجود (اختياري.موجود) موجود تقول إن هناك قيمة. أما بعض بالعربية فتدل على التبعيض («بعضٌ من»، «جزءٌ من»)، في حين تعني Some في ML وRust أن هناك قيمة x؛ وللسبب نفسه تستعمل Haskell وElm الاسم Just.
none / None لا_شيء لا_شيء (بلا تغيير) لا يتغير إلا بادئة النوع: اختياري.لا_شيء.
uint غير_موقع طبيعي طبيعي عدد طبيعي. ويشمل الصفر («طبيعي: عدد صحيح ≥ 0، يشمل الصفر»)، مع أن كثيرًا من المصادر العربية تبدأ الأعداد الطبيعية من 1. أما غير_موقع فكانت ترجمة حرفية: موقَّع تعني الوثيقة التي عليها توقيع، لا العدد ذا الإشارة (signed).
u8, u16, u32, u64 غ8, غ16, غ32, غ64 ط8, ط16, ط32, ط64 تأخذ الأنواع الطبيعية ثابتة العرض الحرف الأول من طبيعي، كما يأخذ ص8 الحرف الأول من صحيح.

تهجئات الكلمات المفتاحية المهجورة صفوف في tools/generate/registry/token_registry.def (SULTANC__KEYWORD_DEPRECATED__)، وتهجئات الأنواع السياقية المهجورة صفوف في tools/generate/registry/type_registry.def (SULTANC__TYPE_CONTEXTUAL_DEPRECATED__)؛ أما تهجئات منشئات اختياري فتُطابَق في compiler/frontend/types/type_semantic_shape_queries.sn وفي bootstrap/src/kernel/type/type_tagged.c الخاص بـ Stage0. تحذّر الكلمة المفتاحية عند الرمز نفسه؛ أما اسم النوع السياقي والمنشئ فيحذّران حين تصادفهما مرحلة الأسماء في موضع نوع أو منشئ، ولذلك لا يحذّر متغير محلي اسمه اختيار. أعد كتابة المصادر بالأداة المبنية على المحلل المعجمي، التي لا تغيّر إلا الرموز المعاد تسميتها (لا تمس السلاسل النصية ولا التعليقات ولا المعرّفات الأطول)، ونتيجتها لا تتغير إذا شُغّلت أكثر من مرة:

python3 tools/rename/rename_tokens.py --wave 1 path/to/sources   # بينما -> طالما
python3 tools/rename/rename_tokens.py --wave 7 path/to/sources   # دالة الدخول -> الرئيسية
python3 tools/rename/rename_tokens.py --wave 2 path/to/sources   # اختيار -> اختياري, اختيار.بعض -> اختياري.موجود
python3 tools/rename/rename_tokens.py --wave 3 path/to/sources   # غير_موقع -> طبيعي, غN -> طN
python3 tools/rename/rename_tokens.py --wave 3 --segments path/to/sources   # أصغر_غير_موقع -> أصغر_طبيعي
python3 tools/rename/rename_tokens.py --wave 1 --check path/to/sources   # يعدّ ما تبقى

الأسماء المبنية على الأنواع غير الموقّعة تتبعها (--segments): يصبح المقطع غير_موقع هو طبيعي (أصغر_طبيعي، طبيعي_إلى_نص، عدد_صحيح_طبيعي)، وتصبح الصفة المؤنثة غير_موقعة هي طبيعية (قيمة_حجة_رسالة.طبيعية، قيمة_طبيعية_عشرية_ويب)، وتصبح لغير_موقع هي لطبيعي (سالب_لطبيعي)، ويصبح مقطع العرض غ8…غ64 هو ط8…ط64 (ألحق_ط32_كوف، اقرأ_ط16_صغير). أما سائر استعمالات كلمة غير فلا تتغير. ويحتفظ الاسم العام في المكتبة القياسية باسمه القديم اسمًا بديلًا (عام مرادف أصغر_غير_موقع = أصغر_طبيعي;، عام مرادف خطأ_تحليل_عدد.سالب_لغير_موقع = خطأ_تحليل_عدد.سالب_لطبيعي;)؛ ولا تمس الأداة جدول الأسماء البديلة هذا.

مصطلحات المترجم

الإنجليزية العربية
declaration تصريح
value قيمة
semantic symbol رمز_دلالي
module ID معرف_وحدة
logical module path مسار_وحدة_منطقي
filesystem path مسار_نظام_الملفات
reference مرجع
ownership ملكية
borrow استعارة
move نقل
lowering خفض
basic block كتلة_أساسية
runtime service خدمة_تشغيل
compiler backend خلفية_المترجم
compilation target هدف_الترجمة
ABI واجهة_ثنائية
register allocation تخصيص_السجلات
virtual register سجل_افتراضي
physical register سجل_فعلي
compiler driver منسق_المترجم
module loading تحميل_وحدة

تسمّي مصطلحات المترجم المفهوم بدقة بدل أن تترجم كلمة إنجليزية ملتبسة ترجمة آلية. فكلمات مثل target وobject وload وstore تحمل في مصطلحاتها ما يكفي من السياق للتمييز بين أهداف الترجمة وملفات الكائنات وتحميل الوحدات وعمليات الذاكرة.

الأفعال المستعملة في أسماء المكتبة القياسية

تتبع الأسماء معجمًا للأفعال: أنشئ للإنشاء، واقرأ للقراءة، واضبط للضبط، وأزل لإزالة عنصر (بادئة أو متغير)، وامسح للتفريغ، واحذف لحذف الملفات، وهل_… للسؤال، وحلل للتحليل، وحول_…_إلى_… للتحويل، وابدأ للبدء، وخذ لأخذ قيمة من مالكها (مثل Option::take في Rust)، وتفقد للاستطلاع دون انتظار، واقفل وافتح_قفل للقفل وفكّه، وحاول_… للمحاولة دون انتظار، ونفذ لتنفيذ شيء، وانتظر / أيقظ / نبه للانتظار والإيقاظ والتنبيه، وأرسل / استقبل للإرسال والاستقبال، وأسقط لإسقاط طرف، واستنسخ للاستنساخ، ونسق للتنسيق.

الأخطاء واللغات (std.error)

أسماء std.error (الأخطاء) عربية، ولها أسماء بديلة إنجليزية (مرادف). وتحتفظ القيمة المنطقية خطأ / false وحالتا النتيجة نتيجة.نجح / نتيجة.خطأ بأسمائها.

قيم الخطأ

الإنجليزية العربية المعنى
Error فشل قيمة الخطأ المشتركة (std.error.failure)
error (package) أخطاء std.error / المكتبة.أخطاء
domain النطاق الجزء الدال على المالك في هوية الخطأ
kind النوع الجزء الآلي في هوية الخطأ
cause السبب الخطأ الذي يغلّفه خطأ آخر
note ملاحظة سطر إضافي يُلحق بالخطأ
error_new فشل_من خطأ مخصص
error_with_kind فشل_بهوية خطأ له هوية
error_caused_by فشل_بسبب خطأ مخصص يغلّف سببًا
error_with_kind_caused_by فشل_بهوية_وسبب خطأ له هوية ويغلّف سببًا
error_copy انسخ_فشل نسخ عميق
error_message رسالة_فشل الرسالة
error_domain نطاق_فشل النطاق
error_kind نوع_فشل النوع
error_has_cause له_سبب هل يوجد سبب
error_cause سبب_فشل السبب المباشر
error_notes ملاحظات_فشل الملاحظات
error_is هل_من_نوع البحث عن هوية عبر سلسلة الأسباب
error_add_note أضف_ملاحظة إلحاق ملاحظة
error_describe صف_فشل العرض الموجه للمطوّر
error_print اطبع_فشل العرض الموجه للمطوّر على مجرى الخطأ القياسي
error_from_os_error_class فشل_من_فئة_خطأ_نظام من فئة الخطأ في std.fs
error_from_fs_error فشل_من_خطأ_ملف من حالة في std.fs
error_from_io_error فشل_من_خطأ_دخل_خرج من حالة في std.io
error_from_process_error فشل_من_خطأ_عملية من حالة في std.process
error_from_integer_parse_error فشل_من_خطأ_تحليل_عدد من خطأ تحليل في std.text.number
error_from_json_error فشل_من_خطأ_جسون من خطأ في std.json
error_from_ip_parse_error فشل_من_خطأ_تحليل_آيبي من خطأ تحليل عنوان IP في std.net
error_from_socket_address_parse_error فشل_من_خطأ_تحليل_عنوان_مقبس من خطأ تحليل عنوان مقبس في std.net
with_context مع_سياق على خطأ: يغلّفه سببًا لخطأ جديد (std.error.context)
to_error إلى_فشل تحويل خطأ ذي نوع بقيمة دالة محوِّلة
with_note مع_ملاحظة على خطأ: يضيف ملاحظة

ملاحظة: وبسبب: هما كلمتا الربط الثابتتان في صف_فشل، الذي لا يعرض إلا بالعربية.

اللغات والإعدادات المحلية

الإنجليزية العربية المعنى
language version نسخة لغة رسالة الخطأ بلغة أخرى، تحت وسم BCP 47
language tag وسم لغة وسم BCP 47 مثل ar-SA
locale لغة قائمة أولويات لغات تُمرَّر قيمةً (std.text.language)
Locale لغة نوع الإعداد المحلي (locale)
error_add_language_version أضف_نسخة_لغة إضافة الرسالة بلغة ما
error_text_in نص_فشل_بلغة رسالة الخطأ لإعداد محلي (بحث RFC 4647)
error_describe_in صف_فشل_بلغة العرض الموجه للمطوّر لإعداد محلي
error_print_in اطبع_فشل_بلغة العرض الموجه للمطوّر لإعداد محلي على مجرى الخطأ القياسي
note: / caused by: ملاحظة: / بسبب: كلمات الربط في صف_فشل_بلغة: بالعربية للإعداد المحلي العربي أو عند غيابه، وبالإنجليزية في غير ذلك
locale_from_tag لغة_من_وسم إعداد محلي من وسم واحد
locale_from_accept_language لغة_من_قبول_اللغة إعداد محلي من ترويسة HTTP Accept-Language
locale_from_environment لغة_من_البيئة الإعداد المحلي للبرنامج (std.text.system_language)
locale_tags وسوم_لغة وسوم الإعداد المحلي
locale_tag وسم_لغة الوسم المفضل أولًا في الإعداد المحلي
locale_language اللغة_الأساسية اللغة الأساسية لذلك الوسم
locale_copy انسخ_لغة نسخ إعداد محلي
is_language_tag وسم_لغة_صالح هل النص وسم BCP 47 سليم البنية
normalize_language_tag طبع_وسم_لغة الوسم بحالة الأحرف المعتمدة
language_tag_base اللغة_الأساسية_لوسم الوسم الفرعي للغة الأساسية في الوسم
truncate_language_tag اختصر_وسم_لغة خطوة رجوع واحدة في بحث RFC 4647

اتجاه النص (std.text.bidi)

الإنجليزية العربية المعنى
text_direction اتجاه_نص اتجاه نص (std.text.bidi)
text_direction.neutral اتجاه_نص.محايد محايد
text_direction.left_to_right اتجاه_نص.من_اليسار_إلى_اليمين من اليسار إلى اليمين
text_direction.right_to_left اتجاه_نص.من_اليمين_إلى_اليسار من اليمين إلى اليسار
text_direction_of اتجاه_النص اتجاه أول حرف قوي في النص
bidi_isolate اعزل_اتجاه إحاطة النص بـ U+2068 … U+2069
bidi_isolate_in اعزل_اتجاه_في عزل النص حين يختلف اتجاهه عن اتجاه السياق

مفردات المكتبة القياسية حسب المجال

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

الملفات والمسارات (std.fs)

الوحدة الإنجليزية العربية المعنى
std.fs.links symlink أنشئ_وصلة_رمزية إنشاء وصلة رمزية
read_link اقرأ_وصلة_رمزية قراءة الهدف الذي تشير إليه وصلة
hard_link أنشئ_وصلة_صلبة إنشاء وصلة صلبة
std.fs.permissions permissions اقرأ_أذونات بتات أذونات مسار
set_permissions اضبط_أذونات chmod
is_readonly هل_للقراءة_فقط هل يمنع الوضعُ الكتابة
std.fs.attributes truncate_file اقتطع_الملف ضبط طول ملف
file_handle_set_len اقتطع_مقبض_ملف ضبط الطول عبر مقبض
set_file_times اضبط_أوقات_الملف ضبط وقتي الوصول والتعديل
os_error_class_of فئة_خطأ_حد_نظام تصنيف خطأ عند حدود std.os
std.fs.canonical absolute حول_إلى_مسار_مطلق جعل المسار مطلقًا (معجميًا)
canonicalize مسار_قانوني حل الوصلات و. و..
host_path_flavor صيغة_مسار_المضيف صيغة المسارات في نظام المضيف
std.fs.temporary temp_file ملف_مؤقت ملف مؤقت أُنشئ (مساره ومقبضه)
create_temp_dir / create_temp_dir_in أنشئ_دليلا_مؤقتا / أنشئ_دليلا_مؤقتا_في مجلد مؤقت جديد
create_temp_file / create_temp_file_in أنشئ_ملفا_مؤقتا / أنشئ_ملفا_مؤقتا_في ملف مؤقت جديد
close_temp_file أغلق_ملفا_مؤقتا إغلاقه مع الإبقاء على المسار

| std.fs.lock | file_lock / file_lock_shared | اقفل_الملف / اقفل_الملف_مشتركا | Rust File::lock / lock_shared | | | file_try_lock / file_try_lock_shared | حاول_قفل_الملف / حاول_قفل_الملف_مشتركا | try_lock / try_lock_shared | | | file_unlock | افتح_قفل_الملف | unlock | | | try_lock_error (would_block, os) | خطأ_محاولة_قفل (ستحظر، نظام) | Rust TryLockError |

البيئة (std.env)

الوحدة الإنجليزية العربية المعنى
std.env.variables environment_entry مدخل_بيئة زوج واحد NAME=VALUE
environment_variables متغيرات_البيئة كل المتغيرات
home_directory الدليل_الرئيسي المجلد الرئيسي للمستخدم
set_current_directory غير_دليل_العمل تغيير مجلد العمل
std.env.variables set_environment_variable اضبط_متغير_بيئة Rust env::set_var، Go os.Setenv
remove_environment_variable أزل_متغير_بيئة Rust env::remove_var، Go os.Unsetenv
std.env.system — متغير_بيئة_النظام, دليل_العمل_للنظام, الدليل_المؤقت_للنظام البيئة كما يحتفظ بها النظام (وهي ما يقرؤه المترجم)
std.env.table — جدول البيئة جدول البيئة الذي تملكه المكتبة القياسية

العمليات (std.process)

الوحدة الإنجليزية العربية المعنى
std.process.command command أمر أمر يُراد تشغيله
stdio (inherit, null, piped) مصدر_تيار (وراثة، فارغ، التقاط) ما يتصل به مجرى العملية الفرعية
command_output ناتج_أمر الحالة والخرج الملتقط
command_error (spawn, io, wait) خطأ_أمر (تشغيل، دخل_خرج، انتظار) الموضع الذي فشل فيه تشغيل الأمر
new_command أنشئ_أمرا أمر جديد
command_arg / command_args أضف_وسيطة_للأمر / أضف_وسائط_للأمر إضافة وسائط
command_env / command_env_remove / command_env_clear اضبط_بيئة_للأمر / أزل_بيئة_من_الأمر / امسح_بيئة_الأمر بيئة العملية الفرعية
command_current_dir اضبط_دليل_الأمر مجلد العمل للعملية الفرعية
command_stdin / command_stdout / command_stderr اضبط_دخل_الأمر / اضبط_خرج_الأمر / اضبط_خطأ_الأمر خيارات المجاري
command_input اضبط_بيانات_دخل_الأمر بايتات الدخل
command_status / command_output_of شغل_الأمر / اجمع_خرج_الأمر التشغيل (الحالة) / التشغيل وجمع الخرج
exit_success هل_نجح_الأمر حالة الخروج 0

العمليات الفرعية ذات المجاري

يُسمّى مجرى الخطأ القياسي للعملية الفرعية أخطاء («أخطاء»)، حتى لا يُقرأ أبدًا على أنه القيمة المنطقية خطأ.

الوحدة الإنجليزية العربية المعنى
std.process.command command_spawn ابدأ_الأمر Rust Command::spawn
command_child طفل_أمر عملية فرعية قيد التشغيل (Rust Child)
child_stdin / child_stdout / child_stderr دخل_طفل / خرج_طفل / خرج_طفل مجرى مأخوذ من العملية الفرعية
child_take_stdin / child_take_stdout / child_take_stderr خذ_دخل_الطفل / خذ_خرج_الطفل / خذ_أخطاء_الطفل Rust child.stdin.take()
child_stdin_write / child_stdout_read اكتب_دخل_طفل / اقرأ_خرج_طفل بصيغتي الكاتب والقارئ في std.io
child_stdin_close / child_stdout_close أغلق_دخل_طفل / أغلق_خرج_طفل إغلاق مجرى مأخوذ
child_write_stdin / child_close_stdin اكتب_إلى_الطفل / أغلق_دخل_الطفل كتابة كل البيانات إلى دخل العملية الفرعية أو إغلاقه
child_close_streams أغلق_تيارات_الطفل إغلاق كل الأنابيب التي ما زالت العملية الفرعية تحتفظ بها (بلا دوال هدم)
child_read_stdout / child_read_stderr اقرأ_خرج_الطفل / اقرأ_أخطاء_الطفل قراءة ما كتبته العملية الفرعية
child_wait / child_try_wait / child_kill انتظر_الطفل / تفقد_الطفل / اقتل_الطفل Rust wait، try_wait، kill
child_wait_with_output انتظر_خرج_الطفل Rust wait_with_output
child_id معرف_عملية_الطفل معرّف العملية

الشبكات (std.net)

الوحدة الإنجليزية العربية المعنى
std.net.socket_names udp_datagram حزمة_يو_دي_بي حزمة مستقبلة ومُرسِلها
udp_send_to / udp_recv_from أرسل_إلى_يو_دي_بي / استقبل_من_يو_دي_بي حزم إلى عنوان أو منه
udp_local_addr / udp_peer_addr العنوان_المحلي_يو_دي_بي / عنوان_نظير_يو_دي_بي أسماء المقابس
tcp_local_addr / tcp_peer_addr / tcp_listener_local_addr العنوان_المحلي_تي_سي_بي / عنوان_نظير_تي_سي_بي / العنوان_المحلي_لمستمع_تي_سي_بي أسماء المقابس

يونكس يسمّي عائلة المقابس، كما يسمّي تي_سي_بي بروتوكول TCP.

الوحدة الإنجليزية العربية المعنى
std.net.unix unix_socket_addr (unnamed, pathname, abstract_name) عنوان_يونكس (بلا_اسم، مسار، مجرد) Rust std::os::unix::net::SocketAddr
unix_listener / unix_stream / unix_datagram مستمع_يونكس / تدفق_يونكس / مقبس_رسائل_يونكس UnixListener / UnixStream / UnixDatagram
unix_listener_bind / unix_accept / unix_connect اربط_مستمع_يونكس / اقبل_يونكس / اتصل_يونكس (وكذلك …_بعنوان / …_addr)
unix_read / unix_write / unix_shutdown اقرأ_يونكس / اكتب_يونكس / أوقف_يونكس الدخل والخرج عبر التدفق
unix_local_addr / unix_peer_addr / unix_listener_local_addr العنوان_المحلي_يونكس / عنوان_نظير_يونكس / العنوان_المحلي_لمستمع_يونكس أسماء المقابس
unix_datagram_bind / unix_datagram_unbound / unix_datagram_connect اربط_رسائل_يونكس / رسائل_يونكس_بلا_ربط / اتصل_رسائل_يونكس مقابس الحزم
unix_send_to / unix_recv_from / unix_send / unix_recv أرسل_إلى_يونكس / استقبل_من_يونكس / أرسل_رسائل_يونكس / استقبل_رسائل_يونكس الحزم
unix_datagram_packet حزمة_يونكس حزمة مستقبلة ومُرسِلها
unix_abstract_supported هل_العنوان_المجرد_مدعوم هل الأسماء المجردة متاحة على هذه المنصة

الوقت (std.time)

الوحدة الإنجليزية العربية المعنى
std.time.duration_text format_duration / parse_duration نسق_المدة / حلل_المدة صيغة المدد في Go
duration_error (invalid_format, unknown_unit, overflow) خطأ_مدة (صيغة_غير_صالحة، وحدة_مجهولة، تجاوز) أخطاء التحليل
duration_abs / duration_divide مطلق_المدة / اقسم_المدة القيمة المطلقة والقسمة مع التحقق
std.time.duration_float duration_seconds_f64 / duration_from_seconds_f64 (وكذلك f32) ثواني_المدة_ع64 / مدة_من_ثواني_ع64 (وكذلك ع32) الثواني عددًا عائمًا

الأعداد والرياضيات

ملتف يسمّي الحساب النمطي (modular arithmetic)، ومتحقق يسمّي العملية التي تعيد اختياري.لا_شيء عند الفيضان، ومشبع يسمّي العملية التي تتوقف عند حدود النوع، كما تسمّي std.math.integer دوالها المتحققة والمشبعة (جمع_طبيعي_متحقق، جمع_طبيعي_مشبع). ويأتي النوع بين العملية والصنف: جمع_ط32_ملتف. والإزاحة مؤنثة (إزاحة)، فصفتها ملتفة.

الوحدة الإنجليزية العربية المعنى
std.math.trigonometry sin_f64 / cos_f64 / tan_f64 جيب64 / جيب_تمام64 / ظل64 الجيب وجيب التمام والظل (وكذلك …32)
اللغة x as f64, y as i32 س مثل ع64, ص مثل ص32 التحويل بين الأعداد العائمة والصحيحة (انظر نظام الأنواع، قسم «التحويلات العددية»)
std.math.float f64_to_bits / f64_from_bits بتات_ع64 / ع64_من_بتات أنماط بتات IEEE 754 (وكذلك …ع32)
std.math.wrapping wrapping_add_T / wrapping_sub_T / wrapping_mul_T جمع_T_ملتف / طرح_T_ملتف / ضرب_T_ملتف بباقي القسمة على 2^N
wrapping_shl_T / wrapping_shr_T إزاحة_يسرى_T_ملتفة / إزاحة_يمنى_T_ملتفة الإزاحة بمقدار يؤخذ بباقي القسمة على العرض
checked_add_T / checked_sub_T / checked_mul_T جمع_T_متحقق / طرح_T_متحقق / ضرب_T_متحقق لا شيء عند الفيضان
saturating_add_T / saturating_sub_T / saturating_mul_T جمع_T_مشبع / طرح_T_مشبع / ضرب_T_مشبع محصورة بحدود النوع
الدوال الداخلية للمترجم — بدائي_جمع_ملتف, بدائي_طرح_ملتف, بدائي_ضرب_ملتف, بدائي_إزاحة_يسرى_ملتفة, بدائي_إزاحة_يمنى_ملتفة يوصل إليها عبر أسماء بديلة خاصة، مثل بدائي_بتات_ع64
std.math.float copysign_f64 / round_ties_even_f64 / mul_add_f64 (وكذلك f32) نسخ_إشارة64 / تقريب_زوجي64 / ضرب_جمع_مدمج64 (وكذلك …32) copysign وroundToIntegralTiesToEven والضرب والجمع المدمج في IEEE (انظر نظام الأنواع، قسم «عمليات الفاصلة العائمة»)
الدوال الداخلية للمترجم — بدائي_جذر_تربيعي_عائم, بدائي_قيمة_مطلقة_عائمة, بدائي_أرضية_عائمة, بدائي_سقف_عائم, بدائي_بتر_عائم, بدائي_تقريب_زوجي_عائم, بدائي_أدنى_عائم, بدائي_أقصى_عائم, بدائي_نسخ_إشارة_عائمة, بدائي_ضرب_جمع_مدمج_عائم العمليات البدائية للأعداد العائمة التي تقوم عليها std.math.float؛ وأدنى/أقصى هما minimum/maximum في IEEE

T هو تهجئة النوع نفسه (ص8…ص64، ط8…ط64، عدد، طبيعي) بالعربية، وi8…u64، int، uint بالإنجليزية.

المجموعات (std.collections وعمليات المتجه البدائية)

الوحدة الإنجليزية العربية المعنى
std.collections.vector reverse_vector / rotate_left اعكس_المتجه / دور_المتجه_يسارا إعادة الترتيب في المكان نفسه
index_of_by / contains_by ابحث_في_المتجه / هل_يحتوي_المتجه البحث بدالة مساواة
position_min_by / position_max_by موضع_الأصغر_في_المتجه / موضع_الأكبر_في_المتجه القيم القصوى بدالة ترتيب
اللغة pop(v) أزل_الأخير(م) مثل Vec::pop في Rust: العنصر الأخير قيمةً من نوع اختياري (انظر الملكية، قسم «الإزالة من الآخر والاقتطاع»)
truncate(v, n) اقتطع(م, ن) مثل Vec::truncate في Rust: إسقاط العناصر بعد n (ن: طبيعي)؛ وهو فعل اقتطع_الملف نفسه
std.collections.vector retain / dedup_by احتفظ_في_المتجه / أزل_المتكرر_المتتالي Rust Vec::retain / Vec::dedup_by، Go slices.DeleteFunc / CompactFunc
remove_at / swap_remove / insert_at أزل_عند / أزل_بالتبديل / أدرج_عند Rust Vec::remove / swap_remove / insert
clear_vector امسح_المتجه Rust Vec::clear (يحتفظ بالمخزن)
اللغة capacity(v) سعة(م) Rust Vec::capacity، Go cap: عدد العناصر التي يتسع لها المخزن قبل أن تعيد الإضافةُ تخصيصه
reserve_exact(v, n) احجز_سعة(م, ن) مثل Vec::reserve_exact في Rust: مساحة لـ ن عنصرًا إضافيًا بالضبط (ن: طبيعي)
std.collections.vector with_capacity / reserve / shrink_to_fit متجه_بسعة / احجز_في_المتجه / قلص_المتجه Rust Vec::with_capacity / reserve (بتكلفة موزعة) / shrink_to_fit

النصوص والأعداد العائمة (std.text)

الوحدة الإنجليزية العربية المعنى
std.text.transform split_whitespace / splitn / replacen قسم_بالفراغات / قسم_النص_بحد / استبدل_في_النص_بحد التقسيم والاستبدال
strip_prefix / strip_suffix أزل_البادئة / أزل_اللاحقة إزالة بادئة أو لاحقة
to_ascii_lowercase / to_ascii_uppercase حول_النص_إلى_صغير_أسكي / حول_النص_إلى_كبير_أسكي حالة أحرف ASCII
std.text.search count_matches / char_count / eq_ignore_ascii_case عد_تكرارات_النص / عدد_محارف_النص / نصان_متساويان_بلا_حالة_أسكي العدّ والمقارنة
std.text.float f64_to_string / f32_to_string ع64_إلى_نص / ع32_إلى_نص أقصر نص يُستعاد منه العدد نفسه
parse_f64 / parse_f32, float_parse_error (empty, invalid_format) حلل_ع64 / حلل_ع32, خطأ_تحليل_عائم (فارغ، صيغة_غير_صالحة) تحليل دقيق
std.encoding.utf8 is_valid_utf8_range مدى_يوتيف8_صالح هل مدى البايتات [البداية، النهاية) من نص هو UTF-8 سليم
std.unicode.code_point_text unicode_code_point_text نص_نقطة_يونيكود نقطة الترميز بالصيغة U+XXXX (أربعة أرقام ست عشرية كبيرة على الأقل)
std.chars.ascii is_octal_digit رقم_ثماني رقم ثماني، من 0 إلى 7

التنسيق (std.fmt)

الفعل هو نسق («رتّب، نسّق»): نسق ينسّق، ونسق_في ينسّق داخل منسِّق، واكتب_منسقا يكتب نصًا منسقًا إلى كاتب، واطبع_…_منسقا يطبعه؛ والمنسِّق هو منسق (الذي ينسّق) ومواصفته مواصفة. واحش (pad) يملأ حتى عرض معين، إذ يُسمّى حرف الملء الحشو. والحزمة هي المكتبة.تنسيق (std.fmt). انظر التنسيق.

الوحدة الإنجليزية العربية المعنى
std.fmt.fmt format / format_into نسق / نسق_في مثل format! / write! في Rust إلى String أو Formatter
write_fmt / write_fmt_with اكتب_منسقا / اكتب_منسقا_بمنسق write! إلى كاتب في std.io (بمنسِّق يُعاد استعماله)
print_fmt / println_fmt / eprint_fmt / eprintln_fmt اطبع_منسقا / اطبع_سطرا_منسقا / اطبع_خطأ_منسقا / اطبع_سطر_خطأ_منسقا print! / println! / eprint! / eprintln!
fmt_arg (int, uint, i8…u64, f32, f64, bool, char, text, bytes, ints, texts, list, custom) قيمة_تنسيق (عدد، طبيعي، ص8…ط64، ع32، ع64، منطقي، حرف، نص، بايتات، أعداد، نصوص، قائمة، مخصص) وسيط واحد؛ ومخصص يحمل دالة مغلقة (closure) تعرض نوعًا يعرّفه المستخدم بصيغة العرض أو التصحيح
fmt_error (unclosed_brace, unmatched_close_brace, invalid_spec, unknown_type, named_argument, missing_argument, unused_argument, mismatched_type, invalid_count, write_failed, custom_failed) خطأ_تنسيق (قوس_غير_مغلق، قوس_إغلاق_منفرد، مواصفة_غير_صالحة، نوع_غير_معروف، وسيط_مسمى، وسيط_مفقود، وسيط_غير_مستخدم، نوع_غير_مناسب، عدد_غير_صالح، فشل_الكتابة، فشل_مخصص) خطأ في صيغة التنسيق أو في التنسيق
formatter / fmt_spec منسق / مواصفة_تنسيق Formatter في Rust ومواصفته
fmt_alignment (unknown, left, center, right) محاذاة_تنسيق (بلا، يسار، وسط، يمين) fmt::Alignment
fmt_kind (display, debug, lower_hex, upper_hex, octal, binary, lower_exp, upper_exp, debug_lower_hex, debug_upper_hex) صيغة_تنسيق (عرض، تصحيح، ست_عشري، ست_عشري_كبير، ثماني، ثنائي، أسي، أسي_كبير، تصحيح_ست_عشري، تصحيح_ست_عشري_كبير) نوع العنصر النائب: {} {:?} {:x} {:X} {:o} {:b} {:e} {:E} {:x?} {:X?}
new_formatter / formatter_with_capacity أنشئ_منسقا / أنشئ_منسقا_بسعة منسِّق
formatter_text / take_formatter_text / formatter_length / formatter_clear نص_المنسق / خذ_نص_المنسق / طول_المنسق / امسح_المنسق النسخ، والنقل إلى الخارج، والطول، والتفريغ مع الإبقاء على المخزن
write_str / write_char / pad اكتب_نصا_في_المنسق / اكتب_حرفا_في_المنسق / احش_نصا Formatter::write_str، write_char، pad
formatter_width / formatter_precision / formatter_fill / formatter_align عرض_المنسق / دقة_المنسق / حشو_المنسق / محاذاة_المنسق عرض العنصر النائب ودقته وحرف ملئه ومحاذاته
formatter_alternate / formatter_sign_plus / formatter_sign_aware_zero_pad / formatter_kind / formatter_debug المنسق_بديل / المنسق_بإشارة / المنسق_بأصفار / صيغة_المنسق / المنسق_للتصحيح #، +، 0، والنوع، وهل هو Debug
std.io.log log_fmt سجل_منسقا مدخل سجل منسّق
std.error.from_fmt error_from_fmt_error فشل_من_خطأ_تنسيق خطأ_تنسيق في صورة فشل
std.text.float float_digits / f64_shortest_digits / f64_exact_digits (وكذلك f32) أرقام_عائم / أرقام_ع64_الأقصر / أرقام_ع64_الدقيقة (وكذلك ع32) الأرقام العشرية لعدد عائم لاستعمال المنسِّقات
f64_fixed_digits / f64_significant_digits (وكذلك f32) أرقام_ع64_بخانات_كسرية / أرقام_ع64_بخانات_معنوية (وكذلك ع32) أرقام مقرّبة (عند التساوي إلى الزوجي) إلى N خانة بعد الفاصلة / إلى N رقمًا معنويًا

الضغط ومجاميع التحقق والتجزئة

تُكتب أسماء الصيغ بحروف عربية كما تكتب المكتبة القياسية من قبل جي_زيب (gzip) وتي_إل_إس (TLS): زد_ستد (zstd)، وإكس_زد (xz)، وإل_زد_إم_إيه (LZMA)، وإتش_باك (HPACK)؛ ويُكتب HTTP/2 بالاسم ويب2 إلى جانب ويب1 لـ HTTP/1. ويستعمل الضغط فعلي std.compression.gzip: اضغط (compress) وفك_ضغط (decompress).

الوحدة الإنجليزية العربية المعنى
std.compression.zstd zstd_compress / zstd_compress_with_options اضغط_زد_ستد / اضغط_زد_ستد_بخيارات إطار zstd واحد (RFC 8878)، مع مجموع التحقق أو دونه
zstd_decompress / zstd_decompress_limited / zstd_decompress_with_dictionary / zstd_decompress_with_options فك_ضغط_زد_ستد / …_بحد / …_بقاموس / …_بخيارات فك ترميز كل الإطارات؛ مع حد للخرج، أو قاموس، أو حد للنافذة
std.compression.xz xz_compress, xz_decompress, xz_decompress_limited اضغط_إكس_زد, فك_ضغط_إكس_زد, فك_ضغط_إكس_زد_بحد حاوية .xz
std.compression.lzma lzma_compress, lzma_decompress, lzma2_compress, lzma2_decompress اضغط_إل_زد_إم_إيه, فك_ضغط_إل_زد_إم_إيه, اضغط_إل_زد_إم_إيه2, فك_ضغط_إل_زد_إم_إيه2 ملفات .lzma وLZMA2 الخام
std.hash.xxh64 xxh64, xxh64_with_seed, xxh64_range هاش_إكس_إكس_إتش64, …_ببذرة, …_لمدى XXH64
std.checksum.checksum crc32_update, crc64, crc64_update حدث_سي_ار_سي32, احسب_سي_ار_سي64, حدث_سي_ار_سي64 CRC-32 تدريجي؛ CRC-64/XZ

TLS وHTTP

الوحدة الإنجليزية العربية المعنى
std.tls.config tls_client_config_set_protocols, tls_server_config_set_protocols اضبط_بروتوكولات_عميل_تي_إل_إس, اضبط_بروتوكولات_خادم_تي_إل_إس قوائم ALPN (RFC 7301)
std.tls.stream tls_negotiated_protocol بروتوكول_تدفق_تي_إل_إس بروتوكول ALPN المتفق عليه
std.http.transport http_transport (tcp, tls) ناقل_ويب (تي_سي_بي, تي_إل_إس) ناقل البايتات تحت HTTP/1 وHTTP/2
std.http.server run_https_server, serve_http_connection, serve_https_connection شغل_خادم_ويب_آمن, خدم_اتصال_ويب, خدم_اتصال_ويب_آمن HTTPS مع ALPN؛ اتصال واحد
std.http.http2.hpack hpack_encode_headers, hpack_decode_block رمز_رؤوس_إتش_باك, فك_كتلة_إتش_باك كتل الترويسات
std.http.http2.connection http2_connection, http2_read_and_process_frame, http2_flush_data, http2_send_headers اتصال_ويب2, اقرأ_وعالج_إطار_ويب2, ادفع_بيانات_ويب2, أرسل_رؤوس_ويب2 طبقة الاتصال المشتركة
std.http.http2.client http2_connect, http2_send_requests, http2_close_client اتصل_عميل_ويب2, أرسل_طلبات_ويب2, أغلق_عميل_ويب2 العميل؛ تدفقات متزامنة
std.http.http2.server serve_http2_connection خدم_اتصال_ويب2 جانب الخادم في اتصال واحد

الخيوط والتزامن (std.sync، std.os.wait_address)

أسماء الأنواع أسماء: مشترك («مشترك»: Arc في Rust)، وقفل («قفل»: Mutex)، وقفل_قراءة_كتابة (RwLock)، وشرط_انتظار («شرط انتظار»: Condvar)، ومرة («مرة»)، وخلية_مرة («خلية مرة»: OnceLock)، وقناة («قناة»)، ومرسل / مستلم («مرسل» / «مستلم»؛ لأن مستقبل يسمّي من قبل الـ futex في جداول نداءات النظام). والأفعال من المعجم: أنشئ، واستنسخ (الاستنساخ)، واقرأ (القراءة عبره)، ونفذ (تنفيذ شيء)، وحاول (المحاولة)، وانتظر / أيقظ / نبه (الانتظار / الإيقاظ / التنبيه)، وأرسل / استقبل، وأسقط (إسقاط طرف)، واضبط (الضبط).

الوحدة الإنجليزية العربية المعنى
std.sync.arc arc, arc_new, arc_clone, arc_get مشترك, أنشئ_مشترك, استنسخ_مشترك, اقرأ_مشترك Rust Arc، Arc::new، Arc::clone، Deref
arc_strong_count, arc_ptr_eq, arc_as_ptr عدد_مراجع_مشترك, هل_المشترك_نفسه, مؤشر_مشترك Arc::strong_count، Arc::ptr_eq، Arc::as_ptr
std.sync.mutex mutex, mutex_new, with_lock, try_lock, mutex_is_locked قفل, أنشئ_قفل, نفذ_مع_القفل, حاول_القفل, هل_القفل_مأخوذ Mutex في Rust؛ القفل محجوز طوال دالة مغلقة واحدة (نطاق الحارس)
std.sync.rwlock rwlock, rwlock_new, with_read, with_write قفل_قراءة_كتابة, أنشئ_قفل_قراءة_كتابة, نفذ_مع_قراءة, نفذ_مع_كتابة Rust RwLock::read / write
std.sync.condvar condvar, condvar_new, condvar_wait, condvar_wait_timeout, condvar_wait_while شرط_انتظار, أنشئ_شرط_انتظار, انتظر_الشرط, انتظر_الشرط_بمهلة, انتظر_طالما Rust Condvar::wait، wait_timeout، wait_while
condvar_notify_one, condvar_notify_all نبه_واحدا, نبه_الكل notify_one، notify_all
std.sync.once once, once_new, call_once, once_is_completed مرة, أنشئ_مرة, نفذ_مرة, هل_اكتملت_المرة Rust Once
once_lock, once_lock_new, once_lock_get, once_lock_get_or_init, once_lock_set خلية_مرة, أنشئ_خلية_مرة, اقرأ_خلية_مرة, اقرأ_أو_هيئ_خلية_مرة, اضبط_خلية_مرة Rust OnceLock
std.sync.channel channel, sync_channel, channel_ends قناة, قناة_متزامنة, طرفا_قناة (المرسل, المستلم) mpsc::channel وsync_channel في Rust والزوج الذي تعيدانه
sender, receiver, sender_clone, sender_for, channel_receiver, sync_channel_receiver مرسل, مستلم, استنسخ_مرسل, مرسل_لمستلم, مستلم_قناة, مستلم_قناة_متزامنة الطرفان؛ مستلم وحده ومرسل يُنشأ له
send, try_send, recv, try_recv, recv_timeout أرسل, حاول_الإرسال, استقبل, حاول_الاستقبال, استقبل_بمهلة توابع Rust التي تحمل الأسماء نفسها
drop_sender, drop_receiver أسقط_مرسل, أسقط_مستلم Rust drop(tx) / drop(rx)
try_recv_error (empty, disconnected), recv_timeout_error (timeout, disconnected), recv_error (disconnected), try_send_error (full, disconnected) خطأ_محاولة_استقبال (فارغة، منقطعة), خطأ_استقبال_بمهلة (انتهت_المهلة، منقطعة), خطأ_استقبال (منقطعة), خطأ_محاولة_إرسال (ممتلئة، منقطعة) Rust TryRecvError، RecvTimeoutError، RecvError، TrySendError
std.sync.atomic memory_ordering.relaxed / release / acquire / acq_rel / seq_cst ترتيب_ذاكرة.مسترخ / إطلاق / اكتساب / اكتساب_وإطلاق / تسلسلي Rust Ordering
std.os.wait_address wait_on_address, wake_by_address_single, wake_by_address_all, wait_on_address_supported انتظر_عند_العنوان, أيقظ_واحدا_عند_العنوان, أيقظ_الكل_عند_العنوان, هل_الانتظار_عند_العنوان_مدعوم انتظار وإيقاظ futex (بأسماء WaitOnAddress في Windows)
wait_on_cell, wake_one_on_cell انتظر_عند_الخلية, أيقظ_واحدا_عند_الخلية الشيء نفسه على خلية مجردة بعرض 32 بت
التشخيصات التقاط الخيط التقاط_خيط_مؤشر_خام, التقاط_خيط_مرجع, التقاط_خيط_مشترك_غير_ذري SULTANC-THREAD-CAPTURE-RAW-POINTER، …-REFERENCE، …-NON-ATOMIC-SHARED

محوِّلات الأخطاء

الوحدة الإنجليزية العربية المعنى
std.error error_from_command_error / error_from_duration_error فشل_من_خطأ_أمر / فشل_من_خطأ_مدة محوِّلات

انظر أيضًا