Jump to content

Python

  • entries
    53
  • comments
    0
  • views
    405

Docstring (Documentation String)


Doğuhan ELMA

45 views

Python'da, "docstring" (documentation string) terimi, bir fonksiyon, sınıf, modül veya metot hakkında bilgi veren bir metin bloğunu ifade eder. Docstring'ler, kodun anlaşılmasını ve kullanılmasını kolaylaştırmak için kullanılır.

Docstring'ler, genellikle bir fonksiyonun, sınıfın veya metodun ilk satırında, üç çift tırnak (""") içinde tanımlanır. Docstring'ler, Python'un help() fonksiyonu veya otomatik belgeleme araçları (örneğin, Sphinx) tarafından okunabilir.

Bir docstring genellikle aşağıdaki bilgileri içerir:

  1. Fonksiyonun, sınıfın veya metodun ne yaptığı.
  2. Hangi parametreleri aldığı ve bu parametrelerin ne anlama geldiği.
  3. Ne tür bir değer döndürdüğü.
  4. Herhangi bir yan etkisi veya istisnası varsa, bunlar.

Örneğin, bir fonksiyon için bir docstring aşağıdaki gibi olabilir:

def add_numbers(a, b):
    """
    Bu fonksiyon, iki sayıyı toplar.

    Parametreler:
    a (int veya float): İlk sayı.
    b (int veya float): İkinci sayı.

    Döndürür:
    int veya float: İki sayının toplamı.
    """
    return a + b

Bu docstring, add_numbers fonksiyonunun ne yaptığını, hangi parametreleri aldığını ve ne tür bir değer döndürdüğünü açıklar. Bu bilgi, bir kullanıcının veya bir geliştiricinin bu fonksiyonu nasıl kullanacağını anlamasına yardımcı olur.

Python'da docstring'ler, kodun anlaşılmasını ve kullanılmasını kolaylaştırmak için önemlidir. İyi bir docstring, bir fonksiyonun, sınıfın veya metodun nasıl çalıştığını ve nasıl kullanılacağını açıkça ve ayrıntılı bir şekilde açıklar.

0 Comments


Recommended Comments

There are no comments to display.

Guest
Add a comment...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...