コンソールへの出力
文字列を表示
構文＝
＜文字＞を 一文字表示 → ・ ＜文字列＞を 表示 → ・ ＜文字列＞を 一行表示 → ・ 一行表示とは 表示し 改行すること。 空白表示 → ・ ＜空白数＞だけ 複数空白表示 → ・ 改行 → ・ ＜改行数＞だけ 複数改行 → ・ ＜文字列＞を ダブルクオートで囲んで表示 → ・
音を鳴らす
構文＝
音を鳴らす → ・ 注：「ベルを鳴らす」も等価定義されており、どちらを使っても良い。 注：Linux環境ではターミナルソフト依存であり、鳴らないこともある。
数値を表示
（整数向け）
構文＝
＜数値＞を 数値表示 → ・ ＜数値＞を 二桁で数値表示 → ・ ＜数値＞を 三桁で数値表示 → ・ ＜数値＞を 四桁で数値表示 → ・ ＜数値＞を 五桁で数値表示 → ・ ＜数値＞を ＜桁数＞で 桁数指定で数値表示 → ・
［Ａ１］
(再掲)
１２３を 文字列変換し 一行表示する １２３を １０桁で 桁数指定で文字列変換し 一行表示する １２３４５６を １０桁で 桁数指定で文字列変換し 一行表示する
［Ａ２］
１２３を 数値表示し 改行する １２３を １０桁で 桁数指定で数値表示し 改行する １２３４５６を １０桁で 桁数指定で数値表示し 改行する
123 ←数値表示 123 ←桁数指定で数値表示 123456 ←桁数指定で数値表示 ←-10桁--→
数値表示とは （数値 → ・） 文字列変換し 表示すること。 注：上は説明のためにあえて簡単にしてあるが、実際は 処理単語属性を付与したり、変換用の文字列実体変数を 自前で用意するなど、もう少し複雑な定義になっている。
- 注
- このほかに、上級者向けの機能として、「ニブル表示」、「バイト表示」「ワード表示」、「ダブル表示」がある。これらは整数値を１６進数で表示するもので、バイナリーデータの表示に用いられる。詳しくは上級編を参照されたい。
（小数向け）
構文＝
＜小数値＞を ＜小数桁数＞で 小数形式で表示 → ・ ＜小数値＞を ＜全桁数＞と ＜小数桁数＞で 桁数指定で小数形式で表示 → ・ ＜小数値＞を ＜小数桁数＞で 指数形式で表示 → ・ ＜小数値＞を ＜全桁数＞と ＜小数桁数＞で 桁数指定で指数形式で表示 → ・
［Ｂ１］
(再掲)
メインとは 値は 小数変数 １．２３を 値に 入れ （小数形式での表示） 値を ０桁と ５桁で 文字列変換・小数形式し 「[」を 表示してから 表示し 「]」を 一行表示し 値を ２０桁と ５桁で 文字列変換・小数形式し 「[」を 表示してから 表示し 「]」を 一行表示し （指数形式での表示） 値を ０桁と ５桁で 文字列変換・指数形式し 「[」を 表示してから 表示し 「]」を 一行表示し 値を ２０桁と ５桁で 文字列変換・指数形式し 「[」を 表示してから 表示し 「]」を 一行表示すること。
［Ｂ２］
メインとは 値は 小数変数 １．２３を 値に 入れ （小数形式での表示） 「[」を 表示し 値を ５桁で 小数形式で表示し 「]」を 一行表示し 「[」を 表示し 値を ２０桁と ５桁で 桁数指定で小数形式で表示し 「]」を 一行表示し （指数形式での表示） 「[」を 表示し 値を ５桁で 指数形式で表示し 「]」を 一行表示し 「[」を 表示し 値を ２０桁と ５桁で 桁数指定で指数形式で表示し 「]」を 一行表示し
[1.23000] ←小数形式で表示 [ 1.23000] ←桁数指定で小数形式で表示 [1.23000e+000] ←指数式で表示 [ 1.23000e+000] ←桁数指定で指数形式で表示 ←-------20桁-------→
コンソールからの入力
構文＝
文字列入力 → ＜文字列＞
以下に使い方の例を示す。
［１］
メインとは 文字列１は 文字列 ここから 「＞」を 表示し 文字列入力し 文字列１に 入れ 文字列１が 「おわり」に 等しい文字列 ならば 打ち切り つぎに 「入力した文字列は "」を 表示し 文字列１を 表示し 「" です」を 一行表示し 繰り返し。
しかし入力した文字列の実体は、内部に確保された（大域変数としての）文字列実体変数「入力文字列」に格納されるので、ユーザプログラムから直接その変数を参照しても良い。これを利用したのが次のプログラムとなる（局所変数が不要となった）。
［２］
メインとは ここから 「＞」を 表示し 文字列入力したものが 「おわり」に 等しい文字列 ならば 打ち切り つぎに 「入力した文字列は "」を 表示し 入力文字列を 表示し 「" です」を 一行表示し 繰り返し。
文字列の入力中に文字の訂正（編集）をおこなうことができるが、それはOSの機能であるためMindは関知しない。エンターキーを打鍵することでMindに戻ってくるが、最後のエンターキーのコード(CRまたはLF)は返される文字列に含まれない。＞abc ←キーボードから入力 入力した文字列は "abc" です ＞おわり ←キーボードから入力
起動引数
たとえば、コマンドプロンプトの画面から、Mindにコンパイルさせるために、
と入力した場合、mind が起動すべきプログラムであり、hello と file はその起動時の引数、すわなち起動引数である。>mind hello file
Mindのプログラムは、起動引数 という名前の関数を呼び出すことで、自分が起動されたときの起動引数を参照することができる。以下のような仕様である。
構文＝
起動引数個数 → ＜個数＞ ↑引数が無い場合は０が返される ↓ｎ番目の引数を表す文字列が返される 起動引数（ｎ） → ＜文字列＞ ↑ｎは１〜起動引数個数の整数 起動引数をモニタ → ・ (起動引数の内容をモニタ表示する)
メインとは 起動引数個数が ゼロ？ ならば 「起動引数無し」を 一行表示し さもなければ 起動引数個数を 回数指定し 「 Arg(」を 表示し 回数を 数値表示し 「)=[」を 表示し 起動引数（回数）を 表示し 「]」を 一行表示し 繰り返し つぎに。
上の実行画面では３つのケースをテストしている。>testarg 起動引数無し >testarg abc 1234 Arg(1)=[abc] Arg(2)=[1234] >testarg "abc 1234" Arg(1)=[abc 1234]
２つ目は abc と 1234 の２つの起動引数が与えられ、これをプログラムが認識している。
３つ目はコマンドラインからの指示を "abc 1234" としているが、それが空白を含んだ１つの文字列（引数）として扱われ、そのような認識結果となっている。
Mindのプログラムを書く際にワイルドカードを考慮する必要はなく、自動的に行なわれる。すなわち、プログラムが起動した時（正確には「メイン」の実行に入った時）には既にワイルドカードが展開されて起動引数群には実ファイル名が設定済みである。
次が実行例である。
>testarg test* Arg(1)=[test.src] Arg(2)=[test2.src] >testarg *test* Arg(1)=[test.src] Arg(2)=[test2.src] Arg(3)=[処理test.inf] Arg(4)=[処理test.src] >testarg *TEST* Arg(1)=[test.src] Arg(2)=[test2.src] Arg(3)=[処理test.inf] Arg(4)=[処理test.src] >testarg obj\test.* Arg(1)=[obj\test.exe] Arg(2)=[obj\test.his] Arg(3)=[obj\test.mco] Arg(4)=[obj\test.sym]
Windowsではワイルドカードの展開機能はOSによるものではなく、Mindの標準ライブラリがプログラム起動直後に介入しておこなっている。LinuxではOSが（シェルが）ワイルドカード展開を行うのでMindは介入しない。
ワイルドカードに使える文字は *（任意の複数文字に合致）と ? (任意の１文字に合致）である。
WindowsではOSがファイル名の英字大小を同一視するのと同様にワイルドカードもそのように扱われる（上記で３例目）。
また、ワイルドカードにパス名を付けることもできる（上記で４例目）。
- 注１
- サンプル testarg.src による起動引数のダンプ処理であるが、本項冒頭の構文のところに示したように、同じことをおこなう処理単語「起動引数をモニタ」が標準で備わっており、この１語を書くだけで起動引数の状況確認ができる。プログラムの動作確認に利用して欲しい。
- 注２
- 起動引数に含まれるオプションを解析するのみ便利な「起動引数をシフト」という機能もある。上級編で解説する。
私のプログラム名、私のパス名
構文＝
私のプログラム名 → ＜自身のmcoファイル名(パス付き)＞ 私のプログラム名・短縮 → ＜自身のmcoファイル名(パス無し、拡張子無し)＞ 私のパス名 → ＜自身のmcoファイルが格納されているパス＞
自身のプログラムの.mcoファイルの名前、あるいは（パスも拡張子も無い）単純なプログラム名、あるいはパスのみ‥を文字列として得ることができる。
以下は例である。
sample¥hello.exe を実行したとき
私のプログラム名 → c:¥pmind¥sample¥hello.mco
私のプログラム名・短縮 → hello
私のパス名 → c:¥pmind¥sample
sample/hello を実行したとき
私のプログラム名 → sample/hello.mco
私のプログラム名・短縮 → hello
私のパス名 → sample
./hello を実行したとき
私のプログラム名 → ./hello.mco
私のプログラム名・短縮 → hello
私のパス名 → .
上記のように、WindowsとLinuxとでパスの返り方が異なるので注意したい。Windowsではプログラムを起動する際のパスが絶対パスであろうと相対パスであろうと絶対パスで返されるが、Linuxではプログラムを起動した際のパス指定がそのまま返される。
もしLinuxで相対パスで起動された場合に、プログラムの絶対パスを得たい場合は、以下のようなコードで対応して欲しい。
私のパス名の 左端文字が パス記号に 等しい ならば ※ 絶対パスで起動された(PATH見て起動含む) ※ 私のパス名をつみ さもなければ ※ 相対パスで起動された ※ カレントディレクトリと 私のパス名で 絶対パスと相対パスをマージする つぎに ・・・・する
時間待ち、クロック
時間待ち
構文＝
十ミリ秒単位待つ → ・ 百ミリ秒単位待つ → ・ 百ミリ秒待つ → ・ 二百ミリ秒待つ → ・ 三百ミリ秒待つ → ・ 五百ミリ秒待つ → ・ 七百ミリ秒待つ → ・ 一秒待つ → ・ 二秒待つ → ・ 三秒待つ → ・ 五秒待つ → ・ 七秒待つ → ・ 十秒待つ → ・
構文＝
（起点となる時からの経過時間を知りたい場合（カウントアップ）） 計時開始 → ・ Windows版Mindのみ 経過時間 → ミリ秒 Windows版Mindのみ （あらかじめ設定した時間が経過したかを知りたい場合（カウントダウン）） ＜ミリ秒＞を タイマ設定する → ・ タイムアウト？ → ＜真/偽＞ タイムオーバ？ → ＜真/偽＞ ←「タイムアウト？」の等価語
このの組み合わせにより、何か別のことを処理しつつ、一定時間が経過したかを時々検査することができる。（単に時間待ちなら「〜秒待ち」を使うのが良い）
以下にサンプルプログラムを示す。
メインとは 起動引数（１）を 数値変換し (真偽を) 捨ててから タイマ設定し ここから タイムアウト？ ならば 打ち切り つぎに 「・」を 表示し 百ミリ秒待ち ←重要 繰り返し 改行すること。
上記ではプログラム起動時の引数で １００００ を指定しているが、単位がミリ秒なので１０秒を設定したことになる。>タイマ設定 10000 ・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ ・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ ・・・・・・・・・・・・・・・・・・・ >
繰り返しループ内で「タイムアウト？ ならば ・・・」を記述することでタイムアウトになったかを調べている。まだタイムアウトでない場合には、１ループ毎に１つ「・」を表示するとともに、１００ミリ秒だけディレイしてからループ先頭に戻している。
タイムアウトでないときのパスで「百ミリ秒待ち」をおこなっていることはとても重要である。この例のようなプログラムではループ内の１回の処理時間が短いため、意図的な時間待ちを入れないと、極めて高速にループを回ることになり、CPUに過大な負荷をかけてしまう。(空のループを回すとCPU負荷が100%近くになることもあるので注意すること）
ちなみに、「ｎ秒待ち」系の時間待ち単語ではその内部でOSに制御を戻すような別の機構を使っており、時間待ち中のCPU負荷は無い。
日時の参照（基本）
構文＝
日時を得る → ・ 上記は簡易的な使い方であり、このほかに、値を取得する先の 構造体を明示する使い方もある。詳しくは上級編にて解説する。
「日時を得る」の実行によってセットされる変数群は以下の通りである。
構文＝
年は 変数。 （1900〜） 月は 変数。 （1〜12） 日は 変数。 （1〜31） 時は 変数。 （0〜23） 分は 変数。 （0〜59） 秒は 変数。 （0〜59） 曜日は 変数。 （1〜 7 ‥ 1=日曜、7=土曜） 上記は厳密には通常変数ではなく構造体の要素変数なのだが、 とりあえずは簡単に「通常変数として参照できる」と理解して 欲しい。詳しくは上級編にて解説する。
「日時を得る」を使うプログラム例を以下に示す。
メインとは 日時を得て 「今の日時は 」を 表示し 年を 数値表示し 「年」を 表示し 月を 数値表示し 「月」を 表示し 日を 数値表示し 「日」を 表示し 時を 数値表示し 「時」を 表示し 分を 数値表示し 「分」を 表示し 秒を 数値表示し 「秒」を 表示し 「（」を 表示し 曜日で 選択する 「日」 「月」 「火」 「水」 「木」 「金」 「土」 選択終り 表示し 「曜日）」を 一行表示すること。
>日時を得る 今の日時は 2016年12月19日18時7分37秒（月曜日） >
日時の参照（高度なもの）
構文＝
日時を値で得る → ＜日時パック値(整数)＞
構文＝
＜日時パック値(整数)＞ 日時を分離 → ・ 上記は簡易的な使い方であり、このほかに、値を格納する先の 構造体を明示する使い方もある。詳しくは上級編にて解説する。
構文＝
日時を正規化 → ＜日時パック値(整数)＞ 上記は簡易的な使い方であり、要素変数を持つ構造体を明示する 使い方もある。詳しくは上級編にて解説する。
「日時を正規化」には以下のような用途がある。
- 何らかの理由で、4月31日のようなあり得ない日付が出現してしまった場合に、
それが補正できる。4月31日は5月1日に、4月0日は3月31日になる。- 今日から60日後の日付を知りたいような場合、６０だけ変数「日」を増加してから
本単語を呼び出すことで、その日付を知ることができる（複雑な日付計算をしな
くて良い）。- ライブラリ内構造体の中の変数群（「年」〜「秒」という名前の変数）をもとに、
日時情報（32ビット整数）を得る（上段２つは要素変数への反映を期待するものなので、スタックに返された整数値は捨ててしまっても良い）
（Linux環境では時・分・秒は正規化されない）
構文＝
日時を正規化し 正規化日時を英語に変換する → ＜文字列＞
返される文字列の実体は標準ライブラリ内に格納されたものなので、この単語を再度呼び出すと最初の文字列が破壊されてしまう。直ちに消費しない場合には自前のの文字列実体変数に退避するのが安全である。
以下にサンプルプログラムを示す。
メインとは 日時を得て 日時を正規化し 正規化日時を英語に変換し 「今の英語の日時は 」を 表示してから 表示し 「 です。」を 一行表示すること。
今の英語の日時は Tue Dec 20 11:10:29 2016 です。
構文＝
日時をＧＭＴで得る → ・ 上記は簡易的な使い方であり、このほかに、値を取得する先の 構造体を明示する使い方もある。詳しくは上級編にて解説する。
基本的な動作は、「日時を得る」の解説を参照されたい。
日時を文字列に変換、表示
2016年12月19日18時7分37秒（月曜日）のように表示される。しかしサンプルのソースコードをご覧いただくと分かるように、これだけの表示をするのにそこそこの分量のプログラムを必要とする。
このようなケースでは、次に示すような日時を文字列に変換する処理単語を利用すると良い。
構文＝
＜日時パック値(整数)＞を ＜フォーマット文字列＞で スタンプを日時文字列に変換 → ＜文字列情報＞ 注１：変換結果を文字列実体変数として暗黙の変数「日時変換文字列」に 生成し、そこを指す文字列情報がスタックに返される 注２：生成先の文字列実体変数を明示することもできる。上級編で解説する
次に「フォーマット文字列」というのは、以下のような、年・月・日・時・分・秒・曜日を表すようなシンボルと、その他の一般文字を並べたものである。
注：１桁の月、たとえば6月はデフォルトでは「06」と変換される。
これを「6」や「 6」にするには下記表末尾の '#' 指示を使う。
これを「6」や「 6」にするには下記表末尾の '#' 指示を使う。
Y 年(4桁) y 年(末尾2桁) M 月(2桁) D 日(2桁) h 時(2桁) m 分(2桁) s 秒(2桁) w 曜日('日'〜'土'の１文字) W 曜日("Sun"〜"Sat"の３文字) （下は１桁の数字の扱い指示。その箇所以降のフォーマットに適用される） #- 足りない桁を詰め （6→「6」となる) #s 足りない桁を空白にする（6→「 6」となる) #0 足りない桁を'0'にする （6→「06」となる(デフォルト))
| フォーマット文字列 | 変換結果 |
|---|---|
| Y-M-D h:m:s | 2013-08-23 14:20:36 |
| Y年M月D日 h時m分 | 2013年08月23日 14時20分 |
| Y年#-M月D日 h時m分 | 2013年8月23日 14時20分 |
| h時m分s秒(w) | 14時20分06秒(水) |
| h時m分s秒 w曜日 | 14時20分06秒 水曜日 |
| h:m:s (W) | 14:20:36 (Wed) |
構文＝
＜日時パック値(整数)＞を 日時を表示 → ・ ＜日時パック値(整数)＞を タイムスタンプを表示 → ・ 注：上記２語は等価なのでどちらを使っても良い
現在の日時を表示とは （・ → ・） 「現在の日時は 」を 表示し 日時を値で得て 日時を表示し 「 です。」を 一行表示すること。 ↓出力例 現在の日時は 2017-02-23 17:15:30 です。
日時を表示とは 処理単語 .N （日時(32) → ・） 実体１は 文字列実体 長さ 日時変換文字列長さ "Y-M-D h:m:s"で 実体１をつかい スタンプを日時文字列に変換し 表示すること。
