강의 계획 레슨 250개 중 25번째 · 함수
함수

독스트링과 타입 힌트

작은 손질 두 가지가 동작하는 함수를 전문가다운 함수로 바꿔요: 독스트링과 타입 힌트.

독스트링은 함수 본문의 맨 첫 줄에 놓는 문자열 리터럴이에요. 함수가 무엇을 하는지 설명해요. 도구들과 help()가 그것을 읽고, Python은 그것을 function.__doc__에 저장해요:

def add(a, b):
    """Return the sum of a and b."""
    return a + b

print(add.__doc__)   # Return the sum of a and b.

따옴표 세 개를 쓰면 독스트링이 여러 줄에 걸칠 수 있어서, 긴 설명에 편리해요.

타입 힌트는 매개변수와 반환값이 어떤 타입이길 기대하는지 적어요. 각 매개변수에는 name: type을, 반환에는 -> type을 써요:

def add(a: int, b: int) -> int:
    """Return the sum of a and b."""
    return a + b

힌트는 실행할 때 아무것도 강제하지 않아요. 문자열을 넘겨도 Python은 막지 않아요. 편집기와 검사기가 실수를 일찍 잡는 데 쓰는 문서이고, 시그니처를 그 자체로 설명이 되게 해 줘요. 흔한 힌트 타입에는 int, float, str, bool이 있어요.

이제부터는 둘 다 갖춘 함수를 쓰세요: 분명한 독스트링과 정직한 타입 힌트.

내 차례

타입 힌트 def multiply(a: int, b: int) -> int:와, 정확히 Return the product of a and b.라고 읽히는 독스트링(첫 줄)이 있는 함수 multiply를 정의하세요. 본문은 return a * b 해야 해요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.