読みやすいコードを書くために - Qiita
この記事は、社内向けに書いた資料を公開の許可を得て加筆修正したものです。 記事中の具体例やサンプルコードはJavaScript/TypeScriptで書かれていますが、内容自体は言語にかかわらず使えます。 同僚の @shisama にも手伝っていただきました。 はじめに 命名について 条件式について 関数について 変数・定数について コメントについて 2020/11/02 ついに完結！ はじめに 読みやすいコードは、コメントがなくても文章を読むように理解できます。 逆に、読みにくいコードはコメントがあってもさっぱり意味がわかりません。 文章を読むように理解できるコードを書くために普段気をつけていることや、コードレビューの際に重点的に見ているところをまとめました。 普段から読みやすいコードを心がけている方にとっては何も目新しい物はなく、当たり前に意識しているであろうことばかりです。 特にプロ
量子コンピューターで生物の進化を解明、自然淘汰の特性を再現
生命の起源や進化において量子力学的な振る舞いがどのような影響を与えるかを、量子コンピューター上の人工生命シミュレーションで調べる研究の成果が発表された。人工量子生命の複製の過程に突然変異を取り入れることで、自然淘汰をかなり忠実に再現できたという。 by Emerging Technology from the arXiv2017.12.15 193 50 5 1 量子力学は生命の仕組みにおいて、どのような役割を担うのだろうか。誰にもはっきりとは分からないことだが、最近になって、物理学者たちがあらゆる可能性について調査し始めている。その過程で、量子力学が、光合成や鳥の位置感覚に対して、そしておそらく人間の嗅覚に対しても重要な役割を果たすことを示す証拠が集められている。 量子過程が生命の起源そのものや遺伝子コードの形成を規定したに違いないという推測的な考え方さえある。このような問題を解明するた
「書き直した方が早い」は9割のケースで間違いだった - 怠惰を求めて勤勉に行き着く
はじめに、本エントリは特定の企業、チーム、個人を指して書いたものでは一切ない。100%僕の個人的な経験から来ている。 さて、職業プログラミングに従事していると一度は「これ書き直した方が早いっす」とか言ったことある気がする。自分の場合、多くは歴史のあるレガシーコードを読んだときだ。思い返せば、自分がこう思ったときはほとんどそれは間違いであった。 「なんだこのコード…」 「これ何書いてあるか分かんないっす」 「うーんこれもう書き直した方が早くないっすか？」 この流れは非常に危険だ。 なぜならプログラムというのは本質的に書いてある通りにしか動かないからだ。ちゃんと読めば絶対に何を書いてあるかは分かる。 ここで安易に選んだ書き直しという選択は、自分が慣れ親しんだやり方でその部分をそっくり置き換えるというだけで、それは他人にとってあたらしい「これ何書いてあるかあるか分かんない」を生む結果にしかならな
教えて、ござ先輩！ なぜプログラミングに「表現力」が必須？ わずか3つの表現文法でイメージをコード化する方法 - エンジニアHub｜Webエンジニアのキャリアを考える！
教えて、ござ先輩！ なぜプログラミングに「表現力」が必須？ わずか3つの表現文法でイメージをコード化する方法 自分のイメージを、ちゃんとコードとして表現することができていますか？そのために必要なのは、イメージを論理へと変換する、「表現力」です。エンジニアが身につけるべき表現力を、ござ先輩がばっちり解説します！ 株式会社クオリティスタートの代表を務めている、湯本（@gothedistance）と申します。インターネットでは、「ござ先輩」という愛称でブログを書いたり、雑誌やWebメディアに記事を書かせていただいています。本業ではITコンサルタントという立ち位置で、主に業務アプリケーションの業務分析/要件定義や、エンジニア向けの新人研修の講師などの仕事をしています。 プログラミングは非常に自由なもので、同じ処理や条件を記述しているにもかかわらず、エンジニアによって書かれたコードがかなり違うことが
Eclipseの「JSDT-jQuery」プラグインでJQuery(JavaScript)のコード補完が可能な環境を作成する
Eclipseの「JSDT-jQuery」プラグインでJQuery(JavaScript)のコード補完が可能な環境を作成する Eclipse for JavaEE Developer等のWeb開発系のEclipseがインストールされている事を前提事項としております。 これらのEclipseには、「JSDT」(JavaScript Development Tools)が含まれており、JavaScriptエディタとして「JSDT」が利用可能です。当然JavaScriptエディタですからコード補完も可能です。 とは言え、近年ではJavaScriptでjQueryを利用しないプロジェクトはほとんどお目にかかることはないです。 しかし、「JSDT」単体ではjQueryのコード補完は行えません。 このような背景から本エントリーでは、JQueryを使ったJavaScriptのコード補完が行える環境作成の
GitHubにpushしたmigrationファイルは安易に修正してはいけません - Qiita
はじめに 人間は誰しも間違いを犯します。 「恥ずかしい間違いはすぐに修正してなかったことにしたい」と考えるのは当然の心理です。 幸いなことに、プログラム中のささいなtypoであれば、ささっと修正してコミットすれば、あたかも何もなかったかのように過去の間違いをかき消すことができます。 が！ Railsアプリケーションの場合、migrationファイルだけは安易に修正してはいけません。 この記事ではその理由と、正しい修正の手順を紹介します。 問題が起きるシナリオ：花子さんはdb:migrateできない あるブログシステムにはUserテーブルがあります。 太郎さんはここに生年月日を保存するカラムを追加しました。 class AddBarthdayToUsers < ActiveRecord::Migration def change add_column :users, :barthday, :
天才プログラマーと自分との実力差をカンタンに測定する方法 - ベルリンのITスタートアップで働くジャバ・ザ・ハットリの日記
天才プログラマーと自分との実力差をカンタンに測定する方法を発見しましたよ、という話。 結論から言うと、いろんなところで過去に開催されたプログラミングコンテストの入賞者の結果を見て、その問題を同じ条件で解いてみること。 あるウェブサイトに２０１５年に開催されたプログラミング・コンテストの結果が載っていた。（本記事の末尾にそのプログラミング問題の日本語訳を載せた） 入賞者は１位の人が１５分、２位が２２分、３位が２４分、となっていた。 プログラミングの問題をザッと眺めていたら、実装すべきアルゴリズムがパッと思いついた。「これはひょっとして１位の人は超えられなくても３位入賞ぐらいはいけそうじゃね？」などと考えてしまった。 それでそのウェブサイトが用意しているエディタを使って、コードを書きだした。 １５分経過：「あれ？もう１５分も経った？まー１位にはなれなくてもトップ集団には入るわ」 ２０分経過：「
テストコードにまつわる5つのエトセトラ - give IT a try
はじめに ひとつ前のエントリでRSpecの話を書いたので、それにちなんで最近僕の身の回りで起きたテストコードに関する雑多なエピソードをいくつか書いてみます。 その１：テストコードを書いてない処理で見事にバグを出してしまった・・・！！ 僕はソニックガーデンの中では「テスト番長」の異名を持っていて、基本的にテストコードはしっかり書くタイプです。 ですが、どうしてもリリースを優先しなければいけないときは、やむを得ずテストコードを後回しにして先にリリースすることもあります。 先日リリースした「テストを後回しにしたコード」は、リリース直後は問題なく動いていました。 その数週間後、別の仕様変更が入り、変更したコードをリリースしました。 「テストは全部パスしているので大丈夫なはず～！」と思ったら、リリースの翌日に変なシステムエラーが発生。 エラーが起きている場所を見て、ガーン。 例の「テストを後回しにし
クソコードにならない為に、これだけは守って欲しい７つのこと - Qiita
まえがき 今回書く内容は、ある程度経験あるエンジニアでも、陥りがちなものに絞って書いてみたつもりですので、[重複コードは書かない]などの超あたりまえの事は書いていません。 2017/03/16 最近よく見られてそうなので１つ追記[そもそも継承するな!!!] そもそも継承するな!!! 継承するのは、どうしようもない場合のみにしてください。 その前に、strategyパターンや、compositeパターンなどの他のやり方を考慮してもなお、継承するのが妥当である場合のみにしてください。 基本的に継承しないほうが、スケーラブルだし、テストコードも容易にかけます。 継承はis-a関係 「あー、継承ね。はいはい」で飛ばしてんじゃねーよ。 いやマジで!!! ほぼ全てのエンジニアは[is-a]が何か知っています。 というのも全てのオブジェクト思考の書籍には出てくる概念だからです。 しかし、私の経験上この概
Git コミットメッセージのプラクティスまとめ - 酒と泪とRubyとRailsと
最近、自分のGitのコミットログを読み返してみたら、すごく分かりづらかったので勉強も兼ねて、Gitのコミットログのプラクティスを勉強してみました！ 🐰 Gitのコミットメッセージの書き方次のサイトを参考にさせていただきつつ、簡単にまとめてみました！ Gitのコミットメッセージの書き方 | プログラミング | POSTD Gitのコミットメッセージの書き方 - Qiita 書き方を知ることのメリットGitのコミットメッセージをわかりやすく残すことで、その変更どんな目的で具体的にどんなことを修正したかを 次の変更を行う人に伝えることができ、次の人の修正する時間を節約できる。 具体的にどんなことを書くべきかどのように変更を行ったかは、コードを見れば分かる。もしわからないのなら、コードにコメントを書くべき。 変更した理由を明らかにすることに焦点を絞り、変更前がどうで、何が問題で、今はどのように機
毎日1つコードを書くだけ！プログラミング学習の支援ツール「Code Half」が気になる | Techable(テッカブル)
今年こそ、プログラミングをモノにしたい！ITトレンドに敏感な読者の中には、そんな決意を秘めた人も多くいるだろう。 そうは言っても、多忙な皆さんのこと。勉強時間を確保するのは、なかなか難しいのではないだろうか。 今回ご紹介するのは、忙しい人でもストレスなくコードを記録できるお手軽サイト。プログラミング学習者のための支援ツール、「Code Half」だ。 ・単語帳感覚でコードを記入 内容は、実にシンプル。1日ごとに憶えておきたいコードを、指定の日付欄に記入していくだけ。 ここでコーディングを教えてくれるとか、問題が出るとかそういうことではない。その役割はあくまで、毎日の学習習慣を維持するところにある。 使い方も簡単。Eメール、Twitter、GitHubのいずれかで登録すれば、すぐに利用できる。ログインすると即、カレンダーが表示されるので、今日の日付に記憶したいコードを書き込んでいけばいい。努
変数とかを英語にするとわかりにくくないですか？
プログラムを独学で勉強している初心者です（２ヶ月くらい） ちょっとした疑問があり、質問させていただきます。 プログラムのサイトなどには、変数などの名称には英語を使うべきと書かれています。 これはなぜなのでしょうか？ はっきり言って、この風習があるために勉強で困っています。 勉強のためにサンプルコードなどを見ていても、英単語が並んでいると、 どれがプログラム特有の命令で、どれがプログラム記述者が自由につけた変数名なのかが わかりにくいのです。 変数は変数であることがはっきりわかったほうが便利だと思うのです。 プログラムに慣れている人にはそんな必要ないのでしょうが… 自分でコードを書く時には、あとから自分でわからなくならないように 変数名には必ず「h_」をつけるようにしています。 h_speed とか h_count とか。 英語にするべき理由と、初心者のうちだけでも変数がわかりやすくするよう
Androidソースコードレビューで指摘する事が多い項目まとめ2 - こやまカニ大好き
去年Androidソースコードレビューで指摘する事が多い項目まとめという記事を書いた時はアプリ全体を一度に見るような機会が多かったため、内容も大きめのものばかり書いていましたが、最近はプルリクエスト単位でレビューする機会が増えたので細かい項目についてまとめてみようと思います。 ミリ秒で時間を指定する時に自前で計算している 1000L * 60L * 60L * 24Lのようなコード。 TimeUnitを使いましょう。 24時間の場合は以下のように書けます。 TimeUnit.DAYS.toMillis(1L) ある文字列がhttp/httpsで始まるかチェック URLUtil.isNetworkUrl()を使いましょう。 ただしequalsIgnoreCaseで判定してます。 ベースURLにパラメータを付与していってURLを生成したい StringBuilder#append("&key=
ちょっといいJavaコードを書こう - Qiita
一人でプログラムを書いてたりすると、環境によってはあまりコードの書き方には指摘を受けなくて困りますよね。プロになっても、曲がりなりにもちゃんと動くコードを書けてしまうとあまりに当たり前のことなんかは指摘されることも稀で、そのままある程度偉くなっちゃった日には、もはや自分で気付くしかなくなってしまいます。 FindBugsとか、Effective Javaなら使ったり読んでみたり読ませたりすることはできますが、それ以前のところって難しいんですよね。よいコードと言うよりそれが当たり前だと思われているので、指摘するにしても「こうすればいいよ」（アドバイス）じゃなくて「なんでこうしてないの？」（詰問）になってしまいがちです。 そこで、最近そういうJavaニュービーに指摘している（したい）ことの多い、Javaの基礎的な事柄をまとめてみました。ワタシJavaチョットデキルって人は、これ以外にもやりがち
「はしれ！コード学園」ってマンガがいいかもしれない。 - 攻めは飛車角銀桂守りは金銀三枚
今日見つけた「はしれ！コード学園」ってマンガをご存知でしょうか？ たま〜に「Google Adsense」かなんかの広告に表示されてます。 はしれ！コード学園 現在第３回まであるようですが、IT業界の人はなんか笑えるんじゃないでしょうか。 https://codeiq.jp/magazine/2015/10/30057/codeiq.jp https://codeiq.jp/magazine/2015/10/31456/codeiq.jp https://codeiq.jp/magazine/2015/11/33256/codeiq.jp わたしは仕事で「Javascript」使っているのでやっぱり「JSちゃん」を推しておきましょか。 ゲームを作りながら楽しく学べるHTML5+CSS+JavaScriptプログラミング (NextPublishing) 作者: 田中賢一郎出版社/メーカー:
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Oss貢献超入門
https://qiita.com/falloutkids/items/08b3b7a2dfdc4c9eeaa3
焦点：北朝鮮の独自ＯＳ、政治体制を反映 プライバシー侵害も
http://www.smaroomch.net/programing-hituyounakoto/
良いコードとは
