컴퓨터사이언스/파이썬 & 알고리즘

Function design recipe (Docstring)

누군가의 이야기 2021. 9. 17. 00:15
728x90

함수를 정의할 때 다른 사용자가 이용하기 편하게 함수 내용을 보여주는 것을 Docstring이라고 한다.

Docstring 내용은 함수 헤더 아래쪽 """ """ 사이에 입력한다.

Docstring은 help(함수명)으로 조회 가능하다.

 

아래는 작성 순서에 따른 내용

  1. Examples - 어떤 파라미터와 인수가 필요한지 정의
  2. Type Contract - 인수와 반환값의 타입 정의
  3. Header - 제목 정의
  4. Description - 함수 목적 정의
  5. Body - 코드 작성
  6. Test

 

728x90