نتائج البحث

بعد إنشاء الدالة setup()‎ التي تهيئ وتضبط القيم الأولية المراد استعمالها، تعمل الدالة loop()‎ على «تكرار» الشيفرة المكتوبة بداخلها -كما يشير اسمها بالضبط- على التوالي متيحةً بذلك لبرنامجك بالتحكم بلوحة أردوينو والتغيُّر والاستجابة للبيئة والعناصر المرتبطة بها. البنية العامة void loop() { // تكتب الشيفرة المراد تكرارها هنا } أمثلة مثالٌ على ربط زرٍ بالرجل 3 وإرسال الحرف "H" عند ضغطه أو الحرف "L" كل ثانية عبر واجهة التخاطب التسلسلية: int buttonPin = 3; // واجهة التخاطب التسلسلية وزر الإدخال setup تهيئ ...

كيفية عمل حلقة for التكرارية حلقة for هي أول وحدة تكرارية في الصدفة من بين ثلاث وحدات، وتسمح تلك الحلقة بتخصيص قائمة من القِيَم، وتُنفَّذ قائمة من الأوامر لكل قيمة من تلك القيم. والبنية اللغوية لهذه الحلقة التكرارية هي كالآتي: for NAME [in LIST ]; do COMMANDS; done إن لم تكن [ in LIST] موجودة فيتم استبدال @$ in بها، وتنفذ for الأوامر (COMMANDS) مرة واحدة لكل معامل موضعي مضبوط على قيمة، انظر المتغيرات في Bash وفحص وسائط سطر الأوامر. وتكون ...

ستتعلم في هذا القسم كيف يمكن للأوامر المتكررة أن تندمج في حلقات تكرارية، وكيف تُبنى الحلقات التكرارية باستخدام عبارات for أو while أو until إحداها أو جميعها معًا، فحلقة for تنفذ مهمة ما عددًا محددًا من المرات، وإن كنت لا تعرف كم عدد مرات تنفيذ الأمر فاستخدم عبارة until أو while لتحديد متى يجب أن تتوقف الحلقة. ويمكن مقاطعة الحلقات أو إعادة تكرارها باستخدام عبارتي break و continue، كما يمكن استخدام ملف كمُدخَل لحلقة عبر معامل إعادة توجيه المدخلات، كذلك ...

كيفية عمل حلقة until تشبه هذه الحلقةُ التكرارية حلقةَ while باستثناء أن الحلقة هنا تُنفَّذ إلى أن يُنفَّذ أمر اختباري TEST-COMMAND بنجاح، فتظل الحلقة عاملة طالما كان تنفيذ الأمر الاختباري يفشل. والبنية اللغوية لها تشبه البنية اللغوية لحلقة while : until TEST-COMMAND; do CONSEQUENT-COMMANDS; done وحالة الإعادة لهذه الحلقة هي نفسها حالة الخروج لآخر أمر يُنفَّذ من الأوامر التابعة CONSEQUENT-COMMANDS أو تكون صفرًا إن لم يُنفَّذ أي أمر. وقد يكون الأمر الاختباري TEST-COMMAND أي أمر يمكن أن يخرج بحالة نجاح أو فشل، ...

كيفية عمل حلقة while تسمح حلقة while التكرارية بالتنفيذ المتكرر لقائمة أوامر طالما أن الأمر المتحكم في حلقة while يُنفَّذ بنجاح (حالة خروجه صفر). والبنية اللغوية لهذه الحلقة هي: while CONTROL-COMMAND; do CONSEQUENT-COMMANDS; done حيث يرمز CONTROL-COMMAND -وهو الأمر الذي سيتحكم في الحلقة- إلى أي أمر يخرج بحالة فشل أو نجاح، بينما قد تكون CONSEQUENT-COMMANDS -وهي الأوامر التي ستُكرَّر- أي برنامج أو برنامج للصدفة أو أحد بُنى الصدفة المختلفة. وتخرج الحلقة فور فشل الأمر المتحكِّم فيها، وإن كانت الحلقة في برنامج ...

إعادة توجيه المُدخلات يمكن تحديد ملف به تعليمات تُستخدم للتحكم في حلقة تكرارية بدلًا من التحكم فيها عن طريق تفقد نتيجة أمر ما أو عن طريق تدخل المستخدم يدويًا، وعادة ما يُستخدم أمر read في هذه الحالة كأمر متحكِّم، ويستمر تنفيذ الحلقة طالما تُغذَّى الحلقة التكرارية بأسطر مدخلات من ذلك الملف، وبمجرد قراءة جميع الأسطر فإن الحلقة تتوقف وتخرج. وبما أن بنية الحلقة التكرارية تُعد بنية لأمر واحد (مثل while TEST-COMMAND; do CONSEQUENT-COMMANDS; done) فإن إعادة التوجيه يجب أن تحدث ...

تعريف بصدفة Bash Bash هي صدفة نظام جنو التي تتوافق مع صدفة بورن وتزيد عليها بعدة مزايا وخصائص مفيدة من باقي الصدفات، وحين تبدأ الصدفة فإنها تقرأ ملفات إعداداتها التي من أهمها ما يلي: etc/profile/ bash_profile./~ bashrc./~ كذلك تتصرف bash بشكل مختلف حين تكون في وضع تفاعلي، وهي متوافقة مع معايير POSIX وبها وضع محظور. ويمكن تقسيم أوامرها إلى ثلاث مجموعات: دوال الصدفة والأوامر المُضمَّنة والأوامر الموجودة داخل مجلد في نظامك. أيضًا، تدعم bash أوامر مضمَّنة أخرى ليست موجودة داخل ...

أمر Break تُستخدم عبارة Break للخروج من الحلقة التكرارية الحالية قبل موعد خروجها الأصلي، ويحدث هذا في الحالات التي لا تعرف فيها عدد المرات التي يجب أن تنفذها الحلقة، كأن تعتمد على إدخال المستخدم مثلًا. يوضح المثال التالي حلقة while يمكن مقاطعتها، وهو مثال مُطوَّر من برنامج wisdom.sh من المثال المشروح في استخدام مُدخلات لوحة المفاتيح للتحكم في حلقة while : #!/bin/bash # هذا البرنامج يطبع أمثالًا ونصائح # يمكنك الخروج الآن بطريقة أفضل. FORTUNE=/usr/games/fortune while true; do echo "On which topic do you want advice?" echo ...

خصائص الشيفرات الجيدة هذا الشرح عن آخر وحدة بناء للصدفة وهي الشيفرات النصية. إليك بعض الأمور التي يجب أن تراعيها قبل أن نكمل: يجب أن تعمل الشيفرة بدون أخطاء. يجب أن تنفذ المهمة التي كُتبت لها. يجب أن يكون منطق البرنامج محددًا وظاهرًا. لا تنفذ الشيفرة مهامًا غير ضرورية. ينبغي أن تكون الشيفرة قابلة لإعادة استخدامها. الهيكل Structure يجب أن يكون هيكل شيفرة الصدفة مرنًا للغاية، فرغم أن bash بها حرية ظاهرة، إلا أنه يجب تحقيق منطق صحيح وتحكم في ...

وظيفة أمر shift هو أحد أوامر صدفة بورن التي تأتي مع صدفة Bash أيضًا، ويأخذ هذا الأمر وسيطًا (argument) واحدًا ويكون ذلك الوسيط رقمًا، وتُنقل المعامِلات الموضعية إلى اليسار بمقدار هذا الرقم "N"، أما المعامِلات التي تلي ذلك، من 1+N وما بعده إلى #$ فإن أسماءها تُغيَّر إلى أسماء متغيرات من 1$ إلى #$ +1 - N. فمثلًا لنقل أن لديك أمرًا يأخذ عشرة وسائط، وN تساوي 4، إذًا 4$ تصبح 1$، و 5$ تصبح 2$ وهكذا إلى أن تصل ...

صفحة man للإشارات يحتوي نظامك على صفحة man بها كل الإشارات المتاحة، لكن قد يُفتح بطريقة مختلفة اعتمادًا على نظام تشغيلك، والطريقة التي ستجدها في أغلب أنظمة لينكس هي man 7 signal، لكن إن كنت في ريب من الأمر فحدد صفحة man والقسم الذي تريده بالضبط باستخدام أوامر مثل: man -k signal | grep list أو apropos signal | grep list ستجد أسماء الإشارات باستخدام kill -l. الإشارات إلى صدفة Bash الخاصة بك تتجاهل صدفة bash التفاعلية إشارتي SIGTERM و SIGQUIT في ...

توفر الدوال طريقة سهلة لتجميع أوامر تحتاج إلى تنفيذها بشكل متكرر، وحين تعمل الدالة فإن المعامِلات الموضعية (positional parameter) تتغير إلى معامِلات الدالة، ثم يعاد ضبط تلك المعاملات بعد توقف الدالة إلى معاملات البرنامج المُستدعِي. وكذلك فإن الدوال تشبه برامج مصغرة (mini-scripts)، ومن ثَمَّ فإنها تولِّد رموز حالة خروج (exit codes) أو رموز حالة إعادة (return codes). مقدمة إلى الدوال في Bash نظرة عامة على الدوال في Bash والبُنى اللغوية لها ومعامِلاتها الموضعية وعرضها في الصدفة. أمثلة عن الدوال في ...

يمكن إعداد بيئة Bash على مستوى النظام ككل أو لكل مستخدم على حدة، وتُستخدم ملفات الإعدادات المختلفة من أجل ضبط سلوك الصدفة، إذ تحتوي تلك الملفات على خيارات الصدفة وإعدادات المتغيرات وتعريفات الدوال ووحدات أخرى من وحدات بناء صدفة Bash التي تيسر علينا إنشاء بيئة عمل مريحة ومنجِزة. يمكن اختيار أسماء للمتغيرات كما تشاء -نوعًا ما- باستثناء الأسماء المحجوزة لصدفة بورن وصدفة Bash والمعامِلات الخاصة (special parameters). وتستخدم Bash نظام اقتباس (quoting) لاستبعاد المعاني الخاصة من محرف أو أكثر في ...

قد تحتاج إلى تحديد سلاسل إجراءات مختلفة داخل برامج الصدفة (shell scripts) بناءً على نجاح تنفيذ أمر أو فشله، وتأتي أداة if الشرطية من أجل مثل تلك الحالات، وأصغر بنية لغوية لأمر if هي التالية: if TEST-COMMANDS; then CONSEQUENT-COMMANDS; fi تُنفَّذ قائمة أوامر الاختبار TEST-COMMANDS، ثم تُنفَّذ قائمة الأوامر التابعة CONSEQUENT-COMMANDS إن كانت حالة الإعادة لها هي صفر. وتكون حالة الإعادة هي حالة خروج آخر أمر تم تنفيذه، أو تكون صفرًا إن لم تتحقق أي حالة من أوامر الاختبار. يتضمن أمر ...

عام قد تجد حالات لا تريد فيها من يستخدم شيفراتك النصية أن يخرج قبل الوقت المحدد عن طريق اختصارات لوحة المفاتيح حين تحتاج إلى مدخلات مثلًا أو عند القيام بعملية تنظيف، ويمكن استخدام أمر trap ليلتقط إشارات لوحة المفاتيح تلك، ويمكن برمجته مسبقًا لينفِّذ قائمة أوامر عند التقاط تلك الإشارات. قواعد أمر trap واضحة ومباشرة: trap [الإشارات] [الأوامر] هذا يجعل أمر trap يلتقط الإشارات المُعطاة له، والتي قد تكون أسماء إشارات مع سابقة SIG أو بدونها، أو تكون أرقام إشارات. وإن ...

بعد تقسيم الأمر في Bash إلى وحدات (Tokens) -انظر وحدات البناء الأساسية في Bash، البنية اللغوية للصدفة- فإن تلك الوحدات توسَّع (expanded) أو تُستبيَن (resolved)، وسنفصّل الآن تلك التوسعات وفقًا لترتيب كل منها، ثم بعد إتمام جميع التوسعات تُنفّذ عملية حذف الاقتباسات. توسُّع القوس المعقوف {} توسع القوس المعقوف هو آلية يمكن من خلالها إنشاء نصوص عشوائية (arbitrary strings)، إذ تأخذ الأنماط (patterns) التي سيُنفَّذ عليها توسع القوس المعقوف باستهلال اختياري (optional preamble) متبوع بسلسلة من النصوص تفصل بين كل ...

صدفة Bash وبرامج Bash البرامج الشائعة للصَّدَفة وظائف الصدفة وما تفعله إضافة إلى أنواعها المختلفة (sh، bash، csh، ... ) مزايا صدفة Bash استعراض لأهم مزايا صدفة Bash، مثل الصور المختلفة لاستدعاءات الصدفة، والتعابير الحسابية والشرطية والصدفة المحظورة، وكذلك الأوامر البديلة والمصفوفات، ... . تنفيذ الأوامر في Bash توضيح لما يحدث عند تنفيذ الأوامر في صدفة Bash، واستعراض لأهم الأوامر المُضمَّنة فيها. وحدات البناء الأساسية شرح للوحدات الأساسية التي تشكل صدفة Bash، مثل الأوامر والدوال والمعامِلات والتوسعات والبنية اللغوية، إضافة ...

أنواع المتغيرات تُكتب متغيرات الصدفة بحروف إنجليزية كبيرة، وتحتفظ Bash بقائمة من نوعين من المتغيرات: المتغيرات العامة Global Variables ستجد المتغيرات العامة أو متغيرات البيئة (environment variables) في جميع الصدفات، ويمكن استخدام أوامر env أو printenv لعرض متغيرات البيئة، وتأتي تلك البرامج في حزمة sh-utils. إليك مثالًا لخرج أمر printenv: wiki ~> printenv CC=gcc CDPATH=.:~:/usr/local:/usr:/ CFLAGS=-O2 -fomit-frame-pointer COLORTERM=gnome-terminal CXXFLAGS=-O2 -fomit-frame-pointer DISPLAY=:0 DOMAIN=hq.garrels.be e= TOR=vi FCEDIT=vi FIGNORE=.o:~ G_BROKEN_FILENAMES=1 GDK_USE_XFT=1 GDMSESSION=Default GNOME_DESKTOP_SESSION_ID=Default GTK_RC_FILES=/etc/gtk/gtkrc:/nethome/wiki/.gtkrc-1.2-gnome2 GWMCOLOR=darkgreen GWMTERM=xterm HISTFILESIZE=5000 history_control=ignoredups HISTSIZE=2000 HOME=/nethome/wiki HOSTNAME=hsoub.hq.garrels.be INPUTRC=/etc/inputrc IRCNAME=wiki JAVA_HOME=/usr/java/j2sdk1.4.0 LANG=en_US LDFLAGS=-s LD_LIBRARY_PATH=/usr/lib/mozilla:/usr/lib/mozilla/plugins LESSCHARSET=latin1 LESS=-edfMQ LESSOPEN=|/usr/bin/lesspipe.sh %s LEX=flex LOCAL_MACHINE=hsoub LOGNAME=wiki LS_COLORS=no=00:fi=00:di=01;34:ln=01;36:pi=40;33:so=01;35:bd=40;33;01:cd=40;33;01:or=01;05;37;41:mi=01;05;37;41:ex=01;32:*.cmd=01;32:*.exe=01;32:*.com=01;32:*.btm=01;32:*.bat=01;32:*.sh=01;32:*.csh=01;32:*.tar=01;31:*.tgz=01;31:*.arj=01;31:*.taz=01;31:*.lzh=01;31:*.zip=01;31:*.z=01;31:*.Z=01;31:*.gz=01;31:*.bz2=01;31:*.bz=01;31:*.tz=01;31:*.rpm=01;31:*.cpio=01;31:*.jpg=01;35:*.gif=01;35:*.bmp=01;35:*.xbm=01;35:*.xpm=01;35:*.png=01;35:*.tif=01;35: MACHINES=hsoub MAILCHECK=60 MAIL=/var/mail/wiki MANPATH=/usr/man:/usr/share/man/:/usr/local/man:/usr/X11R6/man MEAN_MACHINES=hsoub MOZ_DIST_BIN=/usr/lib/mozilla MOZILLA_FIVE_HOME=/usr/lib/mozilla MOZ_PROGRAM=/usr/lib/mozilla/mozilla-bin MTOOLS_FAT_COMPATIBILITY=1 MYMALLOC=0 NNTPPORT=119 NNTPSERVER=news NPX_PLUGIN_PATH=/plugin/ns4plugin/:/usr/lib/netscape/plugins OLDPWD=/nethome/wiki OS=Linux PAGER=less PATH=/nethome/wiki/bin.Linux:/nethome/wiki/bin:/usr/local/bin:/usr/local/sbin:/usr/X11R6/bin:/usr/bin:/usr/sbin:/bin:/sbin:. PS1=\[\033[1;44m\]wiki is in \w\[\033[0m\] PS2=More input> PWD=/nethome/wiki SESSION_MANAGER=local/hsoub.hq.garrels.be:/tmp/.ICE-unix/22106 SHELL=/bin/bash SHELL_LOGIN=--login SHLVL=2 SSH_AGENT_PID=22161 SSH_ASKPASS=/usr/libexec/openssh/gnome-ssh-askpass SSH_AUTH_SOCK=/tmp/ssh-XXmhQ4fC/agent.22106 START_WM=twm TERM=xterm TYPE=type USERNAME=wiki USER=wiki _=/usr/bin/printenv VISUAL=vi WINDOWID=20971661 XAPPLRESDIR=/nethome/wiki/app-defaults XAUTHORITY=/nethome/wiki/.Xauthority XENVIRONMENT=/nethome/wiki/.Xdefaults XFILESEARCHPATH=/usr/X11R6/lib/X11/%L/%T/%N%C%S:/usr/X11R6/lib/X11/%l/%T/%N%C%S:/usr/X11R6/lib/X11/%T/%N%C%S:/usr/X11R6/lib/X11/%L/%T/%N%S:/usr/X11R6/lib/X11/%l/%T/%N%S:/usr/X11R6/lib/X11/%T/%N%S XKEYSYMDB=/usr/X11R6/lib/X11/XKeysymDB XMODIFIERS=@im=none XTERMID= XWINHOME=/usr/X11R6 X=X11R6 YACC=bison -y المتغيرات المحلية Local Variables لن تجد المتغيرات المحلية إلا في الصدفة الحالية، ويمكن استخدام أمر set -بدون خيارات- لعرض ...

إنشاء المصفوفات المصفوفة هي متغير يحتوي قيمًا متعددة، وأي متغير قد يُستخدم كمصفوفة، كذلك لا يوجد حد أقصى لحجم المصفوفة ولا يُشترط أن تُفهرس المتغيرات داخل المصفوفة أو تُعيَّن في وقت واحد، وقد تكون المصفوفات صفرية القاعدة أي يُفهرس أول عنصر برقم صفر. ينفَّذ التصريح غير المباشر عن المتغير (indirect declaration) باستخدام البنية اللغوية التالية: ARRAY[INDEXNR]=value يعامَل المفهرِس INDEXER على أنه تعبير حسابي يجب أن يٌقدَّر بعدد موجب، ويتم التصريح الواضح (explicit declaration) للمصفوفة باستخدام أمر declare: declare -a ARRAYNAME يُقبَل التصريح ...

وحدات بناء الصدفة البنية اللغوية للصدفة (Shell Syntax) إن كان المُدخَل ليس تعليقًا (comment) فإن الصدفة تقرؤه وتقسمه إلى كلمات ومعامِلات مطبِّقة قواعد الاقتباس (quoting rules) لتحدد معنى كل مِحرَف (character)، ثم تُترجَم تلك الكلمات والمعامِلات إلى أوامر وعناصر أخرى ينتج عنها حالة الخروج المناسبة للعملية. ولا تُطبَّق آلية fork-exec التي ذكرناها في تنفيذ الأوامر في Bash إلا بعد أن تحلل الصدفة المُدخلات وفقًا للخطوات الآتية: تقرأ الصدفة المُدخلات من ملف، سواء من نص (string) أو من طرفية المستخدم. يُقسَّم ...

ناقشنا بعض خيارات صدفة Bash التي قد تفيدك في تنقيح برامج Bash، وسننظر الآن في مزيد من تلك الخيارات بتفصيل أكثر. عرض الخيارات استخدم خيار o- لأمر set لعرض كل خيارات الصدفة: hsoub:~> set -o allexport off braceexpand on emacs ...

صدفة bash هي الصدفة الافتراضية لنظام جنو يوفّر مشروع GNU -إذ يشير الاسم إلى GNU's Not UNIX- أدواتٍ لإدارة النظم الشبيهة بنظام يونكس، وهي نظم التشغيل الحرة والمتوافقة مع معايير يونكس. وإحدى تلك الأدوات هي bash، صَدَفة متوافقة مع صدفة sh الأولى التي كتبها ستيفن بورن، وبها خصائص مفيدة من صدفتي Korn و C -اختصاراتهما ksh و csh على الترتيب-. وقد صُممت لتتوافق مع معيار IEEE POSIX P1003.2/ISO 9 945.2 للصدفات والبرامج.  كما أن بها مزايا محسّنة عن sh سواء ...

عام تحدد bash نوع البرنامج الذي يتم تنفيذه، وتكون البرامج هنا عادة أوامر للنظام في صورة مُجمّعة (compiled) على جهازك. وحين يتم تنفيذ أحد تلك البرامج، فإن bash تنشئ نسخة من نفسها، وتولد عملية جديدة بناء على ذلك، ويدعى ذلك الإجراء بالاشتقاق (forking). وتلك العملية الفرعية لديها نفس بيئة العملية الأصلية، ولا تختلفان إلا في رقم معرّف العملية (Process ID Number) لكل منهما. وتحِل بيانات العملية الجديدة محِل مساحة العنوان (address space) بعد الاشتقاق ، ويتم ذلك الإجراء من خلال ...

التعيين العام للقيَم لم نركز كثيرًا في الشرح السابق لصدفة Bash على أنواع المتغيرات التي كنا نعيِّنها لأن Bash تستطيع التعامل مع أنواع متعددة من المتغيرات والمعامِلات، ونتيجة لذلك فإن متغيراتنا يمكنها احتواء أي نوع نختاره من البيانات، انظر المثال التالي للتوضيح: [hsoub in ~] VARIABLE=12 [hsoub in ~] echo $VARIABLE 12 [hsoub in ~] VARIABLE=string [hsoub in ~] echo $VARIABLE string وستكون حالات تريد فيها تجنب هذا السلوك من المثال السابق حين تتعامل مع أرقام الهواتف وغيرها مثلًا، وقد تحتاج أن تحدد متغيرًا ثابتًا (Constant ...

سنتعلم في هذا الباب كيف نبني سلاسل شرطية في برامجنا بحيث نستطيع اتخاذ إجراءات مختلفة بناء على نجاح الأوامر أو فشلها، وستُحدد تلك الإجراءات باستخدام عبارة if، وسيسمح هذا بتنفيذ مقارنات حسابية ونصية، واختبار رموز الخروج والمدخلات والملفات التي يحتاجها البرنامج. عادة ما يسبق الأوامر في برامج الصدفة اختبارُ if/then/fi لمنع إنشاء الخرج كي يعمل البرنامج في الخلفية أو من خلال أداة cron، أما الشروط الأكثر تعقيدًا فتوضع في عبارة case. ويخبر البرنامج الصدفة الأم عند نجاح اختبار الشرط باستخدام ...

فائدة اقتباس المحارف تحمل كثيرًا من المحارف والكلمات معاني ووظائف خاصة بشكل أو بآخر، ويُستخدم الاقتباس لإلغاء ذلك المعنى أو الوظيفة الخاصة، إذ تعطِّل علامات التنصيص في Bash تلك المعاملة التي يلقاها المحرف الخاص، وتمنع معاملة الكلمات الخاصة وفقًا للمعاني التي تحملها، وكذلك تعطِّل توسع المعامِلات. محارف الهروب تُستخدم محارف الهروب لإلغاء المعنى الخاص لمحرف واحد، وتُستخدم الشرطة المائلة الخلفية \ كمحرف للهروب في Bash، إذ تحتفظ بالمعنى المباشر للمحرف الذي يليها باستثناء محرف السطر الجديد، فإن أتى محرف سطر ...

يلقي هذا الباب الضوء على المزايا المُضمَّنة في Bash لمطابقة الأنماط (patterns) والتعرف على فئات المحارف ومداها. إضافة إلى تفصيل للتعابير النمطية (Regular Expressions)، إذ هي أدوات قوية لاختيار أسطر بعينها من ملفات أو من مُخرج ما، وتستخدمها أوامر كثيرة في يونكس مثل vim و perl وقاعدة بيانات PotgreSQL وغيرها، كما يمكن إضافتها في أي لغة أو تطبيق باستخدام مكتبات خارجية، بل قد تجدها في أنظمة غير أنظمة يونكس، إذ يستخدمها برنامج Excel للجداول الذي يأتي في حزمة مكتب ويندوز. ...

قد تُرسل الإشارات إلى برامجك باستخدام أمر kill أو اختصارات على لوحة المفاتيح، ويمكن التقاط تلك الإشارات وتنفيذ أوامر بناءً على ذلك باستخدام أمر trap، ورغم أن بعض البرامج تتجاهل الإشارات إلا أن إشارة kill لا يمكن تجاهلها من أي برنامج. الإشارات في Bash نظرة عامة على الإشارات وإرسالها واستخدامها مع أمر kill. الأفخاخ في Bash نظرة عامة على الأفخاخ في Bash وكيف تفسرها الصدفة وأمثلة عليها.

التنقيح على مستوى البرنامج ككل حين تحدث مشكلة في البرنامج الذي كتبته فإنك في حاجة إلى وضع يدك على مكان المشكلة بالتحديد داخل الشيفرة، وتوفر Bash مزايا تنقيح شاملة لعل أشهرها هو بدء صدفة فرعية بخيار x- الذي سيبدأ الصدفة بالكامل في طور التنقيح، وستُطبَع آثار كل أمر إضافة إلى وسائطه (arguments) إلى خَرج قياسي (standard output) بعد توسيع الأوامر لكن قبل تنفيذها. الشيفرة التالية هي لبرنامج commented-script1.sh من مثال أساسيات كتابة برامج Bash، وقد استدعينا الصدفة في طور التنقيح ...

ما هي الدوال؟ دوال الصدفة طريقة لتجميع أوامر من أجل تنفيذها لاحقًا باستخدام اسم واحد للمجموعة ككل أو روتين، ويجب أن يكون اسم الروتين فريدًا لا يتكرر في الصدفة أو الشيفرة النصية، وتُنفَّذ كل الأوامر التي تكوِّن الدالة مثل الأوامر العادية تمامًا. تُنفَّذ قائمة الأوامر المرتبطة باسم دالة حين تُستدعى تلك الدالة كأمر بسيط، وتُنفَّذ الدالة داخل الصدفة التي صُرِّح عنها فيها، فلا تُفتح عملية جديدة لتفسير الأوامر. وستظهر الأوامر الخاصة المُضمَّنة قبل دوال الصدفة أثناء البحث عن الأوامر، والأوامر ...

فائدة الأوامر البديلة يسمح الأمر البديل (Alias) بوضع كلمة واحدة مكان مقطع نصي (string)، وذلك إن استُخدم كأول كلمة من أمر بسيط، وتحتفظ الصدفة بقائمة من الأوامر البديلة التي يمكن ضبطها وإلغاء ضبطها بأمريْ alias و unalias. اكتب alias في سطر الأوامر لترى قائمة من الأوامر البديلة المعرَّفة للصدفة الحالية: hsoub: ~> alias alias ..='cd ..' alias ...='cd ../..' alias ....='cd ../../..' alias PAGER='less -r' alias Txterm='export TERM=xterm' alias XARGS='xargs -r' alias cdrecord='cdrecord -dev 0,0,0 -speed=8' alias e='vi' alias egrep='grep -E' alias ewformat='fdformat -n /dev/fd0u1743; ewfsck' alias fgrep='grep -F' alias ftp='ncftp -d15' alias ...

إعادة التدوير ستجد برامج كثيرة على نظامك تستخدم الدوال كطريقة منظمة لمعالجة سلسلة ما من الأوامر، ففي بعض أنظمة لينكس مثلًا ستجد الملف التعريفي etc/rc.d/init/functions/ يشار إليه كمصدر في كل شيفرات init النصية. وبهذا الأسلوب لا تحتاج إلى كتابة المهام المتكررة سوى مرة واحدة وبشكل عام أيضًا، مهام مثل تفقد ما إن كانت تعمل إحدى المهام، تشغيل أو إيقاف أحد العفاريت (daemons)، وهلم جرا. ثم إذا دعت الحاجة إلى كتابة تلك المهام مرة أخرى فإنك لا تحتاج سوى إعادة تدوير ...

العمليات الحسابية على المتغيرات ناقشنا العمليات الحسابية من قبل في التوسعات في Bash، انظر التوسع الحسابي. طول المتغير استخدم صيغة {VAR#}$ لحساب عدد المحارف في متغير ما، وإن كان VAR هو أحد المحرفيْن * أو @ فإن القيمة يحل محلها عدد المعامِلات الموضعية أو عدد العناصر داخل المصفوفة بشكل عام، انظر المثال التالي: [hsoub in ~] echo $SHELL /bin/bash [hsoub in ~] echo ${#SHELL} 9 [hsoub in ~] ARRAY=(one two three) [hsoub in ~] echo ${#ARRAY} 3 عمليات التحول في المتغيرات الإحلال Substitution {VAR:-WORD}$ إن لم ...

برنامج الصدفة هو سلسلة من الأوامر يعاد استخدامها بشكل متكرر، ووُضعت في ملف نصي له إذن تنفيذ كبرنامج، ويمكن استخدام أي محرر نصي لكتابة برامج لصدفة Bash. تبدأ برامج bash بـ !# متبوعيْن بمسار الصفة التي ستنفذ الأوامر التي ستُكتب في البرنامج، وتضاف التعليقات إلى البرنامج للمرجعية فيما بعد ولتيسير فهم الشيفرة على من يقرؤها. يُفضل الإسهاب في التعليقات داخل برامج الصدفة على الإيجاز فيها. تُنقَّح الصدفة باستخدام خيارات الصدفة، ويمكن استخدام تلك الخيارات للتنقيح الجزئي أو لتحليل الشيفرة كاملة، ...

يمكن للمتغير أن يحتوي أي نوع من البيانات ما لم يُصرح بخلاف ذلك بوضوح، وتُضبط المتغيرات الساكنة (Constant Variables) باستخدام أمر readonly. وتحتوي المصفوفة على مجموعة من المتغيرات، وإن صُرح بنوع معين من البيانات لتلك المصفوفة فإن جميع العناصر داخلها ستُضبط على احتواء ذلك النوع فقط من البيانات. كذلك تسمح مزايا Bash بإحلال وتحويل المتغيرات بسرعة، وتتضمن العمليات القياسية حساب طول المتغير والتوسعات الحسابية عليه وإحلال محتواه أو جزء من محتواه. أنواع المتغيرات في Bash شرح للقيم العامة للمتغيرات والمتغيرات ...

في أي صدفة سيعمل البرنامج؟ يجب أن تحدد الصدفة التي ستنفِّذ البرنامج إذا أردت تنفيذه في صدفة فرعية، فقد لا تكون الصدفة التي كتبت فيها البرنامج هي الصدفة الافتراضية لنظامك، وعليه قد تُنتِج أوامر برنامجك أخطاءً عند تنفيذها في الصدفة الخطأ. يحدد أول سطر في البرنامج نوع الصدفة، ويجب أن يكون أول محرفين في ذلك السطر !#، ثم يتلو ذلك مسار الصدفة التي ستنفِّذ البرنامج. كذلك لا تبدأ برنامجك بسطر فارغ إذ تُقرأ الأسطر الفارغة على أنها أسطر أيضًا، وستبدأ ...

ملفات الإعدادات على مستوى النظام System-wide Configuration files الملف etc/profile/ تقرأ Bash التعليمات الموجودة في etc/profile/ إن استدعيْت بشكل تفاعلي عبر خيار login-- أو إن استدعيْت كـ sh ، تضبط تلك التعليمات عادة المتغيرات PATH - USER - MAIL - HOSTNAME - HISTSIZE ، وهي متغيرات تابعة للصدفة. كذلك تُضبط قيمة umask في etc/profile/ على بعض الأنظمة، أما في بعضها الآخر فإن هذا الملف يحتوي على موجّهات (pointers) لملفات الإعدادات الأخرى مثل: ملف etc/inputrc/ ، وهو ملف تهيئة على مستوى ...

الوظائف العامة للصدفة يفسر برنامج صَدَفة يونكس أوامر المستخدم التي يدخلها بنفسه أو التي يمكن استخراجها وقراءتها من ملف نصي يسمى شيفرة الصَّدَفة النصية (shell script) أو برنامج الصدفة (shell program). وتكون تلك الملفات النصية مفسّرة (interpreted) على خلاف الملفات المُجمّعة (compiled)، بمعنى أن الصدفة تقرأ الأوامرَ سطرًا سطرًا وتبحث عنها في النظام، على خلاف البرامج المُجمَّعة التي يحوِّل المُجمِّع (compiler) شيفرتها إلى ملف تنفيذي (executable file) مكتوب بلغة يستطيع الحاسوب فهمها -لغة الآلة-، ثم يُمكن استخدام ذلك الملف بعدها ...

سنتعلم في هذا القسم كيف نُدخل تعليقات المستخدم وكيف نطلب من المستخدم إدخال بيانات، وذلك عادة باستخدام بُنية echo/read، كما سنناقش كيف يمكن استخدام الملفات كمُدخلات ومخرجات باستخدام واصفات الملفات وإعادة التوجيه، وكيف يمكن جمع ذلك مع الحصول على مُدخلات من المستخدم. ويركز هذا الباب أيضًا على أهمية توفير رسائل مفصلة لمن يستخدم برامج الصدفة التي نكتبها، فمن الأفضل أن تعطي معلومات أكثر من اللازم بدلًا من كتابة توثيق موجز. مستندات Here هي إحدى أنواع بُنى الصدفة التي تسمح بإنشاء ...

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

استخدام أمر read أمر read هو الأمر المتمم لأمريْ echo و printf، وبنيته اللغوية كالتالي: read [options] NAME1 NAME2 ... NAMEN يُقرأ سطر واحد من المُدخل القياسي (standard input) أو من واصف ملف (file descriptor) أُدخِل كوسيط لخيار u-، وتُعيَّن أول كلمة من السطر لأول اسم NAME1، والثانية للاسم الثاني NAME2 وهكذا، ثم تُعيَّن الكلمات المتبقية وفاصلاتها المتداخلة (intervening seperators) إلى الاسم الأخير NAMEN، أما إن كانت الكلمات المقروءة من مجرى الدخل أقل من الأسماء فتعيَّن قيم فارغة لتلك الأسماء. تُستخدم ...

الكتابة والتسمية إن كان لديك سلسلة أوامر تنفذها بشكل متكرر وتريد اختصار وقت تنفيذها أو تنفيذها بشكل آلي، فيمكنك وضعها في ملف فارغ يكتب بصيغة معينة وتقرؤه الصدفة على أنه برنامج تنفذه عند استدعاءه بكتابة اسم الملف الذي يحويه، وتسمى تلك البرامج ببرامج الصدفة أو شيفرات الصدفة النصية (Shell Scripts). ويمكن استخدام تلك البرامج لأتمتة المهام باستخدام أداة cron أو في إجراءات الإقلاع وإيقاف التشغيل في أنظمة يونكس، حيث يُحدَّد أسلوب عمل العفاريت (daemons) والخدمات في شيفرات init النصية (init ...

عام استخدام أمر select البُنية اللغوية لأمر select تشبه بُنية حلقة for: select WORD [in LIST]; do RESPECTIVE-COMMANDS; done ويُستخدم أمر select من أجل إنشاء قوائم بسهولة عبر اتباع ما يلي: تُوسّع القائمة LIST مولِّدة قائمة من العناصر ويطبع التوسع في خطأ قياسي (standard error)، كما يُسبق كل عنصر من القائمة برقم. وإن لم تكن in LIST موجودة فتُطبع المعامِلات الموضعية كما لو تم تحديد @$ in. أيضًا، تُطبع قائمة LIST مرة واحدة فقط. يُطبع محث PS3 عند طباعة كل العناصر، ...

حالات مُبسطة قد يكون من السهل اللجوء إلى استخدام عبارات if لبداهة أسلوبها، لكن تلك السهولة تنقلب إلى حيرة حين تواجه بضعة اختيارات مختلفة لإجراءات محتملة يجب اتخاذها، ولمثل تلك الحالات نستخدم عبارة case، وبنيتها اللغوية هي كما يلي: case EXPRESSION in CASE1) COMMAND-LIST;; CASE2) COMMAND-LIST;; ... CASEN) COMMAND-LIST;; esac وتطابق كل حالة في التعبير السابق نمطًا (pattern)، وتُنفَّذ الأوامر التي في قائمة COMMAND-LIST لأول تطابق، ويُستخدم محرف الأنبوب | لفصل الأنماط المتعددة، وينهي معامِل ( قائمة الأنماط، ويُطلق اسم البند ...

بُنى if/then/else يوضح المثال التالي البُنية التي يجب استخدامها لاتخاذ إجراء أو سلسلة إجراءات إن تحققت شروط عبارة if، وسلسلة إجراءات أخرى إن لم تتحقق: hsoub scripts> gender="male" hsoub scripts> if [[ "$gender" == "f*" ]] More input> then echo "Pleasure to meet you, Madame." More input> else echo "How come the lady hasn't got a drink yet?" More input> fi How come the lady hasn't got a drink yet? hsoub scripts> الفرق بين [] و [[]] على عكس ]، فإن ]] تمنع انقسام الكلمات في ...

التعابير النمطية Regular Expressions التعبير النمطي (Regular Expression) هو أسلوب يصف مجموعة من النصوص (strings)، وتُبنى تلك التعابير النمطية بشكل تناظري للتعابير الحسابية (arithmetic expressions) باستخدام عدة معامِلات لدمج التعابير الأصغر. وأصغر وحدة بنائية للتعابير النمطية هي تلك التي تطابق محرفًا واحدًا، ذلك أن أغلب المحارف -بما في ذلك كل الحروف والأرقام- ما هي إلا تعابير نمطية تطابق أنفسها، ويمكن اقتباس أي محرف خاص (metacharacter) له معنىً خاص بسبْقِه بشرطة مائلة خلفية \. المحارف الخاصة للتعابير النمطية يمكن إتْباع التعبير ...

مدى المحارف Character Ranges خلافًا لأمر grep والتعابير النمطية (regular expressions) فإن لدينا حالات كثيرة لمطابقة الأنماط التي يمكنك إجراؤها في الصدفة مباشرة دون الحاجة إلى استخدام برنامج خارجي، فلعلك تعلم أن محرفي * و ? يطابقان أي نص أو محرف وحيد -على الترتيب-، ومن أجل مطابقة هذين المحرفيْن تحديدًا، ضع حول كل منهما علامات اقتباس مزدوجة: hsoub ~> touch "*" hsoub ~> ls "*" * يمكنك استخدام الأقواس المربعة لمطابقة أي محرف أو مجموعة محارف بداخل تلك الأقواس إن فُصلت أزواج المحارف ...

ينفذ التابع loop الكتلة البرمجية المعطاة بشكل متكرر. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator بدلاً من ذلك. يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إيقاف الحلقة التكرارية. في هذه الحالة، سيعيد التابع loop قيمة "النتيجة" المخزنة في الاستثناء. البنية العامة loop { block } loop→ an_enumerator‎ القيمة المعادة يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إعادة قيمة "النتيجة" المخزنة في الاستثناء. أما في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator. أمثلة مثال على ...

تهدف حلقة WHILE إلى تكرار عددٍ من التعليمات باستمرار تحقق الشرط ضمنها، إذ يُتأكَّد من تحقّق الشرط قبل البدء بتنفيذ التعليمات التي تحتويه، وتكون البنية العامّة لها: [ <<label>> ] WHILE boolean-expression LOOP statements END LOOP [ label ]; إذ يمكن تحديد تسمية label لها وتوضع التعليمات statements ضمنها بعد الكلمة المفتاحية LOOP. أما في محرك MySQL فتصبح بالشكل الآتي: [begin_label:] WHILE search_condition DO statement_list END WHILE [end_label]; وفي محرك SQL Server تكون بالشكل: WHILE boolean_expression { sql_statement | ...

يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. البنية العامة to_a → Array القيمة المعادة تُعاد مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم متغيرات البيئة. أمثلة مثال عن استخدام التابع to_a: ENV.to_a # => [["TERM", "xterm-color"], ["SHELL", "/bin/bash"], ...] انظر أيضًا التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_a في الصنف ENV في توثيق روبي الرسمي.

تعابير القفز تمتاز لغة Kotlin بوجود ثلاثة تعابير (expressions) لنقل سياق البرنامج وهي: return: للرجوع من أقرب دالةٍ محيطةٍ (enclosing) أو دالةٍ مجهولةٍ (anonymous function). break : تنهي أقرب حلقةٍ محيطة. continue : تستمر بالخطوة التالية لأقرب حلقةٍ محيطة. إذ يُسمَح باستخدام أيّ من التعابير السابقة كجزءٍ من تعبيرٍ أكبر، مثل: val s = person.name ?: return ونوع هذه التعابير هو Nothing type. تسمية الأوامر Break و Continue يٌتاح في لغة Kotlin تحديد تسميةٍ (label) لأيّ تعبير، إذ تتألف هذه التسمية من مُحدِّدٍ ...

تملك المتغيرات في لغة C، التي اشتقَّت لغة أردونيو منها، خاصيةً تدعى scope (مجال) تحدِّد مجال استعمال هذه المتغيرات ومن يمكنه الوصول إليها. هذا يختلف عن الإصدارات الحديثة للغاتٍ مثل BASIC التي يكون فيها المتغير عامًّا (global) دومًا. المتغيرات العامة يمكن أن تراها جميع الدوال في البرنامج. من جهة أخرى، تكون المتغيرات المحلية (local variables) مرئية في الدالة التي عُرَّفت ضمنها فقط وغير متاحة للدوال الأخرى. في بيئة أردونيو IDE، أي متغيِّر يُعرَّف خارج دالةٍ (مثل الدالة setup()‎ والدالة loop()‎ ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

تستدعى الدالة setup()‎ أولًا عند البدء بتنفيذ الشيفرة (المخطط [sketch] كما تُطلِق عليه أردوينو)، إذ تُستَعمل لتهيئة المتغيرات، وأوضاع الأرجل، وواجهات التخاطب، والبدء باستعمال المكتبات ...إلخ. انتبه إلى أنَّ الدالة setup()‎ ستُنفَّذ مرةً واحدةً فقط بعد تشغيل لوحة أردوينو أو تصفيرها (reset). البنية العامة void setup() { // تهيَّأ هنا المتغيرات والأرجل وواجهات التخاطب والمكتبات ...إلخ } أمثلة مثالٌ على تهيئة وبدء واجهة التخاطب التسلسلية وتهيئة الرجل 3 لتصبح في وضع الإدخال: int buttonPin = 3; void setup() { Serial.begin(9600); pinMode(buttonPin, ...

تُستعمَل الكلمة المفتاحية void مع الدوال التي يُعرِّفها المبرمج في الشيفرة لتُشير إلى أنَّه لا يُتوقَّع أن تعيد هذه الدالة بعد انتهاء تنفيذها أيَّة بيانات إلى من استدعاها. بناءً على هذا التعريف، لا يُفترَض استعمال الكلمة المفتاحية return ضمن الدالة التي يصرَّح عنها بالكلمة void المفتاحية. البنية العامة void function () { // الكتلة البرمجية التي ستنفذها الشيفرة } أمثلة توضح الشيفرة التالية كيفية استعمال void مع الدالة setup()‎ والدالة loop()‎ للإشارة إلى أنَّهما لن تعيدان أي شيء بعد ...

يعين التابع priority عند استدعائه بالشكل priority= integer أولوية المهمة الفرعية التي استدعيت معه إلى القيمة integer. سيتم تشغيل المهام الفرعية ذات الأولوية العالية بشكل أكثر تكرارًا من مثيلاتها ذات الأولوية المنخفضة (ولكنها ستشُغّل على أي حال). هذا مجرد تلميح يستعمله مُجدوِل المهام الفرعية (thread scheduler) في روبي. قد يتم تجاهله على بعض الأنظمة التشغيل. البنية العامة priority= integer→ thr‎ أمثلة مثال على استخدام التابع priority=‎: count1 = count2 = 0 a = Thread.new do loop ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chown()‎ مالك الملف. الوصف bool chown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة ...

يغلق التابع close الطابور الذي استُدعي معه. لا يمكن إعادة فتح طابور الانتظار المُغلق. بعد اكتمال استدعاء طلب الإغلاق، سيكون التالي صحيحًا: سيعيد التابع ?closed  القيمة true. سيُتجاهل التابع close إن استدعي مرة أخرى مع نفس الطابور. استدعاء التابع enq أو التابع push أو المعامل>>  سيرمي استثناءً. عندما يُعيد التابع ?empty  القيمة false، سيُعيد استدعاء التابع deq أو pop أو shift كائنًا من طابور الانتظار كالمعتاد. الاستثناء ClosedQueueError موروثٌ من الصنف StopIteration، لذلك يمكنك كسر كتلة حلقة التكرار (loop block). البنية العامة close أمثلة مثالٌ عن ...

يُطلق الاستثناء SecurityError لوقف عملية التكرار (iteration)، خصوصًا عبر التابع Enumerator.next. يُعالج هذا الاستثناء بالتابع Kernel.loop. loop do puts "Hello" raise StopIteration puts "World" end puts "Done!" سيُنتج: Hello Done! توابع النسخة العامة result يعيد القيمة المعادة من المُكرر (iterator). مصادر صفحة الصنف StopIteration في توثيق روبي الرسمي.

يُطلق الاستثناء Interrupt عند استقبال إشارة المقاطعة (interrupt signal)، عادةً لأن المستخدم ضغط على Ctrl-C (على معظم منصات POSIX). وعلى هذا النحو، فهو صنف فرعي من SignalException. begin puts "Press ctrl-C when you get bored" loop {} rescue Interrupt => e puts "Note: You will typically use Signal.trap instead." end ستُنتج عند تنفيذها: Press ctrl-C when you get bored ثم انتظر إلى أن يُقاطع بالضغط على Ctrl-C، وحينها ستطبع المخرجات التالية: Note: You will typically use Signal.trap instead. مصادر قسم الصنف ...

ينهي التابع kill المهمة الفرعية المعطاة. يشبه هذا التابع كثيرًا التابع exit. البنية العامة kill(thread)→ thread‎ المعاملات thread‎ المهمة الفرعية المراد قتلها. القيمة المعادة تعاد مهمة فرعية. أمثلة مثال على استخدام التابع kill‎: count = 0 a = Thread.new { loop { count += 1 } } sleep(0.1) #=> 0 Thread.kill(a) #=> #<Thread:0x401b3d30 dead> count #=> 93947 a.alive? #=> ...

تُستعمَل الكلمة المفتاحية static عند إنشاء متغيرات مرئيَّة لدالةٍ واحدة فقط من أجل الحفاظ على محتواها بعد انتهاء تنفيذ تلك الدالة المستدعاة وحتى الاستدعاء التالي لها خلافًا للمتغيرات المحلية التي تُنشَأ وتدمَّر في كل مرة تُستدعَى فيها الدالة. ستُنشَأ وتُهيَّأ المتغيرات الساكنة المصرَّح عنها ضمن الدالة مع الكلمة static المفتاحية أول مرة تُستدعَى فيها تلك الدالة فقط. البنية العامة static dataType var = val; يمثِّل dataType نوع المتغير المراد تعريفه، و var اسم المتغير، و val القيمة المراد إسنادها إلى هذا ...

يجلب التابع available()‎ عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. يمثِّل هذا العدد كمية البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة للمنفذ التسلسلي ذي الحجم 64 بايت. يرث التابع available()‎ من الصنف Stream. البنية العامة Serial.available() // فقط Mega لوحات أردوينو Serial1.available() Serial2.available() Serial3.available() القيم المعادة يعاد عدد البايتات المستلمة والمتاحة للقراءة. أمثلة يعيد المثال التالي المحرف المستلم عبر واجهة التخاطب التسلسلية: // متغير لتخزين البيانات الآتية من المنفذ التسلسلي int incomingByte = 0; void setup() { ...

تصنَّف الكلمة volatile المفتاحية ضمن «مقيدات المتغيرات» (variable qualifier)، وتُستعمَل عادةً قبل نوع المتغير عند تعريفه لتعديل الطريقة التي يعامل فيها المصرِّف والبرنامج اللاحق هذا المتغير. تمثِّل الكلمة volatile المفتاحية عند استعمالها في تعريف متغير توجيهًا (directive) للمصرِّف نفسه. المصرِّف هو برنامج وظيفته تحويل الشيفرة المكتوبة بلغة ++C/C إلى شيفرة تنفيذية يفهمها العتاد؛ تحوي هذه الشيفرة التنفيذية أوامر فعلية للمتحكم الموجود على لوحة أردوينو تخبره بما يتوجب عليه فعله. الأمر الذي تفعله الكلمة volatile المفتاحية مع المتغير هو توجيه المصرِّف ...

المعاملات الرياضية (arithmetic operators) تأخذ قيمًا عدديةً وتُعيد قيمةً عدديةً واحدةً، والمعاملات الرياضية القياسية هي الجمع + والطرح - والضرب * والقسمة /. الجمع (+) معامل الجمع يُنتِج مجموع المدخلات الرقمية، أو يضيف سلسلتين نصيتين إلى بعضها. البنية العامة x + y أمثلة // رقم + رقم -> عملية جمع 1 + 2 // 3 // رقم + قيمة منطقية -> عملية جمع true + 1 // 2 // قيمة منطقية + قيمة منطقية -> عملية جمع false + false // 0 // رقم + سلسلة ...

تحول الدالة byte()‎ القيمة المُمرَّرة إليها إلى النوع «بايت» (byte). البنية العامة byte(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد بايتٌ يمثِّل ناتج تحويل القيمة x. أمثلة مثال على استعمال الدالة byte()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(byte('a')); // 97 Serial.println(byte(10)); // 10 } انظر أيضًا الدالة char()‎: تحول القيمة المُمرَّرة إليها إلى النوع «محرف» (char). الدالة float()‎: تحول القيمة المُمرَّرة إليها إلى النوع «عدد عشري» (float). ...

تحول الدالة char()‎ القيمة المُمرَّرة إليها إلى النوع «محرف» (char). البنية العامة char(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد محرفٌ يمثِّل ناتج تحويل القيمة x. أمثلة مثال على استعمال الدالة char()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(char(65)); // A Serial.println(char('a')); // a } انظر أيضًا الدالة byte()‎: تحول القيمة المُمرَّرة إليها إلى النوع «بايت» (byte). الدالة float()‎: تحول القيمة المُمرَّرة إليها إلى النوع «عدد عشري» (float). ...

تحول الدالة long()‎ القيمة المُمرَّرة إليها إلى النوع «عدد طويل» (long). البنية العامة long(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد عددٌ طويلٌ يمثِّل ناتج تحويل القيمة x. أمثلة مثال على استعمال الدالة long()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(long(123456.789)); // 123456 Serial.println(long('a')); // 97 } انظر أيضًا الدالة byte()‎: تحول القيمة المُمرَّرة إليها إلى النوع «بايت» (byte). الدالة char()‎: تحول ...

تحول الدالة int()‎ القيمة المُمرَّرة إليها إلى النوع «عدد صحيح» (integer). البنية العامة int(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد عددٌ صحيحٌ يمثِّل ناتج تحويل القيمة x. أمثلة مثال على استعمال الدالة int()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(int(1.23)); // 1 Serial.println(int('a')); // 97 } انظر أيضًا الدالة byte()‎: تحول القيمة المُمرَّرة إليها إلى النوع «بايت» (byte). الدالة char()‎: تحول القيمة المُمرَّرة إليها إلى النوع «محرف» ...

تعيد الدالة interrupts()‎ تفعيل عمل المقاطعات بعد إيقافها عبر استدعاء الدالة nointerrupts()‎. تسمح المقاطعات بتنفيذ مهام معيَّنة في الخلفية وتكون مفعَّلة افتراضيًّا. لن تعمل بعض الدوال وقد تُتجاهل بعض الاتصالات الواردة إن كانت المقاطعات معطَّلة. يمكن للمقاطعات أن تُحدِث خللا بسيطًا في توقيت البرنامج؛ مع ذلك، قد تُعطَّل في بعض الأجزاء المهمة والحرجة من الشيفرة. البنية العامة interrupts() القيم المعادة لا يعاد أي شيء. أمثلة استعمال الدالة interrupts()‎ لتفعيل المقاطعات بعد تعطيلها في الأجزاء المهمة: void setup() {} void loop() { ...

تعطِّل الدالة noInterrupts()‎ عمل جميع المقاطعات في لوحة أردوينو. يمكن إعادة تفعيلها عبر استدعاء الدالة interrupts()‎. تسمح المقاطعات بتنفيذ مهام معيَّنة في الخلفية وتكون مفعَّلة افتراضيًّا. لن تعمل بعض الدوال وقد تُتجاهل بعض الاتصالات الواردة إن كانت المقاطعات معطَّلة. يمكن للمقاطعات أن تُحدِث خللا بسيطًا في توقيت البرنامج؛ مع ذلك، قد تُعطَّل في بعض الأجزاء المهمة والحرجة من الشيفرة. البنية العامة noInterrupts() القيم المعادة لا يعاد أي شيء. أمثلة استعمال الدالة noInterrupts()‎ لتعطيل المقاطعات في الأجزاء المهمة من الشيفرة ثم ...

تحول الدالة float()‎ القيمة المُمرَّرة إليها إلى النوع «عدد عشري» (float). البنية العامة float(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد عددٌ عشريُّ يمثِّل ناتج تحويل القيمة x. ملاحظات وتحذيرات اطلع رجاءً على توثيق العدد العشري لمزيد من التفاصيل حول دقة الأعداد التي تلي الفاصلة العشرية في أردوينو. أمثلة مثال على استعمال الدالة float()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(float(10)); ...

تحول الدالة word()‎ القيمة المُمرَّرة إليها إلى النوع «كلمة» (word). البنية العامة word(x) word(h, l) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. h القيمة المراد تحويلها والتي ستمثِّل البايت العلوي (أقصى اليسار) للكلمة. l القيمة المراد تحويلها والتي ستمثِّل البايت السفلي (أقصى اليمين) للكلمة. أمثلة مثال على استعمال الدالة word()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(word(1.23)); // 1 Serial.println(word('a')); // 97 } القيم المعادة تعاد كلمةٌ تمثِّل ناتج تحويل القيمة x ...

يبدأ التابع begin()‎ عملية محاكاة (emulating) لفأرة افتراضية موصولة بالحاسوب المتصل باللوحة. يجب استدعاء هذا التابع قبل بدء التحكم بالحاسوب. إن أردت إنهاء هذه العملية، فاستدعِ التابع end()‎. البنية العامة Mouse.begin() القيم المعادة لا يعاد أي شيء. أمثلة إرسال رسالة إلى الحاسوب عبر لوحة مفاتيح افتراضية متصلة به عند الضغط على زر موصول بالرجل 2: #include <Mouse.h> void setup(){ pinMode(2, INPUT); } void loop(){ // عند الضغط على الزر المتصل بالرجل 2 Mouse تهيئة وبدء المكتبة if(digitalRead(2) == HIGH){ ...

يعيد التابع sub نسخة من السلسلة النصية التي استدعي معها مع تبديل قيمة محدَّدة مع أول تطابق للنمط المعطى. البنية العامة sub(pattern, replacement) → new_str sub(pattern, hash) → new_str sub(pattern) {|match| block } → new_str إن أعطيت كتلة block إلى التابع، فستُمرَّر السلسلة الحالية المتطابقة إليها وستعيَّن قيم متغيرات مثل ‎$1، و ‎$2، و ‎$`‎، و ‎$&‎، و ‎$'‎ بشكل مناسب. ستحل القيم التي تعيدها الكتلة مكان القيمة المتطابقة في كل استدعاء. المعاملات pattern يكون عادةً تعبيرًا نمطيًّا. إن كان سلسلة نصية، فستُفسَّر أية محارف ...

يضبط التابع begin()‎ معدل تدفق البتات في الثانية الواحدة (baud) لبدء عملية نقل البيانات عبر الاتصال التسلسلي. من أجل التواصل مع الحاسوب، استعمل أحد معدلات تدفق البيانات التالية: 300، أو 600، أو 1200، أو 2400، أو 4800، أو 9600، أو 14400، أو 19200، أو 28800، أو 38400، أو 57600، أو 115200. مع ذلك، تستطيع تحديد معدلات نقل أخرى للتواصل عبر الرجلين 0 و 1 مع جهاز أو عنصر يتطلب معدل تدفق بيانات محدَّد غير تلك المذكورة. يضبط المعامل الثاني الاختيار ...

تحسب الدالة bit()‎ قيمة بت محدَّد (قيمة البت 0 هي 1، والبت 1 هي 2، والبت 2 هي 4 وهلم جرًّا). البنية العامة bit(n) المعاملات n البت المراد حساب قيمته. القيم المعادة تعاد قيمة البت n المحسوبة. أمثلة مثال على استعمال الدالة bit()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(bit(1)); // 2 Serial.println(bit(5)); // 32 } انظر أيضًا الدالة bitClear()‎: تُصفِّر قيمة بت محدَّد (أي تجعل قيمته 0) لمتغير عددي. الدالة bitRead()‎: تقرأ قيمة بت محدَّد لعدد. ...

(PHP 5 >= 5.3.0, PHP 7) يمكن استخدام عامل goto للانتقال إلى قسم آخر في البرنامج، وتعيّن نقطة الانتقال هذه بواسطة وسم متبوعٍ بنقطتين رأسيتين (:)، وتكون طريقة الانتقال باستخدام العامل goto متبوعًا بالوسم المراد الانتقال إليه. هناك بعض القيود المفروضة على استخدام goto، إذ يجب أن يكون الوسم الهدف في نفس الملف ونفس السياق (context)، بمعنى أنّه لا يمكن الانتقال من داخل الدالة أو التابع إلى الخارج كما لا يمكن الانتقال إلى الداخل. لا يمكن أيضًا الانتقال إلى أي ...

(PHP 5 >= 5.3.0, PHP 7) يمكن استخدام عامل goto للانتقال إلى قسم آخر في البرنامج، وتعيّن نقطة الانتقال هذه بواسطة وسم متبوعٍ بنقطتين رأسيتين (:)، وتكون طريقة الانتقال باستخدام العامل goto متبوعًا بالوسم المراد الانتقال إليه. هناك بعض القيود المفروضة على استخدام goto، إذ يجب أن يكون الوسم الهدف في نفس الملف ونفس السياق (context)، بمعنى أنّه لا يمكن الانتقال من داخل الدالة أو التابع إلى الخارج كما لا يمكن الانتقال إلى الداخل. لا يمكن أيضًا الانتقال إلى أي ...

يوقف التابع end()‎ عملية محاكاة (emulating) وصل فأرة افتراضية بالحاسوب المتصل باللوحة. إن أردت إعادة التحكم بالفأرة مجدَّدًا، فاستدعِ التابع begin()‎. البنية العامة Mouse.end() القيم المعادة لا يعاد أي شيء. أمثلة الضغط على زر الفأرة الأيسر في موقع المؤشر الحالي عند الضغط على الزر الموصول بالرجل 2: #include <Mouse.h> void setup(){ pinMode(2,INPUT); // Mouse تهيئة وبدء المكتبة Mouse.begin(); } void loop(){ // إن ضُغِط على الزر المتصل بالرجل 2، فضغط زرالفأرة الأيسر //then end the Mouse emulation ...

يضيف المعامل =+ أيَّ نوع من البيانات إلى نهاية سلسلة نصية معيَّنة. البنية العامة string += data القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال المعامل =+: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); while(!Serial) ; stringValue += "Wiki"; Serial.println(stringValue); // wiki HsoubWiki } void loop() { // افعل شيئًا عنا } انظر أيضًا المعامل []: يوفر إمكانية الوصول إلى محرف محدَّد من محارف السلسلة النصية المستعملة معه ...

يعيد التابع length()‎ عدد محارف السلسلة النصية التي استدعيت معه. البنية العامة string.length() تمثِّل string السلسلة النصية التي يراد معرفة طولها. القيم المعادة يعاد عدد محارف السلسلة النصية المعطاة. انتبه إلى أنَّ هذا العدد لا يشمل محرف الإنهاء null. أمثلة مثال على استعمال الدالة length()‎: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { Serial.println(stringValue.length()); // 10 } انظر أيضًا التابع compareTo()‎: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. التابع equals()‎: يتحقَّق إن كانت ...

يعيد التابع length()‎ عدد محارف السلسلة النصية التي استدعيت معه. البنية العامة string.length() تمثِّل string السلسلة النصية التي يراد معرفة طولها. القيم المعادة يعاد عدد محارف السلسلة النصية المعطاة. انتبه إلى أنَّ هذا العدد لا يشمل محرف الإنهاء null. أمثلة مثال على استعمال الدالة length()‎: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { Serial.println(stringValue.length()); // 10 } انظر أيضًا التابع compareTo()‎: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. التابع equals()‎: يتحقَّق إن كانت ...

تستخرج الدالة lowByte()‎ البايت السفلي (الواقع في أقصى اليمين) لمتغير أو البيانات المُمرَّرة إليها. البنية العامة lowByte(x) المعاملات x أيُّ نوع من البيانات المراد استخراج البايت السفلي منها. القيم المعادة يعاد البايت السفلي (الواقع في أقصى اليمين) للبيانات x. أمثلة مثال على استعمال الدالة lowByte()‎: word value = 0011010011101011; void setup() { Serial.begin(9600); } void loop() { Serial.println(highByte(value), BIN); // 10000010 Serial.println(lowByte(value), BIN); // 00001001 } انظر أيضًا الدالة bit()‎: تحسب قيمة بت محدَّد (قيمة البت 0 هي 1، ...

يحوِّل التابع toUpperCase()‎ جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case). بدءًا من الإصدار 1.0، أصبح التابع toUpperCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toUpperCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الكبيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toUpperCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toUpperCase()‎ جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case). بدءًا من الإصدار 1.0، أصبح التابع toUpperCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toUpperCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الكبيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toUpperCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toLowerCase()‎ جميع حروف السلسلة النصية التي استدعيت معها إلى حروف صغيرة (lower-case). بدءًا من الإصدار 1.0، أصبح التابع toLowerCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toLowerCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الصغيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toLowerCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toLowerCase()‎ جميع حروف السلسلة النصية التي استدعيت معها إلى حروف صغيرة (lower-case). بدءًا من الإصدار 1.0، أصبح التابع toLowerCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toLowerCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الصغيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toLowerCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

تُستعمَل الحلقة for لتكرار كتلة برمجية معينة من الشيفرة عددًا محدَّدًا من المرات. يُستعمَل في هذه الحلقة عادةً عدادٌ لتتبع عدد مرات تكرار الشيفرة ومقاطعتها عند الوصول إلى عدد محدَّد. يمكن استعمال الحلقة for مع أية عملية تكرارٍ، وتُستعمَل بكثرة مع المصفوفات لتنفيذ عملية معينة على عناصرها التي قد تكون بيانات عادية أو أرجل معينة. البنية العامة for (خطوة ;الشرط ;التهيئة الأولية) { // الكتلة البرمجية المراد تكرارها; } تنفَّذ عملية التهيئة الأولية مرةً واحدةً فقط في بداية تنفيذ الحلقة. يُتحقَّق من الشرط ...

يشبه التابع enum_for التابع Kernel.to_enum باستثناء أنه يعيد مُعدِّدًا كسولًا (كائن من النوع Enumerator::Lazy). يجعل هذا من السهل تعريف توابع الصنف Enumerable التي ستبقى كسولة بشكل طبيعي إن استدعيت من مُعدِّد كسول (lazy enumerator). البنية العامة enum_for(method = :each, *args) → lazy_enum enum_for(method = :each, *args){|*args| block} → lazy_enum المعاملات method تابع. القيمة الافتراضية هي: each:. args الوسائط المُمرَّرة إلى التابع method. القيمة المعادة يعاد مُعدِّدٌ كسولٌ (كائن من النوع Enumerator::Lazy). أمثلة المثال التالي هو تكملة للمثال الموجود في صفحة التابع Kernel.to_enum: # ...

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. البنية العامة string.toInt() تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ صحيحٍ. القيم المعادة يعاد عددٌ طويلٌ يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ بعددٍ صحيحٍ صالح، فسيُعاد العدد 0 آنذاك. أمثلة مثال على استعمال التابع toInt()‎: String stringValue1 = "12wiki Hsoub"; String stringValue2 = "wiki12Hsoub"; void setup() { Serial.begin(9600); } void ...

يزيل التابع trim()‎ جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه. بدءًا من الإصدار 1.0، أصبح التابع يعدل السلسلة النصية المعطاة نفسها بدلًا من أن يعيد سلسلة نصية أخرى ناتجة عن عملية إزالة المسافات البيضاء من السلسلة النصية الأصلية. وبالتالي، كن حذرًا من استعمال هذه الدالة.  البنية العامة string.trim() تمثِّل string السلسلة النصية التي يراد حذف المسافات البيضاء من بدايتها ونهايتها. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع remove()‎: String stringValue = " ...

يشبه التابع to_enum التابع Kernel.to_enum باستثناء أنه يعيد مُعدِّدًا كسولًا (كائن من النوع Enumerator::Lazy). يجعل هذا من السهل تعريف توابع الصنف Enumerable التي ستبقى كسولة بشكل طبيعي إن استدعيت من مُعدِّد كسول (lazy enumerator). البنية العامة to_enum(method = :each, *args) → lazy_enum to_enum(method = :each, *args) {|*args| block} → lazy_enum المعاملات method تابع. القيمة الافتراضية هي: each:. args الوسائط المُمرَّرة إلى التابع method. القيمة المعادة يعاد مُعدِّدٌ كسولٌ (كائن من النوع Enumerator::Lazy). أمثلة المثال التالي هو تكملة للمثال الموجود في صفحة التابع Kernel.to_enum: ...

يحول التابع toCharArray()‎ كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكوَّنة من مصفوفة من المحارف. البنية العامة string.toCharArray(buf, len) تمثِّل string السلسلة النصية التي يراد نسخها إلى الذاكرة buf ذات الحجم len التي تمثِّل مصفوفةً من المحارف. المعاملات buf الذاكرة المراد نسخ محارف السلسلة النصية المعطاة إليها. تمثِّل هذه الذاكرة مصفوفة من المحارف. len عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toCharArray()‎: String stringValue ...

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. البنية العامة string.toInt() تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ صحيحٍ. القيم المعادة يعاد عددٌ طويلٌ يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ بعددٍ صحيحٍ صالح، فسيُعاد العدد 0 آنذاك. أمثلة مثال على استعمال التابع toInt()‎: String stringValue1 = "12wiki Hsoub"; String stringValue2 = "wiki12Hsoub"; void setup() { Serial.begin(9600); } void ...

يزيل التابع trim()‎ جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه. بدءًا من الإصدار 1.0، أصبح التابع يعدل السلسلة النصية المعطاة نفسها بدلًا من أن يعيد سلسلة نصية أخرى ناتجة عن عملية إزالة المسافات البيضاء من السلسلة النصية الأصلية. وبالتالي، كن حذرًا من استعمال هذه الدالة.  البنية العامة string.trim() تمثِّل string السلسلة النصية التي يراد حذف المسافات البيضاء من بدايتها ونهايتها. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع remove()‎: String stringValue = " ...

يحول التابع toCharArray()‎ كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكوَّنة من مصفوفة من المحارف. البنية العامة string.toCharArray(buf, len) تمثِّل string السلسلة النصية التي يراد نسخها إلى الذاكرة buf ذات الحجم len التي تمثِّل مصفوفةً من المحارف. المعاملات buf الذاكرة المراد نسخ محارف السلسلة النصية المعطاة إليها. تمثِّل هذه الذاكرة مصفوفة من المحارف. len عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toCharArray()‎: String stringValue ...

النوع boolean هو نوع غير قياسي، وهو اسمٌ بديل للنوع bool المُعرَّف في أردوينو. يُنصَح باستعمال النوع القياسي bool عوضًا عن هذا النوع الذي يماثله تمامًا. البنية العامة bool var = val; يمثِّل var اسم المتغير المراد التصريح عنه، وتمثِّل val القيمة المراد إسنادها إلى هذا المتغير وهي إمَّا true أو false.  أمثلة يوضح المثال التالي كيفية استعمال النوع boolean لجعل الضوء المتصل بالرجل 5 يومض كلما ضُغِط على القاطعة الموصولة بالرجل 13: int LEDpin = 5; // ضوء ...

يوقف التابع end()‎ عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل. إن أردت إعادة وصل لوحة المفاتيح، فاستدعِ التابع begin()‎. البنية العامة Keyboard.end() القيم المعادة لا يعاد أي شيء. أمثلة محاكاة عملية وصل لوحة مفاتيح بالحاسوب المتصل باللوحة وإرسال رسالة بالضغط على مفاتيحه ثم فصله: #include <Keyboard.h> void setup() { // بدء وصل لوحة المفاتيح Keyboard.begin(); // إرسال ضغطات لعدة مفاتيح إلى الحاسوب Keyboard.print("Hello!"); // إنهاء عمل لوحة المفاتيح Keyboard.end(); } void loop() { // افعل ...