l17: add Callable Objects

Author: Saeid

lessons/l17.rst

@@ -230,6 +230,78 @@
   * ارسال آرگومان در زمان نمونه‌سازی شی یا همان پیاده‌سازی متد ``__init__`` به برنامه‌نویس این اطمینان را می‌دهد که شی جدید در یک وضعیت درست تنظیم شده است. 
 
   * آرگومان‌های متناظر با پارامتر‌های متد ``__init__`` (به جز ``self`` که توسط مفسر پایتون مقداردهی می‌گردد) می‌بایست در زمان نمونه‌سازی و فراخوانی کلاس ارسال گردد.
+  
+  
+اشیا با قابلیت فراخوانی (Callable Objects)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+  
+پیش‌تر دیدیم که می‌توان توابع را فراخوانی نمود (درس دروازدهم)، با این کار بدنه تابع اجرا و خروجی متناسب دریافت می‌گردید. در این درس نیز مشاهده کردیم کلاس‌ها نیز در پایتون توانایی فراخوانی دارند که با فراخوانی کلاس، یک شی از آن ایجاد می‌گردد. با استفاده از تابع ``callable`` در پایتون می‌توان تشخیص داد که آیا یک شی قابلیت فراخوانی دارد یا خیر [`اسناد پایتون <https://docs.python.org/3/library/functions.html#callable>`__]، این تابع در صورتی که شی دریافتی قابلیت فراخوانی (callable) داشته باشد مقدار ``True``  و در غیر این صورت ``False`` برمی‌گرداند::
+
+    >>> def function():
+    ...     pass
+    ... 
+    >>> callable(function)
+    True
+
+    >>> class SampleClass:
+    ...     pass
+    ... 
+    >>> callable(SampleClass)
+    True
+
+    >>> obj = SampleClass()
+    >>> callable(obj)
+    False
+    
+    >>> obj()
+    Traceback (most recent call last):
+      File "<stdin>", line 1, in <module>
+    TypeError: 'SampleClass' object is not callable
+
+
+همانطور که از نمونه کد بالا مشخص است، اشیایی که از کلاس‌های خودمان ایجاد می‌کنیم، بر خلاف خود کلاس قابلیت فراخوانی ندارند. در زبان پایتون می‌توانیم این قابلیت را به اشیا کلاس‌های خود اضافه نماییم.
+
+همانطور که اشاره شد، کلاس در پایتون چندین متد خاص همانند ``__new__`` و  ``__init__`` دارد که به تدریج به آنها آشنا خواهیم شد. یکی دیگر از این متدها ``__call__`` می‌باشد [`اسناد پایتون <https://docs.python.org/3/reference/datamodel.html#object.__call__>`__]. این متد نیز همانند متد ``__init__`` از نوع Instance Method (*بخش بعدی شرح داده شده است*) می‌باشد که با پیاده‌سازی آن در کلاس، اشیای آن کلاس قابلیت فراخوانی پیدا خواهند کرد:
+
+
+
+.. code-block:: python
+    :linenos: 
+    
+    class Sample:
+
+        def __init__(self, x=0, y=0):  
+            print('------------------- Called __init__()')
+            self.x = x
+            self.y = y
+		
+        def __call__(self, x, y):  
+            print('------------------- Called __call__()')
+            self.x = x
+            self.y = y
+
+
+    obj = Sample()
+    print('object is callable:', callable(obj))
+    print('x =', obj.x)
+
+    obj(5, 6)
+    print('x =', obj.x)
+
+::
+
+    ------------------- Called __init__()
+    object is callable: True
+    x = 0
+    ------------------- Called __call__()
+    x = 5
+
+
+سطر ۱۸ نمایش فراخوانی یک شی از کلاس Sample می‌باشد - درست به مانند یک تابع!
+
+با فراخوانی یکی شی، به صورت خودکار متد ``__call__`` فراخوانی و آرگومان‌های نظیر ارسال می‌گردند. 
+
+از کاربردهای پیاده‌سازی متد ``__call__`` و افزودن قابلیت فراخوانی به یک شی می‌توان به ایجاد کلاس به عنوان دکوراتور (decorator) اشاره کرد (*دروس آتی شرح داده خواهد شد*) و همچنین کاربردهایی که نیاز می‌شود شی در زمان اجرا initialize یا مقداردهی دوباره داشته باشد، چرا که متد ``__init__`` تنها یکبار در زمان نمونه‌سازی فراخوانی می‌گردد.