Effective Go 翻訳 ~ Formatting

Effective Go 翻訳

Formatting

Formatting issues are the most contentious but the least consequential. People can adapt to different formatting styles but it’s better if they don’t have to, and less time is devoted to the topic if everyone adheres to the same style. The problem is how to approach this Utopia without a long prescriptive style guide.

https://golang.org/doc/effective_go#formatting

フォーマットの問題は最も論争的だがそれほど重要ではありません。人々は異なるフォーマットスタイルに適応できるが、適応する必要が無い方が良く、もし全員が同じスタイルに執着するならこのトピック（フォーマット論争）に専念する時間が少なくなります。問題は長い規範的なスタイルガイド無しでこのユートピアにアプローチする方法です。

With Go we take an unusual approach and let the machine take care of most formatting issues. The gofmt program (also available as go fmt, which operates at the package level rather than source file level) reads a Go program and emits the source in a standard style of indentation and vertical alignment, retaining and if necessary reformatting comments. If you want to know how to handle some new layout situation, run gofmt; if the answer doesn’t seem right, rearrange your program (or file a bug about gofmt), don’t work around it.

https://golang.org/doc/effective_go#formatting

Goでは、通常とは異なるアプローチを採用し、ほとんどのフォーマット問題を機械に対処させます。”gofmt”プログラム（ソースファイルレベルよりもむしろパッケージレベルとして動作する”go fmt”も利用可能） はGoプラグラムを読み込み、インデント、vertical alignmentについて標準スタイルのソースを出力し、必要に応じてコメントを保持し再フォーマットします。もしあなたがいくつかの新しいレイアウト位置について扱い方を知りたいなら、”gofmt”を実行してください。もし回答が正しくなさそうであれば、回避するのではなく、プログラムを再構成して（もしくは”gofmt”についてバグを報告して）ください。

type T struct {
    name string // name of the object
    value int // its value
}

gofmt will line up the columns:

https://golang.org/doc/effective_go#formatting

“gofmt”は列を並べます。

type T struct {
    name    string // name of the object
    value   int    // its value
}

All Go code in the standard packages has been formatted with gofmt.

標準パッケージに含まれる全てのGoコードは”gofmt”でフォーマットされています。

Some formatting details remain. Very briefly:

Indentation

　We use tabs for indentation and gofmt emits them by default. Use spaces only if you must.

Line length

　Go has no line length limit. Don’t worry about overflowing a punched card. If a line feels too long, wrap it and indent with an extra tab.

Parentheses

　Go needs fewer parentheses than C and Java: control structures (if, for, switch) do not have parentheses in their syntax. Also, the operator precedence hierarchy is shorter and clearer, so

　　x<<8 + y<<16

　means what the spacing implies, unlike in the other languages.

https://golang.org/doc/effective_go#formatting

一部のフォーマットの詳細は残っています。とても簡潔に：
インデント
　私たちはインデントにタブを使用し、”gofmt”はデフォルトでそれらを出力します。必要な時のみスペースを使用してください。
行の長さ
　Goは行の長さに制限がありません。パンチカードが溢れることについて心配は要りません。もし行がとても長いと感じる場合、それを折り返し、追加のタブでインデントします。
括弧
　GoはCやJavaより括弧が少なくて済みます。制御構造（”if”, “for”, “switch”）はシンタックスに括弧を持ちません。また、オペレーターの優先順位階層は短く明確です。x<<8 + y<<16は、他の言語とは異なり、スペースが暗示することを意味します。

文法メモ

be devoted to + 名詞、devote oneself to + 名詞 （〜に専念する）

adhere to + 名詞 （〔信仰・考え・計画などに〕執着[固執]する、〔…を〕支持[信奉]する）

【使役動詞】let + A[目的語] + B[原型不定詞] （AにBさせる、AがBすることを許可する）

take care of + 人 （〜の世話をする）、take care of + 物,事 （〜を対処する）

A rather than B （BよりむしろA）

If only ~ （〜でさえあれば）、only If ~ （〜の場合に限り）

単語

参考

devoteの使い方
take care of の使い方
letの使い方
rather than の使い方