[翻訳] LLVMコーディング標準3.9.1（３/４）機械的なソースの問題 - Qiita
この記事は、LLVM Coding Standards 翻訳の３/４です。 前：言語、ライブラリ、および標準 | 目次 | 次：スタイルの問題 機械的なソースの問題 ソースコードのフォーマット コメント コメントは、可読性と保守性について重要な部分のひとつです。皆さんご存知の通り、コードにはコメントすべきです。コメントを書く場合、適切な句読点と大小文字の英文で書きます。コードがなにを行おうとしているのか、またなぜ行おうとしているのかを記載することに焦点を絞り、微細に どうやるか を書くことは避けてください。ここでは、文書に重要な事柄がいくつかあります： ファイルのヘッダ すべてのソースファイルには、ファイルの基本的な目的を説明するヘッダが必要です。ファイルにヘッダがない場合、ツリーにチェックインしてはいけません。標準のヘッダは次のようになります： //===-- llvm/Instruct
![[翻訳] LLVMコーディング標準3.9.1（３/４）機械的なソースの問題 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/1bb20e58944f07630e48704869e45141c3c800e1/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fqiita-user-contents.imgix.net%252Fhttps%25253A%25252F%25252Fcdn.qiita.com%25252Fassets%25252Fpublic%25252Farticle-ogp-background-afbab5eb44e0b055cce1258705637a91.png%253Fixlib%253Drb-4.0.0%2526w%253D1200%2526blend64%253DaHR0cHM6Ly9xaWl0YS11c2VyLXByb2ZpbGUtaW1hZ2VzLmltZ2l4Lm5ldC9odHRwcyUzQSUyRiUyRnFpaXRhLWltYWdlLXN0b3JlLnMzLmFwLW5vcnRoZWFzdC0xLmFtYXpvbmF3cy5jb20lMkYwJTJGMTQyNjM3JTJGcHJvZmlsZS1pbWFnZXMlMkYxNjA1ODEwNzUyP2l4bGliPXJiLTQuMC4wJmFyPTElM0ExJmZpdD1jcm9wJm1hc2s9ZWxsaXBzZSZmbT1wbmczMiZzPTdhNWQ3NjFhNDAyOTMyYzk3Y2EwNGQ4NTA0NDI2NTVj%2526blend-x%253D120%2526blend-y%253D467%2526blend-w%253D82%2526blend-h%253D82%2526blend-mode%253Dnormal%2526s%253D91f5d467cdfa8150e27b3a0f875d5c17%3Fixlib%3Drb-4.0.0%26w%3D1200%26fm%3Djpg%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk2MCZoPTMyNCZ0eHQ9JTVCJUU3JUJGJUJCJUU4JUE4JUIzJTVEJTIwTExWTSVFMyU4MiVCMyVFMyU4MyVCQyVFMyU4MyU4NyVFMyU4MiVBMyVFMyU4MyVCMyVFMyU4MiVCMCVFNiVBOCU5OSVFNiVCQSU5NjMuOS4xJUVGJUJDJTg4JUVGJUJDJTkzJTJGJUVGJUJDJTk0JUVGJUJDJTg5JUU2JUE5JTlGJUU2JUEyJUIwJUU3JTlBJTg0JUUzJTgxJUFBJUUzJTgyJUJEJUUzJTgzJUJDJUUzJTgyJUI5JUUzJTgxJUFFJUU1JTk1JThGJUU5JUExJThDJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmdHh0LXBhZD0wJnM9ZTJhMDhlNTU1MTI2MGE4OTNmODA5NzMzMTJjMzgzODI%26mark-x%3D120%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTgzOCZoPTU4JnR4dD0lNDB0ZW5teW8mdHh0LWNvbG9yPSUyMzFFMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtcGFkPTAmcz1jZjJlZjY0MjIwNGU4YThkNmQ0OGMzNDMyMTUxYWRkNg%26blend-x%3D242%26blend-y%3D480%26blend-w%3D838%26blend-h%3D46%26blend-fit%3Dcrop%26blend-crop%3Dleft%252Cbottom%26blend-mode%3Dnormal%26s%3Ddf48d522b110054448373d23f5ce36c8)
[翻訳] LLVMコーディング標準3.9.1（１/４）：目次＆はじめに - Qiita
コード整形にはclang-formatがいいらしい →ベーススタイルの１つとして、LLVM coding standardsがある →先進的な感じに憧れるが、日本語資料が無い ということで、LLVM coding standardsを翻訳してみました。 LLVM3.9.1版のドキュメントを元にしています。 新版対応はこちら LLVMコーディング標準 原文 目次 はじめに 言語、ライブラリ、および標準 C++標準のバージョン C++標準ライブラリ 利用するC++11言語とライブラリの機能 その他の言語 機械的なソースの問題 ソースコードのフォーマット コメント ファイルのヘッダ クラスの概要 メソッド情報 コメント書式 ドキュメンテーションコメントでのDoxygenの使用 #includeの形式 ソースコードの幅 タブの代わりにスペースを使う コードインデントの一貫 ラムダはコードブロックと
![[翻訳] LLVMコーディング標準3.9.1（１/４）：目次＆はじめに - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/e8118e18c3ab70fd66fa5eb1afb07e1914f7ea65/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fqiita-user-contents.imgix.net%252Fhttps%25253A%25252F%25252Fcdn.qiita.com%25252Fassets%25252Fpublic%25252Farticle-ogp-background-afbab5eb44e0b055cce1258705637a91.png%253Fixlib%253Drb-4.0.0%2526w%253D1200%2526blend64%253DaHR0cHM6Ly9xaWl0YS11c2VyLXByb2ZpbGUtaW1hZ2VzLmltZ2l4Lm5ldC9odHRwcyUzQSUyRiUyRnFpaXRhLWltYWdlLXN0b3JlLnMzLmFwLW5vcnRoZWFzdC0xLmFtYXpvbmF3cy5jb20lMkYwJTJGMTQyNjM3JTJGcHJvZmlsZS1pbWFnZXMlMkYxNjA1ODEwNzUyP2l4bGliPXJiLTQuMC4wJmFyPTElM0ExJmZpdD1jcm9wJm1hc2s9ZWxsaXBzZSZmbT1wbmczMiZzPTdhNWQ3NjFhNDAyOTMyYzk3Y2EwNGQ4NTA0NDI2NTVj%2526blend-x%253D120%2526blend-y%253D467%2526blend-w%253D82%2526blend-h%253D82%2526blend-mode%253Dnormal%2526s%253D91f5d467cdfa8150e27b3a0f875d5c17%3Fixlib%3Drb-4.0.0%26w%3D1200%26fm%3Djpg%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk2MCZoPTMyNCZ0eHQ9JTVCJUU3JUJGJUJCJUU4JUE4JUIzJTVEJTIwTExWTSVFMyU4MiVCMyVFMyU4MyVCQyVFMyU4MyU4NyVFMyU4MiVBMyVFMyU4MyVCMyVFMyU4MiVCMCVFNiVBOCU5OSVFNiVCQSU5NjMuOS4xJUVGJUJDJTg4JUVGJUJDJTkxJTJGJUVGJUJDJTk0JUVGJUJDJTg5JUVGJUJDJTlBJUU3JTlCJUFFJUU2JUFDJUExJUVGJUJDJTg2JUUzJTgxJUFGJUUzJTgxJTk4JUUzJTgyJTgxJUUzJTgxJUFCJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmdHh0LXBhZD0wJnM9MGJlMDdkZGE0NGMxNzI2M2JkNGRmODBmMzEzOTcxMjg%26mark-x%3D120%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTgzOCZoPTU4JnR4dD0lNDB0ZW5teW8mdHh0LWNvbG9yPSUyMzFFMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtcGFkPTAmcz1jZjJlZjY0MjIwNGU4YThkNmQ0OGMzNDMyMTUxYWRkNg%26blend-x%3D242%26blend-y%3D480%26blend-w%3D838%26blend-h%3D46%26blend-fit%3Dcrop%26blend-crop%3Dleft%252Cbottom%26blend-mode%3Dnormal%26s%3D4198522e6a28cdeef46c6b44ffdeaf73)
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
