edited (l15 and l16)

Author: Saeid Darvish

source/_static/sitemap-index.xml

@@ -95,13 +95,13 @@
   <priority>0.80</priority>
 </url>
 <url>
-  <loc>https://python.coderz.ir/lessons/l15.html</loc>
-  <lastmod>2021-03-17T17:10:25+00:00</lastmod>
+  <loc>https://python.coderz.ir/lessons/l15-regular-expression-in-python.html</loc>
+  <lastmod>2023-04-17T17:10:25+00:00</lastmod>
   <priority>0.80</priority>
 </url>
 <url>
-  <loc>https://python.coderz.ir/lessons/l16.html</loc>
-  <lastmod>2021-03-17T17:10:25+00:00</lastmod>
+  <loc>https://python.coderz.ir/lessons/l16-python-module-re.html</loc>
+  <lastmod>2023-04-17T17:10:25+00:00</lastmod>
   <priority>0.80</priority>
 </url>
 <url>

source/index.rst

@@ -46,8 +46,8 @@
    lessons/l12-function-in-python
    lessons/l13-decorator-generator-and-lambda-with-python-functions
    lessons/l14-recursive-functions-and-memoization-in-python
-   lessons/l15
-   lessons/l16
+   lessons/l15-regular-expression-in-python
+   lessons/l16-python-module-re
    lessons/l17
    lessons/l18
    lessons/l19

source/lessons/l08-list-and-tuple-in-python.rst

@@ -750,6 +750,7 @@
     [1]
 
 
+.. _python-tuple: 
 
 توپِل
 ------

source/lessons/l14-recursive-functions-and-memoization-in-python.rst

@@ -86,6 +86,8 @@
     پیاده‌سازی شیوه بازگشتی شاید به نظر هیجان‌انگیز باشد اما نباید فراموش کرد که میزان حافظه (Memory) زیادی مصرف می‌کند، اجرای آن زمان‌بر خواهد بود، درک جریان اجرای آن اغلب سخت است و اشکال‌زدایی (debug) آن ساده نخواهد بود!
 
 
+.. _using-python-decorator:
+
 استفاده از decorator
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -125,6 +127,8 @@
 
 *به خروجی نمونه کد بالا حتما توجه نمایید!.*
 
+.. _python-set-recursion-limit:
+
 تنظیم عمق بازگشتی
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -161,6 +165,9 @@
 .. tip::
     علاوه بر این محدودیت، یک محدودیت جدی‌تر دیگری نیز وجود دارد و آن هم میزان فضایی است که توسط سیستم عامل برای پشته در نظر گرفته شده است. با رد شدن از این مقدار فضا، برنامه با خطای زمان اجرا مواجه می‌گردد (``RuntimeError``).
 
+
+.. _python-generator-recursive:
+
 تابع Generator بازگشتی
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -224,6 +231,8 @@
   [1, 2, 3, 4, 5, 5, 6, 7, 8, 9]
 
 
+.. _memoization:
+
 Memoization
 ~~~~~~~~~~~~~
 

source/lessons/l15.rst renamed to source/lessons/l15-regular-expression-in-python.rst

@@ -1,10 +1,11 @@
 .. role:: emoji-size
 
 .. meta::
-   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش ماژول re در پایتون، عبارات باقاعده در پایتون، Regular expression در پایتون، regex در پایتون
-   :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, تابع, کتابخانه, پایتون, re
+   :description: پایتون به پارسی - کتاب آنلاین و آزاد آموزش زبان برنامه‌نویسی پایتون - درس پانزدهم: عبارات با قاعده (Regular Expression) یا RegEx در پایتون
 
 
+.. _lesson-15:
+
 درس ۱۵: عبارات با قاعده (Regular Expression) یا RegEx در پایتون
 ============================================================================
 
@@ -33,12 +34,18 @@
 
 ----
 
+
+.. _regular-expression:
+
 عبارات باقاعده
 -----------------
 
 قواعد «عبارات باقاعده» شامل استفاده و چیدمان تعدادی کاراکتر خاص می‌شود که در مجموع معنی یا الگویی را به وجود می‌آورند!. در ادامه به بررسی این کاراکترها می‌پردازیم.
 
 
+
+.. _matching-characters:
+
 کاراکترهای تطابق (Matching Characters)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -321,6 +328,9 @@
 
 
 
+.. _special-sequences:
+
+
 توالی‌های ویژه (Special Sequences)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -541,7 +551,7 @@
       تفاوت ``Z\`` و ``$``: در متن‌های چند سطری مشاهده می‌شود به گونه‌ای که  ``Z\`` به انتهای کل آن متن و ``$`` به انتهای هر سطر از متن اشاره می‌کنند.
 
 
-
+.. _zero-length-match:
 
 انطباق با طول صفر (Zero-length Match)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -568,7 +578,7 @@
 
 
 
-
+.. _python-re:
 
 ماژول re پایتون
 -----------------
@@ -578,6 +588,8 @@
 در زبان برنامه‌نویسی پایتون از طریق ماژول ``re`` از کتابخانه استاندارد آن، ثابت‌ها (constants) و توابع (functions) کاربردی بسیاری در زمینه عبارت باقاعده فراهم آورده شده است. در ادامه نگاهی کوتاه به این ماژول خواهیم داشت و شرح کامل توابع کاربردی آن به درس بعدی سپرده خواهد شد.
 
 
+.. _python-re-compile:
+
 تابع ``compile`` و شی Regular Expression پایتون
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -625,8 +637,6 @@
 به تابع ``compile`` برمی‌گردیم::
 
 
-    >>> # Python 3.x
-    >>> 
     >>> import re
     >>> 
     >>> pattern = re.compile("^<html>", re.I)
@@ -638,22 +648,7 @@
     re.compile('^<html>', re.IGNORECASE)
 
 
-:: 
-
-          >>> # Python 2.x
-          >>> 
-          >>> import re
-          >>> 
-          >>> pattern = re.compile("^<html>", re.I)
-          >>> 
-          >>> type(pattern)s
-          <type '_sre.SRE_Pattern'>
-          >>> 
-          >>> print pattern
-          <_sre.SRE_Pattern object at 0x7f22cf27ac00>
-
-
-کاربرد تابع ``compile`` زمانی است که می‌خواهیم از یک الگو مشخص چندین بار در طول اجرای یک ماژول استفاده نماییم. در ادامه با توابع دیگری از ماژول ``re`` آشنا خواهیم شد؛ این توابع پیش از انجام وظیفه مربوط به خود، به صورت ضمنی الگو را به شی ``re.Pattern`` یا ``sre.SRE_Pattern_`` (در پایتون 2x) کامپایل می‌کنند که به این صورت می‌توان کارایی برنامه را با یک بار ``compile`` افزایش دهیم. البته باید اشاره کرد که مفسر پایتون به صورت خودکار نمونه کامپایل شده چند الگو آخر مورد استفاده را Cache می‌کند، بنابراین چنانچه در برنامه‌ خود از تعداد اندکی الگو استفاده می‌کنید، می‌توانید در این زمینه نگران کارایی نباشید.
+کاربرد تابع ``compile`` زمانی است که می‌خواهیم از یک الگو مشخص چندین بار در طول اجرای یک ماژول استفاده نماییم. در ادامه با توابع دیگری از ماژول ``re`` آشنا خواهیم شد؛ این توابع پیش از انجام وظیفه مربوط به خود، به صورت ضمنی الگو را به شی ``re.Pattern`` کامپایل می‌کنند که به این صورت می‌توان کارایی برنامه را با یک بار ``compile`` افزایش دهیم. البته باید اشاره کرد که مفسر پایتون به صورت خودکار نمونه کامپایل شده چند الگو آخر مورد استفاده را Cache می‌کند، بنابراین چنانچه در برنامه‌ خود از تعداد اندکی الگو استفاده می‌کنید، می‌توانید در این زمینه نگران کارایی نباشید.
 
 یادآوری شود که با استفاده از تابع ``dir`` می‌توانیم متدها و صفت‌های شی الگو را مشاهده نماییم::
 
@@ -662,6 +657,7 @@
       >>> 
 
 
+.. _extended-patterns:
 
 الگوهای گسترده (Extended Patterns) پایتون
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -928,7 +924,5 @@
 
 :emoji-size:`😊` امیدوارم مفید بوده باشه
 
-`لطفا دیدگاه و سوال‌های مرتبط با این درس خود را در کدرز مطرح نمایید. <https://www.coderz.ir/python-regular-expression>`_
-
 
 

source/lessons/l16.rst renamed to source/lessons/l16-python-module-re.rst

@@ -1,10 +1,11 @@
 .. role:: emoji-size
 
 .. meta::
-   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش ماژول re در پایتون، عبارات باقاعده در پایتون، Regular expression در پایتون، regex در پایتون، توابع ماژول re پایتون - 
-   :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, تابع, کتابخانه, پایتون, re
+   :description: پایتون به پارسی - کتاب آنلاین و آزاد آموزش زبان برنامه‌نویسی پایتون - درس شانزدهم: ماژول re (عبارات باقاعده) پایتون
 
 
+.. _lesson-16:
+
 درس ۱۶: ماژول re (عبارات باقاعده) پایتون
 ============================================================================
 
@@ -32,7 +33,7 @@
 ----
 
 
-
+.. _re-search-functions:
 
 توابع جستجو، ماژول ``re`` پایتون
 ---------------------------------------
@@ -46,6 +47,8 @@
 * ``finditer``  
 
 
+.. _re-search:
+
 تابع ``search``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -54,22 +57,6 @@
 
 تابع ``search`` به دنبال اولین انطباق pattern در string می‌گردد، در صورت موفقیت یک شی ``Match`` [`اسناد پایتون <https://docs.python.org/3/library/re.html#match-objects>`__] و در غیر این صورت ``None`` برمی‌گرداند [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.search>`__]::
 
-
-    >>> # Python 2.x
-    >>> 
-    >>> import re
-    >>> 
-    >>> match = re.search('Py...n', 'Python is great')
-    >>> 
-    >>> type(match)
-    <type '_sre.SRE_Match'>
-    >>> 
-
-::
-
-
-    >>> # Python 3.x
-    >>> 
     >>> import re
     >>> 
     >>> match = re.search('Py...n', 'Python is great')
@@ -90,6 +77,8 @@
 
 
 
+.. _re-match-object:
+
 شی ``Match`` پایتون
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -343,6 +332,7 @@
        >>> match.string
        '24.1632'
 
+.. _re-match:
 
 تابع ``match``
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -352,7 +342,7 @@
 
 تابع ``match`` از ابتدای string انطباق pattern را انجام می‌دهد، در صورت موفقیت یک شی ``Match`` و در غیر این صورت ``None`` برمی‌گرداند [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.match>`__]::
 
-    >>> import re  # Python 3.x
+    >>> import re
 
     >>> match = re.match(r'\d+', '123@USERNAME')
     >>> print(match)
@@ -415,6 +405,7 @@
 
     >>> match = re.match('Py...n', 'Python is great')
 
+.. _re-fullmatch:
 
 تابع ``fullmatch``
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -460,6 +451,8 @@
     >>> match = re.fullmatch('Py...n', 'Python')
 
 
+.. _re-findall:
+
 تابع ``findall``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -506,6 +499,7 @@
 
     >>> results = re.findall('Py...n', 'PythonPythonPython')
 
+.. _re-finditer:
 
 تابع ``finditer``
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -515,7 +509,7 @@
 
 خروجی این تابع (``finditer``) یک شی ``iterator`` (شی تکرارکننده - درس نهم) است و حاصل هر بار پیمایش آن یک شی ``Match`` می‌باشد که همانند تابع ``findall`` از سمت چپ string شروع به دنبال انطباق pattern در آن می‌گردد و نتایج را به ترتیب برمی‌گرداند. [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.finditer>`__]::
 
-    >>> import re  # Python 3.x
+    >>> import re
 
     >>> string = "My number is 123456789 and my friend's number is 987654321"
     >>> result = re.finditer(r'\d+', string)
@@ -572,6 +566,7 @@
     >>> result = re.finditer('Py...n', 'PythonPythonPython')
 
 
+.. _re-replace-methods:
 
 توابع جایگزینی، ماژول ``re`` پایتون
 ---------------------------------------
@@ -582,6 +577,7 @@
 * ``subn``  
 
 
+.. _re-sub:
 
 تابع ``sub``
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -591,7 +587,7 @@
 
 این تابع (``sub``) حاصل انطباق‌های ممکن pattern در string را در repl جایگذاری می‌کند. این تابع همچنین دو پارامتر اختیاری دارد (flags و count)، پیش‌تر در مورد flags صحبت کردیم (که از نسخه 3.1 پایتون به این تابع اضافه شده است) و count نیز بیانگر ماکزیمم تعداد انطباقی است که می‌خواهیم در repl جایگذاری شود - این مقدار می‌بایست یک عدد مثبت باشد و مقدار صفر (مقدار پیش‌فرض) برای آن به معنی هر تعداد (نامحدود) خواهد بود. پارامتر repl در این تابع می‌تواند از نوع رشته یا تابع باشد، ابتدا حالت رشته را بررسی می‌کنیم [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.sub>`__]::
 
-     >>> import re  # Python 3.x
+     >>> import re
 
      >>> string = 'Perl@1987,Python@1991,Ruby@1995'
      >>> repl = ' - '
@@ -692,7 +688,7 @@
     >>> result = re.sub('Py...n', '*', 'PythonPythonPython')
 
 
-
+.. _re-subn:
 
 تابع ``subn``
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -702,7 +698,7 @@
 
 عملکرد این تابع (``subn``) همانند تابع ``sub`` است. تنها تفاوت در خروجی آن‌هاست، تابع ``subn`` یک شی توپِل محتوی نتیجه و تعداد عملیات جایگذاری را برمی‌گرداند [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.subn>`__]::
 
-    >>> import re  # Python 3.x
+    >>> import re
 
     >>> string = 'Perl@1987,Python@1991,Ruby@1995'
     >>> repl = ' - '
@@ -723,6 +719,7 @@
     ('Perl - Python@1991,Ruby@1995', 1)
 
 
+.. _re-split-methods:
 
 توابع جداسازی، ماژول ``re`` پایتون
 ---------------------------------------
@@ -732,6 +729,9 @@
 * ``split``
 
 
+.. _re-split:
+
+
 تابع ``split``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -740,7 +740,7 @@
 
 این تابع (``split``) محتوای متن string را بر اساس الگو pattern جدا (split) می‌کند و خروجی آن یک شی لیست از رشته‌ها خواهد بود. این تابع همچنین علاوه بر پارامتر flags (که از نسخه 3.1 پایتون به این تابع اضافه شده است) یک پارامتر اختیاری دیگر نیز با نام maxsplit دارد که تعیین کننده ماکزیمم تعداد جداسازی خواهد بود - این مقدار می‌بایست یک عدد مثبت باشد و مقدار صفر (مقدار پیش‌فرض) برای آن به معنی هر تعداد (نامحدود) خواهد بود. [`اسناد پایتون <https://docs.python.org/3/library/re.html#re.split>`__]::
 
-    >>> import re  # Python 3.x
+    >>> import re
 
     >>> string = 'Perl,Python,Ruby'
     >>> pattern = ','
@@ -785,15 +785,12 @@
 
 
 
-
-
 |
 
 ----
 
 :emoji-size:`😊` امیدوارم مفید بوده باشه
 
-`لطفا دیدگاه و سوال‌های مرتبط با این درس خود را در کدرز مطرح نمایید. <https://www.coderz.ir/python-regular-expression-2/>`_