l17: Class Attributes

Saeid Darvish · Saeid Darvish · commit 607202f37901 · 2021-03-03T22:41:33.000+03:30
diff --git a/lessons/l17.rst b/lessons/l17.rst
@@ -261,9 +261,75 @@ Instance Attribute
 Class Attribute
 ~~~~~~~~~~~~~~~~~~~~~
 
+به Attributeهای خاص یک کلاس گفته می‌شود و در واقع متغیرهایی است که درون کلاس و خارج از متدها تعریف می‌گردند. کاربرد این Attributeها به اشتراک گذاشتن یک یا چند مقدار یکسان در بین تمام اشیاست. 
 
+تمام اشیای یک کلاس به Class Attributeهای آن کلاس دسترسی دارند:
 
 
+.. code-block:: python
+    :linenos:
+
+    class Sample():
+        class_attribute = 0
+
+    print('#' * 10, 'STEP#A')
+    print('LINE 05:', Sample.class_attribute)
+
+    # Instantiation
+    sample_1 = Sample()
+    sample_2 = Sample()
+    
+    print('#' * 10, 'STEP#B')
+    print('LINE 12:', sample_1.class_attribute)
+    print('LINE 13:', sample_2.class_attribute)
+    
+    print('#' * 10, 'STEP#C')
+
+    # Change class_attribute for all objects
+    Sample.class_attribute = 1
+    
+    print('LINE 20:', sample_1.class_attribute)  # Changed!
+    print('LINE 21:', sample_2.class_attribute)  # Changed!
+    
+    print('#' * 10, 'STEP#D')
+
+    # WARNING!!! Create a new instance attribute
+    sample_2.class_attribute = 2
+    
+    print('LINE 28:', sample_1.class_attribute)
+    print('LINE 29:', sample_2.class_attribute)  # instance attribute!!!
+
+
+::
+
+        ########## STEP#A
+        LINE 05: 0
+        ########## STEP#B
+        LINE 12: 0
+        LINE 13: 0
+        ########## STEP#C
+        LINE 20: 1
+        LINE 21: 1
+        ########## STEP#D
+        LINE 28: 1
+        LINE 29: 2
+
+
+
+
+.. tip:: 
+
+  مقدار Class Attributeها هم با استفاده از نام کلاس قابل دستیابی است (سطر ۵) و هم با استفاده از هر یک از اشیا آن کلاس (سطرهای ۱۲ و ۱۳).
+
+.. tip:: 
+  برای تغییر مقدار Class Attribute در داخل کلاس از Class Method - *در ادامه شرح داده می‌شود* - استفاده می‌شود و در بیرون کلاس **با استفاده از نام کلاس** به صورت زیر (سطر ۱۸)::
+
+        ClassName.class_attribute = new_value
+
+.. tip:: 
+
+  برای تغییر مقدار Class Attributeها، **از شی استفاده نکنید**، با این کار تنها یک Instance Attribute برای آن شی ایجاد می‌گردد (سطر ۲۶).
+
 
 
 
@@ -297,7 +363,7 @@ Class Attribute
 متد شی (Instance Method)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-رایج‌ترین نوع متد در پایتون است. برای ایجاد این متد نیازی به دکوراتور (Decorator‌ - درس سیزدهم) نیست. همانطور که از نام این متد مشخص است این متد تنها از سوی اشیا یک کلاس قابل استفاده است. هر شی از کلاس صفات (Attributes - *کمی جلوتر شرح داده خواهد شد*) خاص خود را دارد که از این متدها می‌توان برای دستیابی، دستکاری آن‌ها استفاده کرد.
+رایج‌ترین نوع متد در پایتون است. برای ایجاد این متد نیازی به دکوراتور (Decorator‌ - درس سیزدهم) نیست. همانطور که از نام این متد مشخص است این متد تنها از سوی اشیا یک کلاس قابل استفاده است. همانطور که پیش‌تر صحبت شد، هر شی از کلاس صفات خاص خود را دارد  (Instance Attributes) که از این متدها می‌توان برای دستیابی و دستکاری آن‌ها استفاده کرد.
 
 این نوع متد همواره می‌بایست حداقل یک پارامتر داشته باشد. پارامتر نخست که معمولا ``self`` نام‌گذاری می‌شود حاوی شی جاری از کلاس است - در واقع همان شی ای که این متد را فراخوانی کرده است. این مقدار همواره از  سوی مفسر پایتون ارسال می‌گردد و نیازی به ارسال از سوی برنامه‌نویس ندارد:
 
@@ -334,7 +400,7 @@ Class Attribute
       ##########
 
 
-گفته شده که متد ``__init__``  جزیی از مفهوم Constructor کلاس‌های پایتون بوده و برای شخصی‌سازی یک شی در زمان ایجاد آن به کار می‌رود - کاربرد معمول: افزودن Attribute (*که در بخش‌های آتی شرح داده می‌شود*) به شی است. در نمونه کد بالا، این متد یک پارامتر char دریافت می‌کند - این پارامتر مقدار پیش‌فرض ``*`` را دارد، بنابراین ارسال آرگومان متناظر برای آن اجباری نیست (تابع در پایتون - درس دوازدهم). با این کار می‌توانیم در زمان نمونه‌سازی شی، یک Attribute با نام character در آن تعریف نماییم (سطر ۴). ما می‌خواهیم مقدار Attribute یا صفت character از هر شی را به تعداد دلخواه چاپ نماییم، از آنجا که این مقدار یک صفتِ متعلق به شی است و در ازای هر شی این مقدار می‌تواند متفاوت باشد پس ما برای این کار می‌بایست که یک Instance Method در بدنه کلاس تعریف کنیم (متد ``multiply_print`` ) - چرا که تنها در این صورت است که می‌توانیم به ``self`` دسترسی داشته باشیم و مقدار صفت character را از آن دستیابی کنیم. 
+گفته شده که متد ``__init__``  جزیی از مفهوم Constructor کلاس‌های پایتون بوده و برای شخصی‌سازی یک شی در زمان ایجاد آن به کار می‌رود و کاربرد معمول آن افزودن Attribute به شی است. در نمونه کد بالا، این متد یک پارامتر char دریافت می‌کند - این پارامتر مقدار پیش‌فرض ``*`` را دارد، بنابراین ارسال آرگومان متناظر برای آن اجباری نیست (تابع در پایتون - درس دوازدهم). با این کار می‌توانیم در زمان نمونه‌سازی شی، یک Attribute با نام character در آن تعریف نماییم (سطر ۴). ما می‌خواهیم مقدار Attribute یا صفت character از هر شی را به تعداد دلخواه چاپ نماییم، از آنجا که این مقدار یک صفتِ متعلق به شی است و در ازای هر شی این مقدار می‌تواند متفاوت باشد پس ما برای این کار می‌بایست که یک Instance Method در بدنه کلاس تعریف کنیم (متد ``multiply_print`` ) - چرا که تنها در این صورت است که می‌توانیم به ``self`` دسترسی داشته باشیم و مقدار صفت character را از آن دستیابی کنیم. 
 
 .. tip:: 
 
