Viết docstring
Bạn vừa học về những lợi ích của docstring. Trong bài tập này, bạn sẽ luyện viết các docstring có thể được sử dụng bởi các công cụ tạo tài liệu như Sphinx.
Lưu ý rằng bài nộp docstring của bạn phải khớp với lời giải chính xác từng ký tự. Nếu bạn làm sai nhiều lần, có thể nên đặt lại về mã mẫu và bắt đầu lại.
Bài tập này là một phần của khóa học
Nguyên tắc Kỹ thuật Phần mềm với Python
Hướng dẫn bài tập
- Hoàn thiện phần docstring mô tả các tham số.
- Hoàn thiện phần docstring mô tả giá trị trả về.
- Hoàn thiện ví dụ sử dụng hàm trong docstring.
Bài tập tương tác thực hành trực tiếp
Hãy thử làm bài tập này bằng cách hoàn thành đoạn mã mẫu này.
# Complete the function's docstring
def tokenize(text, regex=r'[a-zA-z]+'):
"""Split text into tokens using a regular expression
:____ text: text to be tokenized
:param ____: regular expression used to match tokens using re.findall
:____: a list of resulting tokens
>>> ____('the rain in spain')
____
"""
return re.findall(regex, text, flags=re.IGNORECASE)
# Print the docstring
help(tokenize)