JavaScript学習に役立つお話がありました。

「擬似コード」でロジックを書き出す練習について紹介されています。

www.webprofessional.jp

現実には、プロジェクトは完璧なコードをガンガン書くことではなく、たくさんの試行錯誤とリファレンスを幾度も参照して少しずつできあがるものなのです。

アプリ作成の進め方として、以下の手順が紹介されています。

最初に基本を身に着けよう 計画を立てる コード無しで書いていく 小さな部分に分けて製作する 各パーツを結合する 実験とテスト 外部の助けを求める コードのリファクタリング（再構築）

あ

擬似コードの活用

「コード無しで書いていく」って、どういうことでしょうか？

計画ができあがったら、詳細を考えます。 個人的に最良だと思う方法は、プロジェクトの各パートにおいてなにが求められるのかを具体的に書き出すことです。 このとき、まだコードを書かずに言葉だけで記述するのがカギです。 これはpseudocode（疑似コード）と呼ばれます。 pseudocodeなら構文を気にすることなく、プロジェクトの動作だけに思考を集中できます。

いったんロジックを書き出してしまえば、コードを書くのが格段に楽になります。 なぜなら、いきなり「カウントダウン時計を作れ」と言われて全コードを書くよりも、「終了時刻から現在時刻を引き算する」といった具体的な手順にしたがってコードを書くほうが簡単だからです。

擬似コード - Wikipedia

擬似コード （pseudocode）とは、アルゴリズムなどを、架空の非常に高水準なプログラミング言語（擬似言語）で記述したものである。 プログラミング言語の構文と、自然言語に近い表現を組み合わせて記述することが多い。 if クレジットカード番号が有効 番号と注文で取引をする else エラーを表示する end if

擬似コードとは、実際のプログラミング言語の代わりに、人間の話し言葉で書いたコードのことです。

→ 買い物のメモ書きやToDoリストのように、必要なことを普通の言葉でズラズラ書いていけばOK！（意味が分かれば、書き方は自由ｗ）

プログラミングに慣れていない段階では、いったん擬似コードでロジック（処理の流れ）を書いて、それから実際のプログラミング言語に置き換えると、コードが書きやすくなります。

文芸的プログラミングの応用

擬似コードは、けっこう具体的な内容になっていますが、もう少し抽象的な（適当な？）書き方として、「文芸的プログラミング」という方法もあります。

文芸的プログラミング - Strategic Choice

話し言葉で先にコメントを書いてから、次に具体的なコードを書いていくと、いきなりコードを書くよりは多少楽ですね？

APIドキュメントジェネレーター

各プログラミング言語には、コメントからドキュメント（仕様書、説明書）を作成するツールがたいてい用意されています。

アプリケーションプログラミングインタフェース - Wikipedia

ドキュメンテーションジェネレータ - Wikipedia

ドキュメンテーションジェネレータ (documentation generator)は、特別なコメントが記述されたソースコードファイルの集合、または一部の例ではバイナリファイルの集合から、プログラマ(APIドキュメンテーション)やエンドユーザ(エンドユーザーガイド)またはその両方を対象としたドキュメンテーションを生成するプログラミングツールである。

ソフトウェアドキュメンテーション - Wikipedia - ソースコードからの文書生成ツール

JavaScript用のAPIドキュメントジェネレーターには、JSDocなどいろいろあります。

efcl.info

dev.classmethod.jp

YUIDocとは? JavaScriptのドキュメントを生成ツールです。 プロパティ用のコメント記述方法

ドキュメントコメントの書き方は、どのプログラミング言語やツールでも、だいたい同じです。

JavaScriptのドキュメントコメントの記述例

function MyClass() { this .hoge = function (name , age) { } this .fuga = 10; }

プログラムの設計や実装の練習でも、擬似コードやコメントを活用すれば、コードを書きやすくなると思います。

プログラミングを楽にするための工夫をいろいろ取り入れていきたいです。