본문 바로가기

Programming/python

python에서 docstring(문서 문자열)을 사용해보자.

파이썬에서 `docstring(문서 문자열)`은 함수, 클래스, 메서드 등의 코드 블록에 작성되는 특별한 형태의 문자열 주석을 말합니다. 

이러한 문서 문자열은 해당 코드 블록의 기능, 사용법, 매개변수 설명, 반환 값 등과 같은 중요한 정보를 제공합니다.

주로 작은 따옴표(`''`) 또는 큰 따옴표(`""`) 세 개를 사용하여 작성하며, 다음과 같이 함수나 클래스 정의 바로 다음 줄에 위치시킵니다:

def my_function(arg1, arg2):
    """
    이 함수는 두 개의 인자를 받아서 작업을 수행합니다.

    :param arg1: 첫 번째 인자
    :param arg2: 두 번째 인자
    :return: 작업의 결과 값
    """
    # 함수의 구현 내용


위의 예제에서 `my_function` 함수에 작성된 문서 문자열은 함수가 어떤 작업을 수행하는지, 어떤 매개변수를 받고, 어떤 값을 반환하는지를 설명합니다. 

이러한 문서 문자열은 프로그램의 가독성을 높이고, 코드를 더 쉽게 이해하고 사용할 수 있도록 도와줍니다.

문서 문자열은 파이썬 내장 함수인 `help()`를 통해 접근할 수 있으며, 주석과는 달리 실행 시점에서도 접근이 가능합니다. 

따라서 문서 문자열을 잘 작성하여 코드의 사용 방법을 명확하게 설명하고, 다른 개발자들과 함께 협업하거나 다른 사람이 코드를 이해하는데 도움이 될 수 있도록 유용하게 활용할 수 있습니다.

반응형