良い関数名を使う
良い関数名は、ユーザーとメンテナのどちらにとっても理解を大きく助けます。良い関数名は、その関数が何をするのかを端的に表します。この演習では、関数を読みやすくする名前を選びます。
この演習はコースの一部です
Pythonで学ぶSoftware Engineeringの原則
演習の手順
mathモジュールはあらかじめ読み込まれており、sqrt関数を使えます。- 次の候補から最適な関数名を選んでください:
do_stuff,hypotenuse_length,square_root_of_leg_a_squared_plus_leg_b_squared,pythagorean_theorem。 - 関数名を使ってドックストリングの例を完成させてください。
- 新しい関数名を使い、辺の長さが
6と8の直角三角形について、斜辺の長さを求めた結果をprintしてください。
実践的なインタラクティブ演習
このサンプルコードを完成させて、この演習に挑戦してみましょう。
def ____(leg_a, leg_b):
"""Find the length of a right triangle's hypotenuse
:param leg_a: length of one leg of triangle
:param leg_b: length of other leg of triangle
:return: length of hypotenuse
>>> ____(3, 4)
5
"""
return math.sqrt(leg_a**2 + leg_b**2)
# Print the length of the hypotenuse with legs 6 & 8
print(____)