有能な俺が英語でコメントを書き直してくれるスレッドです。
ちなみに、TOEIC300点台なので、あまり期待しないでください。
（すいません。。orz）
英語はプログラマの必須スキルだ！
日本語でコメント書いてるやつなんでクズだ！
今日から君も甘えてないで、英語でコメントを書こう！
competent I rewrite it in English, that is this thread.
英語添削スレじゃないんですか？
＞英語添削スレじゃないんですか？
逆も需要がありそうですよね。
別スレッド立てるのもあれなので、このスレッドでやりましょう。
// This thread is used for communicating between ai and research staffs, so please refrain from commenting.
これが俺のやり方
壊れた日本語書かれるより
壊れた英語の方がまだ通じた
//speak Japanese or die, white fag.
って書いとけばよくない？
// もし、下のコメントを外したら、このプログラムは動かなくなるでしょう
Uncommenting following lines will make the entire program unfunctionable.
DO NOT UNCOMMENT BELOW OR IT WON'T WORK
// I am UNKO
// FIXME
// 変数hogeは、1または2または3のどれかでなければなりません。これ以外の場合プログラムはアボートします。
// else abode
if other number , then this program is aboon.
// Otherwise, this program should be down.
激しく意訳したけど。
//Without setting 1, 2 or 3 to variable "hoge",
//this program will abort.
再訳すると、
//1,2または3を変数"hoge"に設定しないと、
//このプログラムはアボートします。
こんな感じ。前置詞とか合ってるのかは知らん。
結果を先に書くのが英語のスタンスだよ。
仮定の話なのでwillを使うところがポイント。
それにこの場合、一番言いたいことは hoge に設定すべき値で、墜ちるってことじゃないでしょ。
正しい値を入れていれば発生しない現象なのだから、
極論を言えば「プログラムがおちる」なんて記述はなくてもいい。
>>36の言う通り、「設定するべき値」が最初。
そして「でなければいけない」なのだから「must」を使うべき。
ありがとうございます。いろいろ表現があるんですねぇ、、
勉強になります。
// この関数は処理が正常の場合、1以上がリターンされます。処理が異常の場合、0以下がリターンされます。
// リターン値の意味は以下のとおりです。
// 1の場合、処理が正常に行われたことを意味します
// 2の場合、処理するデータがなかったことを意味します
// 0の場合、指定されたパラメタに問題があります
// -1の場合、設定ファイルのhoge.iniの設定値に誤りがあります。
// -2の場合、予期せぬエラーが発生しました。
//
// この関数をよんで0以下がリターンされた場合は、システムログにその理由を書き込んでください。
長文すいません。
// Do It Yourself
#define SUCCESS 1とかpublic static final int SUCCESS = 1;とかして
return SUCCESS;
とでもしろよ
When processing is normal as for this function, it is returned more than 1.
When processing is abnormal, it is returned less than 0.
The meaning of the return value is as follows.
In the case of 1, there is a problem in Para meta appointed
in the case of 0 meaning that there were not data to handle
in the case of 2 meaning that processing was performed normally
In the case of -1, there is an error in a set point of hoge.ini of the preference.
In the case of -2, an unexpected error occurred.
I call this function, and less than 0 please write in the reason at system log when it was returned.
長文はつかれるぜ、、
センス良いなｗ
TOEIC400点レベルか
We have to write the reason why it failed to system log, when the return value is less than 0.
@retval 1 succeeds
@retval 2 no data to process
@retval 0 invalid parameter
@retval -1 invalid setting(s) in hoge.ini
@retval -2 unexpected error occurred
神光臨！
ありがとうございます。
１．主語をYouにする
２．主語をWeにする
３．受動形にして目的語だったものを主語に持ってくる
などの手法があると思いますが、
ソースのコメントとしてふさわしいのはどれでしょうか？
適材適所。
臨機応変。
> If this function succeeds, it returns positive value, or returns less than 0.
0 が入っていないよ!!
それはそうと、positive value と less than 0 ってのはバランスが悪い。
もとの日本語の「1以上」「0以下」をそのまま訳したほうがいいんじゃない?
パラメタってparameterだと思ってたんだが、"Para meta"という単語もあるの？
のを習った記憶がある。無関係だが。
ちょｗｗｗ
>>61
たぶん>>>47のはexcite翻訳したんじゃあるまいか。
パラメタはparameterでいい気がす。
>When processing is normality, it is ..one or more.. return. this functionWhen processing is
>abnormality, it is ..0 or less.. return.
>The meaning of the return value is as follows.
>There is a problem in the specified parameter in case of 0 that means there was no processed data
>in case of two that means processing was normally done in case of one.
>-The mistake is found in a set value of hoge.ini of the configuration file in
>case of one.
>-The unexpected error was generated in case of two.
>
>This function must be called and 0 or less must write the reason in the system log when it
>is a return.
エキサイト翻訳馬鹿にすんな！
ヤフーは文法が強いが、言い訳がましい。
単語熟語は信用しないほうがいいね。
ということで、
技術系はエキサイトを辞書代わりに使ったほうがいいね。
あとの組み立ては自分のスキルでカバー。
0 or negative integer abnormal cases. Exact values are:
1 --- the data were processed normally.
2 --- there were no data to process.
0 --- there was some ploblem in specified paramters.
-1 --- something's wrong in configuration file hoge.ini.
-2 --- there was an unexpected error.
When 0 or minus values were returned, please record
the situation onto the system log.
100へぇ
知らんかった。今日からexcite使おうorzorz
コメントだけじゃなくて関数名も、スペル忘れたけど、セ・イクス(英語)=CX;みたいに
フランス語の発音を英語に当てた変数名だったり。
それで、つい最近安い仕事が入ったので、俺もコメントと変数の2番目の単語だけイタリア語で
書いてやった。何年後かに、誰かがソース読んで笑ってくれたらいいな。
2ch住民なら、なお良いねw
getZahyou() // gets the coordinates.
別途（用語<->日本語<->英語<->変数名）の対応表が必要になったりして
可読性が大幅に下がるので、結局
get＜用語＞
process＜用語＞By＜フロー名＞
みたいになったりするな。
お前らが日本語覚えろと。
さもなくば、日本語で質問して自分でコメント入れろと。
暇ねぇよ。コメント料払え。１字１０円くらいで。
/*
throw new NullPointerException();
*/
>>79
got!
*/
// この関数は、"20081001"のような形式の文字列を、"08/10/01"に変換します
*/
// This function converts a string in the format like "20081001" to "08/10/01".
つかここそういうスレだっけか
誰かよろしく
だめ？ｗ
全部にThis method gets ～ってつけると冗長だし
かといってGet～ってすると命令形になるし
主語が何かは明白だから、省略してもたぶん問題ない。
あと、主語(メソッド)に合わせて、動詞を-sで活用する。
以下一例として置いておきますね。
http://msdn.microsoft.com/en-us/library/bw00b1dc.aspx
WebRequest.Create (String)
Intitializes a new WebRequest instance
for the specified URI scheme.
Returns true 条件, false otherwise.
というパターンを最近愛用中。
条件はon XXXとかwhen(if) YYYY is ZZZとか。
f x,y... = | cond1 -> return1
| cond2 -> return2
>>86
ありがとー
つかここそういうスレだっけか
を
つ かここそういうスレだっけか
と脳内で解釈して、一瞬意味がわからなかったｗ
2chのやりすぎだなorz
文章の先頭に"つ"があると、間違えやすいので、気をつけたほうがいい。
// In 2channel, a "つ" in the beginning of a line means a hand of Doraemon.
// Don't forget that.
you msitake!!
NOT >>68, YES >>84
>>96 is enormously pertinent, because >>68 also starts with "つ".
TOP カテ一覧 スレ一覧 2ch元 削除依頼 ▲
リファクタリングをただのコード修正と思ってる人へ (267)
【消しゴム】MONOを使ってみるスレ4【じゃない】 (103)
【会津】パソコン甲子園2004【若松】 (775)
【至急】助けてください。 (231)
J言語 (194)
自動巡回ソフトを作りたい。 (371)
--log9.info------------------
☆★足立ナンバーのサーファーってうぜー★☆ (496)
（千葉北）新堀（勘違いローカル）その１ (445)
好きなプロいますか？ (135)
千葉県和田町白渚よそもの軍団！ (258)
【オヤジ】30代40代で始めました【デビュ～】 (499)
☆オフトレ☆カーバー・グラビティーその他 (862)
伊豆サーファー (343)
【シーズン】続・石川県のサーフィン事情【本番】 (829)
ｱﾝﾃﾞｨも乗ってるＣＨＩＬＬＩ！ (515)
サーファーがやってるＨＰ・ブログって (638)
☆ネット通販⇒サーフィン☆ (100)
【サーフ】奄美大島で波乗り【トリップ】 (647)
★湘南でサーフィンして何が楽しいの？★ Ver 33 (410)
●〇★☆鎌倉☆★〇● (567)
★ ★ 辻堂DE ③★ ★ (298)
【言っちゃえ！】サーファーの本音【2作目】 (527)
--log55.com------------------
★【MBS】こんちわコンちゃんお昼ですょ 12７
関西地区の交通情報センター（JARTIC)を語るスレ
【rfc】ラジオ福島part12(ｺｯﾁだょ)
ABCラジオ専用 批判要望スレ
王様ラジオキッズ２
れい＆ゆいの文化放送ホームランラジオ！&パっとUP&スタDON 8号
オレたちゴチャ・まぜっ!～集まれヤンヤン～ Part35
【RNB】南海放送１３・1116kHz【JOAF】