算譜(program)が計画(plan),設計(design)である３つの理由, coding(33) 図(27)

算譜(program)を書いていて、時々、計画(plan)や設計(design)を、別に書けという人がいます。

「はい、これが計画(program)です」と答えるようにしています。あるいは、
「ごめんなさい、これが設計(design)なんです」と答えます。

算譜(program)に変換できない文書は作らないようにしています。

 <この項は書きかけです。順次追記します。>
# 理由1 算譜(program)は計画(plan)
算譜(program)は、計画(plan)するという意味です。

program:a plan of action to accomplish a specified end(特定の目的を達成するための行動計画)
http://www.dictionary.com/browse/programme

計算機の算譜(program)は、計算機の動作の設計です。

振り返って考えて見ましょう。計算機で変換できない言語で書いたものは、例えば会議録などは、人間の行動に対する方針です。それで計算機の行動は計画できません。

算譜(program)が計算機の計画・設計です。例えば、C言語で見かける部分を見てみましょう。

```
int main(int argc,char * argv[]){
```
int:OSに整数型で戻り値を返す関数です。16bitコンパイラでは16bit整数, 32bit コンパイラでは32bit整数です。
main(): OSから直接コマンド等で呼ぶことができる関数です。
():引数列です。
int argc: 整数の引数の個数(argument counter)をOSから受け取る変数argcを宣言します。
char * argv:引数の文字列の配列(argument vector)の変数argvを宣言します。最初の文字列は関数名そのものです。
{}:main関数の定義の範囲を示します。

いかに、計画しているかわかりますね。
1) OSを前提としている。
2) OSに値を返す意思がある。
OSを前提としなかったり、OSに値を返す意思がないときはintではなくvoidと書く。
3) 引数を使う。
ここが設計の基本仕様です。
さらに詳細な設計は関数定義の中に記述します。

大事なのは、上記の意味を、どの文書に基づいているかを付記しているかです。

```
return argc;
}
```
最後に返すのに良いものがないときは、argcを返すようにしています。
これは、プログラムが外部から受け取った引数を途中で破壊しなかったかを確かめる試験プログラムを書くことができるからです。
そんな馬鹿なという方がお見えになるかもしれません。暴走しかけのプログラムでは、これでも効果があることがあることがあることが、、、。

## 1.1 利用したコンパイラの手引き(manual)を記載する。
大事なのは、コンパイラの版が特定できるかどうか。手引きの発行年、手引きの版なども記載するとよい。

## 1.2 利用したコンパイラとその版を記載する。
手引きではなく、コンパイラの版だけを記載してもよい。

## 1.3 利用可能なC言語規格を記載する。
利用可能なコンパイラが多くあれば、適用可能なC言語規格を記載してもよい。

記載例：
https://researchmap.jp/jovqfzcc8-1797580/#_1797580

# 理由2 変換可能性
最初は、図で書こうが、日本語で書こうが実は構わないのです。その書いたものを、計算機が処理できる言語に変換できればいいだけです。何で書こうが、その書いたものが算譜(program)です。

逆に、計算機が処理できない言語で書いたものと、計算機が処理できるものを別々に書くのは、無駄であるだけでなく、誤解を招いたり、保守の間違いを誘引する可能性があり、とても危険です。

だれか、「こういう設計書を書け」と言われたら、「その設計書を計算機が処理できる変換器を書いていただけますよね？」と答えよう。
あるいは、自分で変換可能器を作れるような文章だけ書けばよい。できれば、変換器もついでに作ってみよう。

状態遷移図などは計算機が処理可能な言語に変換する道具が普及しています。文字で書くと伝わりにくいことは、図で書いたり、図だけだと抜け漏れが生じる可能性があるので表に算譜で変換できる道具があります。

ところで、書いた算譜が必要な仕様に適合しているかを確かめる算譜もあります。モデル検査言語、仕様記述言語、検証言語と呼ばれているものです。これらの算譜は直接最終的な製品に含まれませんが、書いたものが妥当かどうかを計算機で確かめるために用います。計画類（仕様類）の一部と理解しておくといいかもしれません。

また、時間的に間に合うかどうかを試験する道具類も記述しましょう。

算譜には、理由１で書いたのとは別の切り口でも、道具類とその利用可能な版を列記するか、仕様・規格を列記しましょう。

図を使って分析・設計すればこんなに簡単。安全(11), 図(11) https://qiita.com/kaizen_nagoya/items/6347eb55b2812d745549

設計 図(12) 表はいつ(when)書く、何を(what)書く、どうやって(how)書く。 仮説(71) https://qiita.com/kaizen_nagoya/items/7fddfa5d8bfb5a947db8

### 反省点1
書いていて、linkerの版を記載するのを忘れていたことに気が付いた。
linkerによっては、結合できるライブラリの範囲が異なることがある。
また、macosではlinkerの機能がgccと異なるらしい。

### 反省点2
ライブラリの版を記載するのを忘れていたことがある。
ライブラリの種類は、コンパイラを呼び出すときの記述(script)にライブラリ指定で名前がわかる。ただし、-lpcapのように、libpcapを導入して、指定するときはlibを省略するという作法などについても記載が必要な場合がある。

Macintosh対応「基礎からわかるTCP/IP　アナライザ作成とパケット解析　Linux/FreeBSD対応」小高知宏　オーム社
https://qiita.com/kaizen_nagoya/items/517411b42fc5ceabd581

# 理由3 抽象度
論理回路記述言語(verilog HDL)では、言語で書いた文字列が設計書で、回路図が実装です。
配線などは抽象化されていて、回路図でも、まだ実装ではないと言うこともできます。配線の指定まであって、初めて実装。

C言語で言えば、C言語が設計書で、コンパイラがコンパイルした機械語が実装です。機械語でも、まだ実装ではないと言うこともできます。linker, locatorで、どのような順番で機械語を配置するか、メモリのどこに配置するかなど、実装までの道のりは、論理記述と同様長いのです。

いつも同じlinker, locatorを使っているから、Cの記述が決まれば実装が決まるのだというのは、制約条件次第だと言っているのと等価です。linkしたものを、メモリのどの領域に配置するかで、動作が変わる場合があります。ところで、locaatorはloaderとも言います。送り込む側の視点か受け取る側の視点の名前の違いかも。

リンカ・ローダ実践開発テクニック―実行ファイルを作成するために必須の技術 
,坂井弘亮,CQ出版,2010
https://www.amazon.co.jp/dp/4789838072/ref=asap_bc?ie=UTF8

## 課題　統計における偏りと確率
Wikipediaの情報の偏りは、半端ない。自分で書き足した量以上を、引用、参照してはいけない。
Wikipediaの記述の偏りを統計的に評価して、より多くの立場から見た記述が大量に必要である。
現状のWikipediaをそのまま、引用、参照する文章は、ゴミか、カスか、クズか、迷信か、妄想かのいずれかの確率が高いらしい。

Aaron Swartz: El mártir de INTERNET
https://qiita.com/kaizen_nagoya/items/3d9d545e84cad6781d97

「伏見康治 確率論及統計論」輪講。仮説(95) 統計(9) 量子(26)
https://qiita.com/kaizen_nagoya/items/89d0a91a56d33529e85c

# 参考文献
【クソ食らえ】CocoaPodsとApple Mach-O Linker Errorとlinker command failed with exit code 1でどハマり
https://qiita.com/sutchan/items/0a78042261ca3f0a7d91

RTL設計スタイルガイドVerilogHDL版が電子書籍として復活
http://www.eda-express.com/2016/08/rtlveriloghdl.html

SEI CERT C Coding Standard  AA. Bibliography
https://wiki.sei.cmu.edu/confluence/display/c/AA.+Bibliography

The latest publically available version of the C11 standard
http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1570.pdf
## 自己参照
self-reproduction方式によるBasicプログラム ジェネレータの作成, 小川清, 電気関係学会東海支部連合大会, 1987年10月
https://qiita.com/kaizen_nagoya/items/117c7a1b6dad97470ae9

OBJ の試用経験,小川 清,二木厚吉,ソフトウェア技術者協会シンポジウム,1992 年 6 月
 https://qiita.com/kaizen_nagoya/items/acb2f1740740d5e57892
 
C++ Support(0)　
https://qiita.com/kaizen_nagoya/items/8720d26f762369a80514

Coding Rules(0) C Secure , MISRA and so on 
https://qiita.com/kaizen_nagoya/items/400725644a8a0e90fbb0

[C][C++]の国際規格案の例題をコンパイルするときの課題７つ。
https://qiita.com/kaizen_nagoya/items/5f4b155030259497c4de

C Puzzle Bookの有り難み5つ、C言語規格及びCコンパイラの特性を認識
https://qiita.com/kaizen_nagoya/items/d89a48c1536a02ecdec9

The C++ Standard Library: clang++とg++でコンパイルしてみた(まとめ):14件
https://qiita.com/kaizen_nagoya/items/9bdfaa392443d13e5759

C++17 - The Complete Guide clang++とg++でコンパイルしてみた(まとめ):4件
https://qiita.com/kaizen_nagoya/items/c000f307e642990781e1

C++N3242, 2011, ISO/IEC 14882, C++ standard(1) Example code compile list
https://qiita.com/kaizen_nagoya/items/685b5c1a2c17c1bf1318

C++N4606 Working Draft 2016, ISO/IEC 14882, C++ standard(1) Example code compile list
https://qiita.com/kaizen_nagoya/items/df5d62c35bd6ed1c3d43/

C++N4741, 2018 Standard Working Draft on ISO/IEC 14882 sample code compile list
https://qiita.com/kaizen_nagoya/items/3294c014044550896010

C++N4910:2022 Standard Working Draft on ISO/IEC 14882(0) sample code compile list
https://qiita.com/kaizen_nagoya/items/fc957ddddd402004bb91

Autosar Guidelines C++14 example code compile list(1-169)
https://qiita.com/kaizen_nagoya/items/8ccbf6675c3494d57a76

coding (101) 一覧を作成し始めた。omake:最近のQiitaで表示しない5つの事象
https://qiita.com/kaizen_nagoya/items/20667f09f19598aedb68

OSEK OS設計の基礎　OSEK(100)
https://qiita.com/kaizen_nagoya/items/7528a22a14242d2d58a3

Error一覧 error(0)
https://qiita.com/kaizen_nagoya/items/48b6cbc8d68eae2c42b8

# 関連資料
' @kazuo_reve 私が効果を確認した「小川メソッド」
https://qiita.com/kazuo_reve/items/a3ea1d9171deeccc04da

' @kazuo_reve 新人の方によく展開している有益な情報
https://qiita.com/kazuo_reve/items/d1a3f0ee48e24bba38f1

' @kazuo_reve Vモデルについて勘違いしていたと思ったこと
https://qiita.com/kazuo_reve/items/46fddb094563bd9b2e1e
## 自己記事一覧
プログラマが知っていると良い「公序良俗」
https://qiita.com/kaizen_nagoya/items/9fe7c0dfac2fbd77a945

逆も真：社会人が最初に確かめるとよいこと。OSEK(69)、Ethernet(59)
https://qiita.com/kaizen_nagoya/items/39afe4a728a31b903ddc

「何を」よりも「誰を」。１０年後のために今見習いたい人たち
https://qiita.com/kaizen_nagoya/items/8045978b16eb49d572b2

Qiitaの記事に３段階または５段階で到達するための方法
https://qiita.com/kaizen_nagoya/items/6e9298296852325adc5e

物理記事　上位100
https://qiita.com/kaizen_nagoya/items/66e90fe31fbe3facc6ff

量子(0) 計算機, 量子力学 
https://qiita.com/kaizen_nagoya/items/1cd954cb0eed92879fd4

数学関連記事１００
https://qiita.com/kaizen_nagoya/items/d8dadb49a6397e854c6d

統計(0)一覧
https://qiita.com/kaizen_nagoya/items/80d3b221807e53e88aba

図(0) state, sequence and timing. UML and お絵描き 
https://qiita.com/kaizen_nagoya/items/60440a882146aeee9e8f

品質一覧 
https://qiita.com/kaizen_nagoya/items/2b99b8e9db6d94b2e971

言語・文学記事　１００
https://qiita.com/kaizen_nagoya/items/42d58d5ef7fb53c407d6

医工連携関連記事一覧
https://qiita.com/kaizen_nagoya/items/6ab51c12ba51bc260a82

自動車　記事　１００
https://qiita.com/kaizen_nagoya/items/f7f0b9ab36569ad409c5

通信記事１００
https://qiita.com/kaizen_nagoya/items/1d67de5e1cd207b05ef7

日本語（０）一欄
https://qiita.com/kaizen_nagoya/items/7498dcfa3a9ba7fd1e68

英語(0) 一覧
https://qiita.com/kaizen_nagoya/items/680e3f5cbf9430486c7d

転職(0)一覧
https://qiita.com/kaizen_nagoya/items/f77520d378d33451d6fe

仮説（0）一覧（目標100現在40）
https://qiita.com/kaizen_nagoya/items/f000506fe1837b3590df

音楽　一覧(0) 
https://qiita.com/kaizen_nagoya/items/b6e5f42bbfe3bbe40f5d

「@kazuo_reve 新人の方によく展開している有益な情報」確認一覧 
https://qiita.com/kaizen_nagoya/items/b9380888d1e5a042646b

Qiita(0)Qiita関連記事一覧（自分）
https://qiita.com/kaizen_nagoya/items/58db5fbf036b28e9dfa6

鉄道（０）鉄道のシステム考察はてっちゃんがてつだってくれる
https://qiita.com/kaizen_nagoya/items/26bda595f341a27901a0

安全（0）安全工学シンポジウムに向けて: 21
https://qiita.com/kaizen_nagoya/items/c5d78f3def8195cb2409

一覧の一覧( The directory of directories of mine.) Qiita(100)
https://qiita.com/kaizen_nagoya/items/7eb0e006543886138f39

Ethernet 記事一覧　Ethernet(0)
https://qiita.com/kaizen_nagoya/items/88d35e99f74aefc98794

Wireshark 一覧 wireshark(0)、Ethernet(48) 
https://qiita.com/kaizen_nagoya/items/fbed841f61875c4731d0

線網（Wi-Fi）空中線(antenna)(0) 記事一覧(118/300目標)
https://qiita.com/kaizen_nagoya/items/5e5464ac2b24bd4cd001

プログラマによる、プログラマのための、統計(0)と確率のプログラミングとその後
https://qiita.com/kaizen_nagoya/items/6e9897eb641268766909

なぜdockerで機械学習するか 書籍・ソース一覧作成中 (目標100)
https://qiita.com/kaizen_nagoya/items/ddd12477544bf5ba85e2

言語処理100本ノックをdockerで。python覚えるのに最適。:10+12
https://qiita.com/kaizen_nagoya/items/7e7eb7c543e0c18438c4

プログラムちょい替え（0）一覧:4件
https://qiita.com/kaizen_nagoya/items/296d87ef4bfd516bc394

Python(0)記事をまとめたい。
https://qiita.com/kaizen_nagoya/items/088c57d70ab6904ebb53

官公庁・学校・公的団体（NPOを含む）システムの課題、官（０）
https://qiita.com/kaizen_nagoya/items/04ee6eaf7ec13d3af4c3

「はじめての」シリーズ　 ベクタージャパン　
https://qiita.com/kaizen_nagoya/items/2e41634f6e21a3cf74eb

AUTOSAR(0)Qiita記事一覧, OSEK(75)
https://qiita.com/kaizen_nagoya/items/89c07961b59a8754c869

プログラマが知っていると良い「公序良俗」
https://qiita.com/kaizen_nagoya/items/9fe7c0dfac2fbd77a945

LaTeX(0) 一覧　
https://qiita.com/kaizen_nagoya/items/e3f7dafacab58c499792

自動制御、制御工学一覧（０）
https://qiita.com/kaizen_nagoya/items/7767a4e19a6ae1479e6b

Rust(0) 一覧　
https://qiita.com/kaizen_nagoya/items/5e8bb080ba6ca0281927

100以上いいねをいただいた記事16選
https://qiita.com/kaizen_nagoya/items/f8d958d9084ffbd15d2a

小川清最終講義、最終講義（再）計画, Ethernet(100) 英語(100) 安全(100)
https://qiita.com/kaizen_nagoya/items/e2df642e3951e35e6a53

＜この記事は個人の過去の経験に基づく個人の感想です。現在所属する組織、業務とは関係がありません。＞
This article is an individual impression based on the individual's experience. It has nothing to do with the organization or business to which I currently belong.
### 文書履歴(document history)
ver. 0.01 初稿　20180218
### 最後までおよみいただきありがとうございました。
いいね　💚、フォローをお願いします。
####  Thank you very much for reading to the last sentence.
Please press the like icon 💚　and follow me for your happy life.