teratail header banner
teratail header banner
質問するログイン新規登録

回答編集履歴

2

蛇足的な追記

2018/02/06 12:51

投稿

8524ba23
8524ba23

スコア38352

answer CHANGED
@@ -6,4 +6,18 @@
6
6
  「挙動」という言葉から私は実装を連想します。
7
7
  そして関数の命名においては実装を隠蔽したいという意識が働きます。(あとで変えることがあるかもしれないので)
8
8
  よって役割をもとに命名することが好みです。
9
- あと`fr`,`ba`が何か分かるようにします。(コメントを書くか、引数名を長くする)
9
+ あと`fr`,`ba`が何か分かるようにします。(コメントを書くか、引数名を長くする)
10
+
11
+ 追記。
12
+ 私は忘れっぽいので、そもそもこの関数何に使うんだっけ?ということも忘れたりします。
13
+ で、こんな感じに引数と戻り値についての具体例を記載したりします。
14
+ ```Python
15
+ # 「オノマトペ」を生成する
16
+ # fr : 接頭文字列「チャカ」
17
+ # ba : 接尾文字列「ポコ」
18
+ # 戻り値:「チャカポコチャカポコ」
19
+ def gen_onomatope( fr, ba):
20
+ return (fr+ba)*2
21
+
22
+ print( gen_onomatope('チャカ','ポコ')) # チャカポコチャカポコ
23
+ ```

1

加筆

2018/02/06 12:51

投稿

8524ba23
8524ba23

スコア38352

answer CHANGED
@@ -1,6 +1,6 @@
1
1
  個人的な意見です。
2
2
 
3
- 「オノマトペを生成する」という役割を表明したい場合は`gen_onomatope`あるいは`calc_~`とします。
3
+ 「オノマトペを生成する」という機能(役割を表明したい場合は`gen_onomatope`あるいは`calc_~`とします。
4
4
  数学的操作(挙動)を強調、表明したい場合は`double_after_join`とします。
5
5
 
6
6
  「挙動」という言葉から私は実装を連想します。