8000 Improve translation up to "Prefer let-bindings over var-bindings wher… · codedebug/swift-style-guide@0924898 · GitHub
[go: up one dir, main page]
Skip to content

Commit 0924898

Browse files
author
pluis91
committed
Improve translation up to "Prefer let-bindings over var-bindings wherever possible"
1 parent d89f258 commit 0924898

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

‎README_JP.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,40 @@
11
Swift コーディング規約
22

3-
このドキュメントは以下に挙げるゴールを達成するために必要なパターンから構成されています。（順番が大まかな優先順位となっています）
3+
このドキュメントは、以下に挙げる目標を達成できる方法を促進するための試みとして作成されたものです。（大まかな優先度順となっています）
44

5-
1. 精密さ・厳格さの向上, プログラマの思い込みによるエラーの減少
6-
1. 議論の明瞭性の向上
7-
1. 冗長性の減少
8-
1. 美学についての議論の削減
5+
1. より厳密で、プログラマが誤解する可能性が少ないこと
6+
1. 意図が明確であること
7+
1. 冗長さが排除されていること
8+
1. 美学についての議論が少ないこと
99

10-
もしおすすめのパターンがあれば[ガイドライン](CONTRIBUTING.md)を読み、プルリクエストを送ってください。:zap:
10+
もし提案があれば、[ガイドライン](CONTRIBUTING.md)を読み、プルリクエストを送ってください。:zap:
1111

1212
また、日本語版のこのドキュメントでは Swift 言語仕様翻訳において[詳解Swift](http://www.amazon.co.jp/dp/4797380497)を参考としています。
1313

1414
----
1515

1616
#### 空白
1717

18-
* タブを使う、スペースではなく
19-
* ファイル終端は改行で
20-
* 空白改行をロジック毎にコードを分けるときは使用する
21-
* 行の末端に空白は残さない
22-
* 空白行のインデント調整は除く
18+
* スペースではなく、タブを使う
19+
* ファイル終端は改行する
20+
* コードをロジック毎に分割するために、空白行を惜しみなく使う
21+
* 行末に空白を残さない
22+
* 空白行でのインデント調整もしない
2323

2424

25-
#### 可能な限り`let`宣言を`var`宣言より優先する
25+
#### 可能な限り`var`宣言よりも`let`宣言を使う
2626

27-
`var foo = …`より`let foo = …`を可能な限り（どちらか迷った時にも）使いましょう。本当に使わないといけない時にだけ`var`を使うようにしましょう。（具体的にはあなたがその値が変わり得ることを*知っている*ときや、`weak`プロパティ修飾子を使っている時などです）
27+
可能な限り（どちらか迷った時にも）`var foo = …`より`let foo = …`を使いましょう。`var`は本当に使わないといけない時にだけ使うようにしましょう。（具体的には、あなたがその値が変わり得ることを*知っている*ときや、`weak`プロパティ修飾子を使っている時などです）
2828

29-
_理由:_ 二つのキーワードの意図と意味が明瞭だからです。*デフォルトでlet*はより安全でより明確なコードを導き出します。
29+
_理由:_ 二つのキーワードの意図と意味は明瞭ですが、*デフォルトでlet*を使うことは、より安全でより明確なコードになります。
3030

31-
`let`宣言は、その値が続くことになっており、決して変わらないという*プログラマへの明確なサインとなります。なので、連続的なコードではそれが読む上で強力な手助けとなります。
31+
`let`宣言は、その変数の値が変わらないとを想定されていて、かつ実際に変わらない
32+
ことを保証すると同時に、それをプログラマに明確に伝えます。そのため、その後に続くコードにおいて、その変数の用途を推測しやすくなります。
3233

33-
[?]コードの理由付けがより簡単になります。値が決して変わらないかどうか悩んでいる時に使った`var`に対して、あなたはマニュアルでチェックしないといけません。
34+
コードを論理的に理解するのがより簡単になります。値が決して変わらないと考えているにもかかわらず`var`を使うと、本当に値が変わらないかどうかを手動でチェックしなければいけません。
35+
36+
この方法に従うと結果的に、`var`宣言が使われているのを発見した時は必ず、その値が変わり得ると推測したり、その理由を考えることができます。
3437

35-
[?]よって、いかなる場合でも`var`宣言が使われているのを発見した時はその値が変わると仮定し、なぜなのかを考えながらコードを読むことができます。
3638

3739
#### オプショナル型の開示指定は避ける
3840

0 commit comments

Comments
 (0)
0