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

نبذة عن المعاملات المفتاحية

في Common Lisp تُسمى المعاملات المُسمّاة معاملات الكلمات المفتاحية.

تُحدَّد معاملات الكلمات المفتاحية بالكلمة المفتاحية &key في قائمة لامدا. معاملات الكلمات المفتاحية ليست إلزامية، ويمكن أن يكون لها قيمة افتراضية، ويمكنها أيضًا تحديد "معامل supplied-p" يكون "صحيحًا" أو "خطأ" بحسب ما إذا قُدِّم للمعامل وسيط أم لا.

(defun keyword-parameter (&key (arg -1) arg)
(keyword-parameter)         ; => -1
(keyword-parameter :arg 13) ; => 13

في وسائط الدالة تُحدَّد معاملات الكلمات المفتاحية باسم الكلمة المفتاحية الخاص بها، وهو افتراضيًا نسخة من اسم المعامل على هيئة رمز كلمة مفتاحية (أي أن معامل الكلمة المفتاحية name له اسم كلمة مفتاحية هو :name). ويمكن تحديد اسم آخر لمعامل الكلمة المفتاحية باستخدام قائمة من اسم الكلمة المفتاحية واسم المعامل بدلًا من اسم المعامل وحده:

(defun other-keyword-name (&key ((other-name arg))) (list arg))
(other-keyword-name 'other-name 5) ; => (5)

ورغم أنه يمكن الجمع بين أنواع متعددة من المعاملات وأنواع أخرى منها (المعاملات الاختيارية ومعاملات الكلمات المفتاحية)، فقد يسبب هذا مشكلات، لذا ينبغي القيام به بحذر. انظر قسم "خلط أنواع المعاملات المختلفة" في كتاب Practical Common Lisp.