コードを日本語で説明できない

Question

String str = br.readLine();//BufferedReaderのreadLineを使用してキーボード入力された文字列をｓｔｒに代入する。
		int res =Integer.parseInt(str);(`int res` で「int型の変数res」)
		char ans = (res==1)?'A':'B'; //ansに設定する文字（目的）の判定のために、resに変換した数値を設定する

                 {(res==1)`で「数'値'型の変数resが１のとき」を表す。
　　　　　　　　　　(三項演算子は「条件?成立:不成立」と書く。)}

``````ここに言語を入力
                        
このように一行目のコメントのように
2.3行目が何をしているのか
言えません。

こういう時、
どうやって日本語にできますか？

Comments

[otn]

コードの意味が理解できないと言うことですか？
それとも、コードの意味はわかるが日本語が苦手と言うことですか？

[r--]

コードのしている意味が分からないです。

[r--]

r-h
2019/05/06 19:49
int型の変数resに文字列の変数strを数字型に変換するという意味ですか？
２バイト文字のchar型に答えの変数ansは条件、上の数字型の変数resが１のとき。
と言う意味ですか？１ならA,以外ならBと言う条件演算子の書き方ということですか？

Answer 1

なんかの授業の問題なのですかね？

通常のプログラミングでは「コードを日本語化する」ようなコメントを書くべきではありません。もしコメントを書くなら処理の意図や目的を書くようにします。（コードからは抜け落ちるハイコンテキストな情報をコメントに残します）

   int res =Integer.parseInt(str);//

文字列を数値型に変換する

   char ans = (res==1)?'A':'B';//

こっちは三項演算子でansの値を設定していますね。
意味については調べればすぐ分ります。調べる能力は極めて大事です。

Comments

[r--]

とても分かりやすいです。
意図や目的とコードを日本語化することはどう意味合いがちがうのですか？
調べ方を教えていただけませんか？

[cateye]

>コードを日本語化する・・・コードに書いてあることを、コメントにしても意味がありません。（同じことを２度書いているだけです）　例えば（あまりいい例えではありませんがｗ）“ansに設定する文字の判定のため（目的）に、resに変換した数値を設定する”等、目的や意図を書きます。
・・・質問の場合、ソースはひと目で見れますが、仮に１００行を超える処理が間にったらなぜ数値に変換するか即座には分かりません、そのためのコメントです。・・・１００行を超えるような関数書くなってｗ

[r--]

この文章を読んで、コードを日本語化にすることと、目的の違いは理解しました。かつ、この例えの、“ansに設定する文字の判定のため（目的）に、resに変換した数値を設定する”ことの意味は理解できました。

Answer 2

一行目のように, コード見たままを日本語にするのでしたら, コメントは無いほうが良いと思います.

Comments

[r--]

それは、なぜですか？

[jimbe]

コードを見れば分かるからです.
逆に, コードを修正してコメントを修正しないと, どちらが正しいのか分からなくなります.

[r--]

int型の変数resに文字列の変数strを数字型に変換するという意味ですか？
２バイト文字のchar型に答えの変数ansは条件、上の数字型の変数resが１のとき。
と言う意味ですか？１ならA,以外ならBと言う条件演算子の書き方ということですか？

[jimbe]

`Integer.parseInt(str)` という式で, 「文字列の変数strを数字型に変換」です. `int res` で「int型の変数res」です.
char は2バイト文字とは言いません. `(res==1)`で「数'値'型の変数resが１のとき」を表し, 三項演算子は「条件?成立:不成立」と書くことは java のエンジニアなら(ほぼ)確実に知っています.

[jimbe]

失礼と思われるかもしれませんが, r-h さんの過去のご質問からも(アスペルガーのような)発達障害をお持ちの方のように感じます. (ガイドヘルパーをしてました.)
もしそのような診断を受けたことがありませんでしたら, 発達障害者支援センター等でお話を伺ってみては如何でしょうか.

[r--]

時間をそこに費やせていない、費やせません。
あと、行ったところで、、辞めたくありません。
けど、100人にそう言われたら行く気になれそうなので、行きます。

[r--]

素直に行くのもいいけど、どう乗り越えるかは自分で考えられます。
学ぶことを諦めないので続けたいです。

[jimbe]

仰ることは分かります. ご質問とは関係無いことですので, 見当違いも甚だしいと無視頂いて結構です. ただ軽度でも(軽度なればこそ?)「何だか分からないけど周りとうまく行かない」と本人が一番苦しい症状ですので, 拗れる前に何か出来ればと思いました.

[r--]

周りはいい人しかいません。
だから、勉強を続けるのです。それで応えるしかないです。
指摘だって、受け止める気もあります。頭で分かるのと他で分かるのが違うことも解ります。
ただ、学ぶことは続けます。

[r--]

本当にありがとうございます。

[jimbe]

お礼はこちらが申し上げなければなりません. 個人的なことをこのような場で書いて申し訳ないです.
念のため(この文書は残りますので他に読む方向けに)書かせて頂きますが, 例え発達障害があったとしても, その人の人格とは関係ありません. コメントからは r-h さんが「善い人」なのは分かりました.
ありがとうございました.

[otolab]

プログラマの美徳はいろいろ言われるのですが「怠惰である」がよく入っています。
良いプログラマは頑張らず楽をしたがります。より楽をするために勉強し、仕事をしたくないのでコンピュータを働かせます。そのためにプログラムを書くのです。

楽をする・楽に生きる・そのためにエネルギーを使うというのは、生産性を高めることであり、プログラマにとって大きな美徳なのです。

前に進むのに必要なのは、頑張ることだけではありませんよ〜。という話でした。

[r--]

.