MUMPS 76 プライマー – アニバーサリーエディション
The MUMPS 76 Primer – anniversary edition (github.com)
要約
この記事は、1976年に標準化されたMUMPS(Massachusetts General Hospital Utility Multi-Programming System)の入門書兼チュートリアルです。MUMPSは、統合されたプログラミング言語と階層型データベースを特徴とし、今日のNoSQLデータベースやキーバリューストアの概念を先取りしていました。プログラマー向けに、MUMPSの歴史的意義、言語の仕組み、基本的なコマンドや関数、特殊変数を網羅的に解説しています。
全文翻訳
MUMPS_Primer.adoc
MUMPSプライマー:1976年標準の紹介とチュートリアル
目次
- 1. はじめに
- 2. 言語の概要
- 3. 変数とデータ型
- 4. 式と演算子
- 5. コマンド
- 6. 文字列関数
- 7. グローバルデータベース
- 8. 入出力
- 9. 間接参照
- 10. 特殊変数
- 11. ルーチンとプログラム構造
- 12. まとめ
- 13. コマンドリファレンス
- 14. 関数リファレンス
- 15. 特殊変数リファレンス
- 16. 演算子リファレンス
- 17. 構文概要
- 付録A: ASCIIコード表
- 付録B: 用語集
- 18. 本書で扱わなかったこと
- 参考文献
1. はじめに
1.1. MUMPSとは何か?
1966年、ボストンのマサチューセッツ総合病院コンピュータサイエンス研究所で、Octo Barnett、Neil Pappalardo、Curtis MarbleがMUMPS(Massachusetts General Hospital Utility Multi-Programming System)というプログラミング言語を作成しました。
MUMPSは実用的なニーズから生まれました。病院では、医師や看護師が複数の端末からリアルタイムで患者データを同時にアクセス・更新できるシステムが、手頃な価格のハードウェアで必要とされていました。1966年当時、「手頃な価格のハードウェア」とは、メモリ8Kワードと小さなディスクを備えたDEC PDP-7を意味しました。別個のレイヤーを積み重ねる余地はありませんでした。独立したオペレーティングシステム、ファイルシステム、データベースサーバー、アプリケーション言語などを重ねることはできませんでした。すべてを一つの統合システムにする必要がありました。
その結果生まれたのは、組み込みの階層型データベースを持つプログラミング言語という、驚くべきものでした。データベースの世界では、40年後に「NoSQL」という名前が付けられることになるものです。統合されたプログラミング言語を持つNoSQLデータベースでした。
MUMPSのコアデータ抽象化は「グローバル変数」です。これは、ディスク上に永続的に保存され、すべての同時ユーザー間で共有される階層的なスパース配列です。今日の言葉で言えば、グローバルはスキーマフリーで順序付けられたキーバリューストアであり、複合キーを持ち、最初の代入時に作成され、要求に応じて削除されます。
SET ^PATIENT(12345,"NAME")="Smith, John"
SET ^PATIENT(12345,"DOB")="1945-03-15"
SET ^PATIENT(12345,"LAB","2024-01-15","GLUCOSE")=95
CREATE TABLEも、スキーマ定義も、INSERT文もありません。階層パスに値をSETするだけで、システムは必要な中間ノードをすべて作成します。ノードをKILLすれば、その下のサブツリー全体が消滅します。
1966年にMUMPSが持っていた、コンピューティングの世界が何十年もかけて再発明することになったものを考えてみましょう。
-
スキーマフリーストレージ: 宣言は不要です。ノードは最初の代入時に作成されます。これはMongoDBが2009年に「スキーマレスドキュメント」と呼んだものです。
-
階層データモデル: 患者記録は自然にツリーを形成します。MUMPSグローバルはこの構造を直接反映します。これはFirebaseが2012年に「リアルタイム階層データ」と呼んだものです。
-
順序付きキー走査:
$NEXT関数は、明示的なインデックスなしでソート順に兄弟ノードを走査します。これはRedisが2009年に「ソート済みセット」と呼んだもの、またはLevelDBが2011年に「順序付きイテレーション」と呼んだものです。 -
統合された言語とデータベース: インピーダンスミスマッチはありません。変数とデータベースノードは同じ構文、同じデータ型、同じ操作を使用します。
これらすべてが、8キロバイトのメモリを持つマシン上で、複数の同時ユーザーにサービスを提供していました。
1.2. 1976年標準
1970年代初頭までに、複数のベンダーが独自の互換性のないMUMPS方言を作成していました。1972年に結成されたMUMPS開発委員会(MDC)は、共通の標準を作成することに着手しました。その結果は、1976年1月に米国国立標準局によってNBS Handbook 118: "MUMPS Language Standard"として発行されました。同年の後半には、Melvin Conway(「Conwayの法則」で有名)によって、付随文書であるProgrammers' Reference Manual(MDC/42)が執筆されました。これら二つを合わせると、MUMPSの最初の完全かつ正式な仕様となります。
1976年標準は驚くほどミニマルです。
-
19コマンド: BREAK, CLOSE, DO, ELSE, FOR, GOTO, HALT, HANG, IF, KILL, LOCK, OPEN, QUIT, READ, SET, USE, VIEW, WRITE, XECUTE
-
12関数: $ASCII, $CHAR, $DATA, $EXTRACT, $FIND, $JUSTIFY, $LENGTH, $NEXT, $PIECE, $RANDOM, $SELECT, $TEXT
-
7特殊変数: $HOROLOG, $IO, $JOB, $STORAGE, $TEST, $X, $Y
これが言語のすべてです。JOBコマンド(プログラムによるマルチタスク)はありません。NEWコマンド(ローカル変数スコープなし – これは1984年に登場)もありません。移植性のためにサブスクリプトは非負整数に制限されていました。最大文字列長は255文字でした。それでも、数百万人の患者にサービスを提供する病院情報システムを構築するには十分でした。
このプライマーは、まさにこの1976年標準、つまり数十年間の拡張が行われる前の、本質的で結晶化されたMUMPSを扱います。
1.3. この本の対象読者
この本は、少なくとも他の1つの言語に精通しており、MUMPSが何であったか、どのように機能したか、そしてなぜ歴史的に重要であったかを知りたいプログラマーを対象としています。事前のMUMPS経験は必要ありません。
この本は3つの目的を果たします。
- 入門: MUMPSとは何か、なぜ重要なのか。
- チュートリアル: 対話的に進めることができる、例駆動の段階的な言語解説。
- クイックリファレンス: 1976年標準のすべてのコマンド、関数、特殊変数の要約。
単一ユーザー操作に焦点を当てます。LOCKやデバイス共有のようなマルチユーザー機能は関連する箇所で言及しますが、その完全な説明は延期します。
1.4. 始め方
例を実際に試すには、対話モードでMUMPSインタプリタを起動してください。プロンプトが表示されます。
>
このプロンプトで、任意のMUMPSコマンドを入力すると即座に実行されます。試してみてください。
>WRITE "Hello, World!",!
Hello, World!
コンマの後の!は、改行を生成するフォーマットコードです。構文については後ほど詳しく説明します。
インタプリタを終了するには、次のように入力します。
>HALT
バッチモードでMUMPSプログラムを実行することもできますが、学習のためには対話モードが理想的です。各コマンドに対して即座にフィードバックが得られます。
2. 言語の概要
詳細に入る前に、他の言語から来たプログラマーのためにMUMPSの全体像を把握しましょう。MUMPSには、意図的に、異なる設計上のトレードオフを反映した、いくつか馴染みのない機能があります。
2.1. 全ては文字列
MUMPSにはデータ型は1つしかありません。それは文字文字列です。数値は、数値のように見える文字列にすぎません。文字列"42"と数値42は同じ値です。算術演算を実行すると、MUMPSは自動的に文字列を数値として解釈します。連結するときは、値を文字列として扱います。型宣言、型エラー、変換の心配はありません。
2.2. 演算子の優先順位なし
すべての二項演算子は厳密に左から右に評価されます。乗算が加算より先に行われるという規則はありません。式2+3*4は、2+3が最初に計算され(結果は5)、次に5*4が20になるため、14ではなく20と評価されます。これをオーバーライドするには括弧を使用します:2+(3*4)は14になります。
これは馴染みがないかもしれませんが、優先順位の誤解に関連するバグのクラス全体を排除します。
2.3. 行指向の構造
MUMPSプログラムは行のシーケンスです。各行には、オプションのラベル(DO、GOTO、または$TEXTからの参照用)、それに続く必須のスペース区切り文字、そしてゼロ個以上のコマンド(単一スペースで区切られる)があります。
LABEL command1 argument command2 argument ;comment
スペースは構文的に重要です。単一スペースはコマンドワードとその引数を区切ります。2つのスペース(または行末)は、引数のないコマンドを次のコマンドまたはコメントから区切ります。セミコロンは行末まで続くコメントを開始します。
2.4. コマンドは簡潔
すべてのコマンドにはフルネームと1文字の略称があります。どちらも常に有効です。SET X=1とS X=1は同一です。WRITEとW、IFとI、FORとFなどです。経験豊富なMUMPSプログラマーは普遍的に略称を使用するため、MUMPSコードは非常に高密度になります。このチュートリアルでは、明確さのために一般的にフルコマンド名を使用し、略称を注記します。
2.5. 永続的なデータベースが組み込み
キャレット(^)で始まる任意の変数はグローバル変数です。これはディスク上に永続的に保存され、プロセス終了後も存続し、すべてのユーザー間で共有されます。キャレットのない変数はローカル変数です。これらは現在のプロセスのメモリ内にのみ存在し、プロセス終了時に消滅します。グローバル変数とローカル変数は、サブスクリプト、代入、削除にまったく同じ構文を使用します。
3. 変数とデータ型
3.1. ローカル変数
ローカル変数名は、文字または%で始まり、その後に文字と数字が続きます。
>SET NAME="Alice"
>SET AGE=30
>SET %TEMP=98.6
>WRITE NAME," is ",AGE," years old.",!
Alice is 30 years old.
変数名はケースセンシティブです:Name、NAME、nameはすべて異なる変数です。
| 注 | 1976年標準では、移植可能なルーチン名とラベルは8文字の有効な文字(ルーチン名は大文字のみ)に制限されていますが、ローカル変数名は同じname構文に従います:文字または%の後に英数字が続きます。 |
3.2. サブスクリプト付き変数
任意の変数にサブスクリプトを付けることができ、階層ツリーを形成します。
>SET PATIENT("NAME")="Smith, John"
>SET PATIENT("AGE")=45
>SET PATIENT("LAB",1)="Glucose: 95"
>SET PATIENT("LAB",2)="Cholesterol: 210"
サブスクリプトのない変数とそのサブスクリプト付き形式は、独立して共存します。PATIENTは値を保持でき、PATIENT("NAME")は異なる値を保持できます。これらは同じツリー内の別々のノードです。
| 注 | 1976年標準では、任意の式をサブスクリプトとして許可しますが、移植性要件(NBS 118のパートIII)では、移植可能なプログラムを非負整数サブスクリプトに制限しています。上記の"NAME"のような文字列サブスクリプトはほとんどの実装で受け入れられますが、移植性はありません。$NEXT(標準の走査関数)は整数サブスクリプトのみで動作します。読みやすさのためにいくつかのデータモデル例で文字列サブスクリプトを使用しますが、$NEXT走査が必要な場合は整数サブスクリプトを使用します。 |
3.3. 文字列、数値、自動変換
MUMPSのすべての値は文字列です。算術演算子が適用されると、MUMPSは文字列の数値解釈を取ります。左から右にスキャンし、有効な数値のように見える部分をすべて消費し、それを使用します。残りは無視されます。
>WRITE +"123ABC"
123
>WRITE +"ABC"
0
>WRITE +"3.14 is pi"
3.14
>WRITE +""
0
単項+は数値解釈を強制します。これは、他の言語が「型変換」と呼ぶものをMUMPSが処理する方法です。数値コンテキストが必要な場合は、自動的に発生します。
数値には正規化された形式があります。先頭にゼロがない(0自体を除く)、小数点以下の末尾ゼロがない、不要な小数点がない。文字列"007.10"の数値解釈は7.1です。
3.4. 真偽値
MUMPSでは、偽に0、真に1を使用します。任意の文字列の真偽値解釈は次のとおりです。数値解釈を取り、結果が0の場合は真偽値は0、それ以外の場合は1です。
>WRITE '0
1
>WRITE '1
0
>WRITE '"ABC"'
1
アポストロフィ(')はNOT演算子です。"ABC"の数値解釈は0なので、'"ABC"は1を返します。これは驚くかもしれませんが、完全に一貫しています。
4. 式と演算子
4.1. 厳密な左から右への評価
これは最も重要なルールです。すべての二項演算子は同じ優先順位レベルを持ち、左から右に評価されます。括弧のみが評価順序を変更できます。
>WRITE 2+3*4
20
>WRITE 2+(3*4)
14
>WRITE 10-2-3
5
>WRITE 1+2_"ABC"
3ABC
最後の例では、1+2は3になり、次に3_"ABC"が連結されて"3ABC"が生成されます。アンダースコア_は文字列連結演算子です。
4.2. 算術演算子
| 演算子 | 意味 | 例 | 結果 |
|---|---|---|---|
+ | 加算 | 3+4 | 7 |
- | 減算 | 10-3 | 7 |
* | 乗算 | 6*7 | 42 |
/ | 除算 | 7/2 | 3.5 |
\ | 整数除算 | 7\2 | 3 |
# | モジュロ | 7#3 | 1 |
整数除算(\)は負の無限大方向に切り捨てます(床関数を計算します)。モジュロはA#B = A-(B*floor(A/B))と定義されます。
4.3. 単項演算子
| 演算子 | 意味 | 例 | 結果 |
|---|---|---|---|
+ | 数値解釈 | "42ABC" | 42 |
- | 符号反転 | -3 | -3 |
' | 論理NOT | '0 | 1 |
単項演算子は二項演算子よりも結合度が高く、右から左に適用されます:'-3はまず符号を反転し(-3)、次にその真偽値解釈(0以外なので1)を取り、最後に反転します(0)。
4.4. 関係演算子
すべての関係演算子は0または1を返します。
| 演算子 | 意味 | 例 | 結果 |
|---|---|---|---|
= | 文字列等価 | "AB"="AB" | 1 |
< | 数値未満 | 3<10 | 1 |
> | 数値より大きい | 10>3 | 1 |
] | 文字列後続 (ASCII順) | "B"]"A" | 1 |
[ | 文字列包含 | "ABCDE"["CD" | 1 |
? | パターンマッチ | "ABC"?3A | 1 |
これらのそれぞれは、先行するアポストロフィで否定できます:'=は「等しくない」、'<は「未満でない」(つまり、以上)、'>は「より大きくない」(つまり、以下)、']は「後続しない」、'[は「含まない」、'?'は「パターンに一致しない」を意味します。
後続演算子(])は、ASCII照合順序を使用します。これはASCIIコードに基づいた文字ごとの比較です。数値比較ではありません。"9"]"10"は、ASCIIで"9"が"1"より後にあるため真です。数値比較には<と>を使用してください。
包含演算子([)は、右オペランドが左オペランドの部分文字列であるかどうかをテストします。空文字列はすべての文字列に含まれます。
4.5. 論理演算子
| 演算子 | 意味 | 例 | 結果 |
|---|---|---|---|
& | AND | 1&1 | 1 |
! | OR | 0!1 | 1 |
否定形:'&はNAND、'!はNORです。
ショートサーキット評価はないことに注意してください。両辺は常に評価されます。すべての演算子は同じ優先順位を共有するため、A=1!B=2は((A=1)!B)=2と解析されますが、これはおそらく意図したものではないでしょう。括弧を使用してください:(A=1)!(B=2)。
4.6. 文字列連結演算子
アンダースコア(_)は2つの文字列を連結します。
>SET FIRST="John"
>SET LAST="Smith"
>WRITE FIRST_" "_LAST
John Smith
4.7. パターンマッチ
?演算子は、文字列がパターンに一致するかどうかをテストします。パターンはパターン原子から構築され、それぞれがカウント(または「任意の数」の場合は.)とコードまたは文字列リテラルの組み合わせで構成されます。
| コード | 意味 | 文字 |
|---|---|---|
A | アルファベット | A-Z, a-z |
N | 数値 | 0-9 |
U | 大文字 | A-Z |
L | 小文字 | a-z |
P | 句読点 | スペースを含む |
C | 制御文字 | DELを含む |
E | すべて | すべての128ASCII文字 |
コードは組み合わせることができます。1ANは「アルファベットまたは数値の1文字」を意味します。
例:
>WRITE "ABC"?3A
1
>WRITE "AB3"?3A
0
>WRITE "AB3"?2A1N
1
>WRITE "Hello"?1U.AL
1
>WRITE "12345"?.N
1
>WRITE "TEST-1"?1.A1"-"1.N
1
最後の例は、「1文字以上のアルファベット、次にリテラルハイフン、次に1文字以上の数値」と読みます。
5. コマンド
5.1. SET – 値の代入
SET(略称:S)は、1つ以上の変数に値を代入します。
>SET X=42
>SET NAME="Alice",AGE=30
>SET (A,B,C)=0
3番目の形式は複数SETです:括弧内のすべての変数が同じ値を受け取ります。
右辺は最初に評価される式であり、その結果が名前付き変数に格納されます。左辺のサブスクリプト式は、右辺の式が評価される前に評価されます。
>SET I=3
>SET A(I)=I*10
>WRITE A(3)
30
5.2. WRITE – データ出力
WRITE(略称:W)は、現在のデバイスに出力を送信します。
>WRITE "Hello"
Hello
>WRITE 2+2
4
>WRITE !,"Name: ",NAME,!
Name: Alice
WRITEは、カンマで区切られたいくつかの引数形式を受け入れます。
-
式: その文字列値を表示します。
-
フォーマットコード:
!は改行(キャリッジリターン+ラインフィード)を出力します。#はフォームフィード(画面クリアまたはページ開始)を出力します。?nは列nにタブします(列番号は0から始まります)。 -
*n: ASCIIコードがnの文字を出力します。
これらは自由に混在させることができます。
>WRITE #,!,"Report",!,"=====",!!
>WRITE ?10,"Column 10",?30,"Column 30",!
>WRITE *7
最後の例は、ベル文字(ASCII 7)を出力します。これは端末のベルを鳴らす可能性があります。
5.3. READ – データ入力
READ(略称:R)は、現在のデバイスから入力を読み取ります。
>READ "Enter your name: ",NAME
Enter your name: Alice
>WRITE "Hello, ",NAME,!
Hello, Alice
READは、WRITEと同じフォーマットコードと文字列リテラル引数を受け取ります(これらはプロンプトとして端末に出力されます)。それに加えて、入力を受け取る変数引数があります。入力は、ユーザーがEnterキーを押すと終了します(正確な終了手順は実装定義です)。
READはタイムアウトもサポートしています。
>READ "Answer? ",X:10
これは最大10秒間入力を待ちます。ユーザーが時間内に応答した場合、特殊変数$TESTは1に設定されます。タイムアウトした場合、$TESTは0に設定され、Xには受信した部分的な入力(空文字列の可能性あり)が含まれます。
1文字を読み取り、そのASCIIコードを返す特別な形式もあります。
>READ *X
ユーザーがAと入力した後、Xの値は65になります。
5.4. IF および ELSE – 条件付き実行
IF(略称:I)は、現在の行の残りの部分を条件付きで実行します。
>SET X=5
>IF X>3 WRITE "X is greater than 3",!
条件が偽の場合、その行の右側にあるすべてがスキップされます。ブロック構造(波括弧やendifなど)はありません。IFのスコープは常に現在の行の末尾までです。
ELSE(略称:E)は、直前のIF(またはタイムアウトしたコマンド)が$TESTを0に設定した場合に、行の残りの部分を実行します。
>SET X=2
>IF X>3 WRITE "big",!
>ELSE WRITE "small",!
small
| 注 | ELSEには引数がありません – ELSEとWRITEの間の2つのスペースに注意してください。引数のないコマンドは、次のコマンド(または行末)の前に2つのスペースが必要です。 |
IFは複数の引数をカンマで区切って取ることができます。これらはANDの連鎖のように機能します – いずれかの条件が偽の場合、残りの行はスキップされます。
>IF X>0,X<100 WRITE "X is between 1 and 99",!
これはIF X>0 IF X<100 WRITE …またはIF (X>0)&(X<100) WRITE …と同等です。ただし、カンマ形式には微妙な利点があります。最初の条件が偽の場合、2番目は決して評価されないため、潜在的な副作用を回避できます。
5.5. 後置条件
ELSE、FOR、IFを除く任意のコマンドは、コマンドワードの直後にコロンと条件を付けて後置条件にすることができます。
>SET X=5
>WRITE:X>3 "X is big",!
X is big
>SET:X=5 X=0
>WRITE X
0
後置条件は$TESTに影響しません。これがIFとの主な違いです。
DO、GOTO、XECUTEの引数も個別に後置条件を付けることができます。
>DO SUB1:X=1,SUB2:X=2,SUB3
これは、X=1の場合のみSUB1を、X=2の場合のみSUB2を、そしてSUB3を無条件に呼び出します。
5.6. FOR – 反復処理
FOR(略称:F)は、現在の行の残りの部分(そのスコープ)の繰り返し実行を制御します。IFと同様に、FORのスコープは行の末尾までです。
FORはループ変数と1つ以上のforパラメータをカンマで区切って取ります。
5.6.1. 単一値
>FOR I=5 WRITE I," "
5
スコープをIを5に設定して1回実行します。
5.6.2. 開始、ステップ(無限ループ)
>FOR I=1:1 WRITE I," " QUIT:I>5
1 2 3 4 5
FOR I=1:1は「1から開始し、1ずつ増分し、無限に」を意味します。QUITまたはGOTOで明示的に終了する必要があります。
5.6.3. 開始、ステップ、停止
>FOR I=1:1:5 WRITE I," "
1 2 3 4 5
FOR I=1:1:5は「1から開始し、1ずつステップし、Iが5を超えたら停止」を意味します。ステップは負にすることもできます。
>FOR I=10:-2:0 WRITE I," "
10 8 6 4 2 0
5.6.4. 複数パラメータ
FORパラメータは混在させることができます。
>FOR I=1:1:3,10,20:5:30 WRITE I," "
1 2 3 10 20 25 30
パラメータは左から右に処理され、それぞれがスコープの連続する実行を制御します。
5.6.5. ネストされたFOR
同じ行の複数のFORはネストされ、最も右のものが最も内側になります。
>FOR I=1:1:2 FOR J=1:1:3 WRITE I,"@",J," "
1@1 1@2 1@3 2@1 2@2 2@3
5.6.6. FORの終了
FORのスコープ内のQUITは、最も内側のFORを終了させます。
>FOR I=1:1:100 QUIT:I>3 WRITE I," "
1 2 3
QUIT:I>3がWRITEの前にあることに注意してください – 行の順序が重要です。WRITEが先に来た場合、ループは各イテレーションのWRITE後にのみ終了するため、1から100までの数値が出力されます。
FORのスコープ内のGOTOは、その行のすべてのFORを終了させ、指定されたラベルに制御を転送します。
5.7. DO – サブルーチン呼び出し
DO(略称:D)はサブルーチンを呼び出します。MUMPSでは、「サブルーチン」は単にルーチン内のラベルです。QUIT(FORのスコープ外)またはルーチン終了に達するまで、ラベル付き行で実行が続行され、その後、DOの後のコマンドに戻ります。
このルーチンを考えてみましょう。
MAIN SET X=10
DO DOUBLE
WRITE "Result: ",X,!
HALT
DOUBLE SET X=X*2
QUIT
DO MAINを実行する(またはMAINからルーチンを実行する)と、Result: 20と表示されます。
MUMPSはキャレット表記を使用して他のルーチンを呼び出すことができます。
>DO ^MYROUTINE
>DO LABEL^OTHERROUTINE
>DO LABEL+2^ROUTINE
最後の形式は、「ROUTINEのLABELから2行後を開始」を意味します。
| 注 | 移植性要件(NBS 118のパートIII)では、名前の最初の8文字のみが一意に区別され、移植可能な名前は大文字のみを使用すると規定しています。より長い名前は言語によって許可されますが、一部の実装では衝突する可能性があります。 |
DOの引数はリスト形式で指定でき、それぞれが順番に呼び出されます。
>DO SUB1,SUB2,^EXTERNAL
そして、各引数は後置条件を付けることができます。
>DO PRINTA:X=1,PRINTB:X=2,PRINTC
5.8. GOTO – 制御転送
GOTO(略称:G)は、別の行に制御を転送します。DOとは異なり、GOTOは戻りません。現在の実行ポイントを置き換えます。
>GOTO LABEL
>GOTO LABEL^ROUTINE
>GOTO LABEL+3^ROUTINE
GOTOがFORのスコープ内で実行されると、その行のすべてのFORが終了します。
DOと同様に、GOTOの引数もリスト形式で指定し、後置条件を付けることができます。
>GOTO A:X=1,B:X=2,C
最大1つの引数が実際に制御を転送します。それは、条件(存在する場合)が真である最初のものです。
5.9. QUIT – サブルーチンからの復帰またはFORの終了
QUIT(略称:Q)には、コンテキストに応じて2つの動作があります。
-
FORスコープ外: 現在のサブルーチン(DOまたはXECUTE)から復帰します。ルーチンスタックが空の場合、プロセスは終了します(HALTと同等)。
-
FORスコープ内: 最も内側のFORループを終了させます。
QUITは引数を取らず、後置条件を付けることができます。
>QUIT:X>100
5.10. HALT および HANG
HALT(略称:H、引数なし)は、現在のプロセスを終了させます。
HANG(略称:H、引数あり)は、指定された秒数だけ実行を一時停止します。
>HANG 5
この2つのコマンドは略称Hを共有します – 引数の有無が区別します:HのみはHALT、H 3はHANG 3です。
5.11. XECUTE – 文字列をコードとして実行
XECUTE(略称:X)は、式を評価し、その文字列値を1行のMUMPSサブルーチンとして実行します。
>SET CMD="WRITE ""Hello from XECUTE""",!
>XECUTE CMD
Hello from XECUTE
文字列リテラルの内側の二重引用符に注意してください – 各""は、文字列の値内で単一の"を表します。
XECUTEは一時的なサブルーチンコンテキストを作成するため、実行された文字列内のQUITは、XECUTEを含む行ではなく、XECUTEの後のコマンドに戻ります。
>XECUTE "SET X=1 QUIT:X=1 WRITE ""not reached"""
>WRITE X
1
XECUTEは他の言語のeval()に対応するものです。強力ですが、慎重に使用する必要があります。
5.12. KILL – 変数の削除
KILL(略称:K)は、変数とそのサブツリーをストレージから削除します。3つの形式があります。
5.12.1. 引数なしKILL(すべて削除)
>KILL
すべてのローカル変数を削除します。
5.12.2. 選択的KILL
>KILL X
>KILL ^PATIENT(12345)
>KILL X,Y,^A(3,4)
指定された変数値とそのすべての下位ノードを削除します。
5.12.3. 排他的KILL
>KILL (A,B)
AとB(およびそれらの下位ノード)を除くすべてのローカル変数を削除します。括弧内の変数は保持され、それ以外はすべて削除されます。
5.13. BREAK
BREAK(略称:B、引数なし)は、環境からのシグナル(通常はキープレス)まで実行を一時停止します。主にデバッグツールとして使用されます。
>BREAK
6. 文字列関数
MUMPSは、それぞれ$で始まる組み込み関数のセットを提供し、括弧付きの引数リストを受け取ります。関数名は、$と名前の最初の文字に省略できます:$EXTRACTと$Eは同じ関数です。
6.1. $LENGTH – 文字列長
$LENGTH(expr)は、exprの値の文字数を返します。空文字列の長さは0です。
>WRITE $LENGTH("Hello")
5
>WRITE $L("")
0
6.2. $EXTRACT – 位置による部分文字列
$EXTRACT(string,from)は、位置from(1ベース)の単一文字を返します。$EXTRACT(string,from,to)は、位置fromからtoまでの部分文字列を返します。
>SET X="ABCDE"
>WRITE $EXTRACT(X,1)
A
>WRITE $E(X,2,4)
BCD
>WRITE $E(X,3,99)
CDE
位置が範囲外の場合、$EXTRACTは空文字列を返します。「インデックス範囲外」のエラーはありません。
6.3. $PIECE – 区切り文字による部分文字列
$PIECE(string,delimiter,n)は、delimiterで分割されたstringのn番目の部分を返します。オプションの4番目の引数は、部分文字列の範囲を返します。
>SET REC="Smith^John^45^M"
>WRITE $PIECE(REC,"^",1)
Smith
>WRITE $P(REC,"^",2)
John
>WRITE $P(REC,"^",3)
45
>WRITE $P(REC,"^",2,3)
John^45
$PIECEはMUMPSプログラミングで最も頻繁に使用される関数の1つです。区切り文字付き文字列は、単一の値内に構造化データを格納する標準的な方法です。これは、軽量レコードフォーマットと実質的に同等です。
6.4. $FIND – 部分文字列の検索
$FIND(string,target)は、string内でtargetを検索します。見つかった場合、一致の最後の文字の後の文字の位置を返します。見つからない場合は0を返します。オプションの3番目の引数は開始位置を指定します。
>SET X="ABCABC"
>WRITE $FIND(X,"BC")
4
>WRITE $F(X,"BC",4)
7
>WRITE $F(X,"XY")
0
戻り値は一致の後の位置であり、連鎖に便利です。次の検索の開始位置として結果を直接渡すことができます。
6.5. $JUSTIFY – 数値の右寄せとフォーマット
$JUSTIFY(expr,width)は、exprの値をwidth文字のフィールドに右寄せし、左側をスペースで埋めます。
$JUSTIFY(number,width,decimals)は、さらに数値をdecimals桁に丸めます。
>WRITE $JUSTIFY("Hi",10)
Hi
>WRITE $JUSTIFY(3.14159,10,2)
3.14
>WRITE $J(100,6,2)
100.00
これはMUMPSにおけるフォーマットされた数値出力の主要なツールです。
6.6. $ASCII および $CHAR – 文字コード変換
$ASCII(string)は、stringの最初の文字のASCIIコードを返します(文字列が空の場合は-1)。オプションの2番目の引数は別の位置を選択します。
$CHAR(code1,code2,…)は、指定されたASCIIコードから構築された文字列を返します。負のコードは文字を生成しません。
>WRITE $ASCII("A")
65
>WRITE $A("Hello",2)
101
>WRITE $CHAR(72,101,108,108,111)
Hello
>WRITE $C(65,66,67)
ABC
6.7. $RANDOM – 乱数
$RANDOM(n)は、0からn
-1の範囲の疑似乱整数を返します。
>WRITE $RANDOM(10)
7
>WRITE $R(100)
42
引数は正の整数である必要があります。
6.8. $SELECT – 条件式
$SELECT(cond1:val1,cond2:val2,…,1:default)は、条件を左から右に評価し、最初に真になった条件に対応する値を返します。どの条件も真にならない場合はエラーになるため、慣例的なイディオムは1:defaultで終わることです(1は常に真であるため)。
>SET X=2
>WRITE $SELECT(X=1:"one",X=2:"two",X=3:"three",1:"other")
two
$SELECTはMUMPSの条件付き(三項)演算子に相当します。
6.9. $TEXT – ソース行の取得
$TEXT(label)は、現在のルーチン内の指定されたラベルを持つ行のソーステキストを返します。$TEXT(label+n)は、そのラベルからn行後の行を返します。$TEXT(+n)は、ルーチンのn行目を返します。
>WRITE $TEXT(MAIN)
MAIN SET X=10
行が存在しない場合、$TEXTは空文字列を返します。
7. グローバルデータベース
これがMUMPSをユニークにしている機能です。言語自体に組み込まれた、階層的で永続的で共有可能なデータベースです。
7.1. グローバル変数
キャレット(^)で始まる任意の変数はグローバル変数です。グローバルは以下の特徴を持ちます。
-
永続性: プロセス終了後も存続します。グローバルをSETすると、ディスクに書き込まれます。
-
共有性: すべてのプロセスが同じグローバルを参照・変更できます(マルチユーザーシステムの場合)。
-
階層性: ローカル変数と同様に、グローバルは任意の数のサブスクリプトを持つことができ、ツリー構造を形成します。
>SET ^COLOR(1)="Red"
>SET ^COLOR(2)="Green"
>SET ^COLOR(3)="Blue"
>HALT
インタプリタを再起動した後:
>WRITE ^COLOR(2)
Green
データはまだ存在します。保存コマンド、ファイルI/O、シリアライゼーションは不要です。変数がデータベースそのものです。
7.2. データモデルの構築
ここに小さな患者登録簿を示します。これは純粋にグローバル変数で構築されています。
>SET ^PAT(1,"NAME")="Smith, John"
>SET ^PAT(1,"DOB")="1945-03-15"
>SET ^PAT(1,"LAB",1,"DATE")="1976-01-10"
>SET ^PAT(1,"LAB",1,"TEST")="Glucose"
>SET ^PAT(1,"LAB",1,"RESULT")=95
>SET ^PAT(2,"NAME")="Doe, Jane"
>SET ^PAT(2,"DOB")="1960-07-22"
これは以下のようなツリーを作成します。
^PAT
+-- 1
| +-- "NAME" = "Smith, John"
| +-- "DOB" = "1945-03-15"
| +-- "LAB"
| +-- 1
| +-- "DATE" = "1976-01-10"
| +-- "TEST" = "Glucose"
| +-- "RESULT" = 95
+-- 2
+-- "NAME" = "Doe, Jane"
+-- "DOB" = "1960-07-22"
スキーマは定義されていません。テーブルは作成されていません。構造はSETコマンドのパターンから単純に現れました。
7.3. $DATA – ノードの存在テスト
$DATA(variable)は、ノードの状態を記述する整数を返します。
| 値 | 意味 |
|---|---|
0 | ノードが存在しない |
1 | ノードが存在し、値を持つが、子ノードはない |
10 | ノードが存在し、子ノードを持つが、それ自体の値はない |
11 | ノードが存在し、値と子ノードの両方を持つ |
>WRITE $DATA(^PAT)
10
>WRITE $D(^PAT(1,"NAME"))
1
>WRITE $D(^PAT(1,"LAB"))
10
>WRITE $D(^PAT(99))
0
一般的なイディオムは、変数を使用する前にその定義を確認することです。
>IF $DATA(^PAT(1)) WRITE "Patient 1 exists",!
Patient 1 exists
7.4. $NEXT – ツリーの走査
$NEXT(variable(subscript))は、同じレベルの次のサブスクリプト値を昇順の数値順で返します。次の値がない場合は、-1を返します。
| 注 | 1976年標準では、移植性のためにサブスクリプトは非負整数に制限されています。$NEXTは整数サブスクリプトで動作します。後続の標準では文字列サブスクリプト走査のために$ORDERが追加されました。 |
すべての患者を反復処理するには:
>SET ID=0
>FOR J=1:1 SET ID=$NEXT(^PAT(ID)) QUIT:ID=-1 WRITE ID,": ",^PAT(ID,"NAME"),!
1: Smith, John
2: Doe, Jane
ループ変数Jは使い捨てのカウンターです。重要なのは、IDを次のサブスクリプトに進める$NEXT呼び出しです。エントリがなくなると、$NEXTは-1を返し、後置条件付きQUITがループを終了させます。
このパターン – FORと$NEXT、そして-1でのQUIT – は、1976年時代のMUMPSにおける基本的なデータベース走査イディオムです。
7.5. ネイキッドリファレンス
サブスクリプト付きグローバルにアクセスした後、MUMPSは「ネイキッドインジケータ」と呼ばれる隠しレジスタに親ノードへの「パス」を記憶します。^(subscript)の形式のその後の参照は、この記憶されたパスに対して解釈されます。
>SET X=^PAT(1,"NAME")
この後、ネイキッドインジケータは^PAT(1)を保持します。ネイキッドリファレンス^("DOB")は^PAT(1,"DOB")と同等になります。
ネイキッドリファレンスは、文字が重要だった時代(行は255文字に制限されていました)に重要だったコンパクトな表記法です。実際には、コードの可読性を低下させ、微妙なバグの一般的な原因となります。ここでは完全性のために言及しますが、新しいコードでは明示的な変数参照を使用することをお勧めします。
7.6. グローバル変数に対するKILL
KILLは、グローバル変数に対してローカル変数と同様に機能します。
>KILL ^PAT(1,"LAB")
これは"LAB"ノードとそのサブツリー(患者1のラボ記録)を削除します。親ノード^PAT(1)には影響しません。
>KILL ^PAT
これは患者データベース全体を削除します。
8. 入出力
8.1. 出力フォーマット
WRITE(およびREAD)のフォーマットコードは、現在のデバイスでの出力位置を制御します。
| コード | 効果 |
|---|---|
! | 改行(キャリッジリターン+ラインフィード)。$Xを0に設定し、$Yを1増やします。 |
# | フォームフィード(改ページ/画面クリア)。$Xと$Yの両方を0に設定します。 |
?n | 列nにタブします。カーソルが既に列n以降にある場合、効果はありません。それ以外の場合は、列nに到達するまでスペースが出力されます。列番号は0から始まります。 |
例 – フォーマットされたレポート:
>WRITE #,!,"Patient Report",!
>WRITE "=============",!!
>SET ID=0
>FOR J=1:1 SET ID=$NEXT(^PAT(ID)) QUIT:ID=-1 DO SHOW
>HALT
SHOW WRITE "ID: ",ID,?15,"Name: ",^PAT(ID,"NAME"),!
QUIT
8.2. 特殊変数 $X および $Y
$Xは現在のデバイスでの現在の水平カーソル位置(列番号)を追跡します。$Yは現在の垂直位置(行番号)を追跡します。どちらも文字が出力されると自動的に更新されます。
>WRITE "123" SET Y=$X
この後、Yは3になります(3文字が出力されました)。
一般的な行折り返しイディオム:
>IF $X>72 WRITE !
8.3. デバイスI/O (概要)
OPEN、USE、CLOSEコマンドはI/Oデバイスを管理します。
-
OPEN device: デバイス(例:プリンター、ファイル)の所有権を取得します。 -
USE device: デバイスを現在のREADおよびWRITEのターゲットにします。 -
CLOSE device: 所有権を解放します。
特殊変数$IOは現在のデバイスの識別子を含みます。
単一ユーザーシステムでは、通常、端末がデフォルト(かつ唯一)のデバイスです。デバイス管理は、マルチユーザーまたはマルチデバイス構成で重要になりますが、これは後で議論します。
9. 間接参照
間接参照は、MUMPSの動的コード構築メカニズムです。@演算子は式を評価し、その値を周囲の構文に代入します。
9.1. 名前間接参照
>SET VARNAME="X"
>SET @VARNAME=42
>WRITE X
42
@VARNAMEはVARNAMEを評価し("X"を取得)、次に"X"を変数名として使用します。これはSET X=42と同等です。
9.2. サブスクリプト間接参照
>SET REF="^PAT(1,""NAME"")"
>WRITE @REF
Smith, John
9.3. 引数間接参照
それをサポートするコマンドの場合、間接参照は引数全体または引数リストを置き換えることができます。
>SET ARGS="X=1,Y=2,Z=3"
>SET @ARGS
>WRITE X," ",Y," ",Z
1 2 3
9.4. パターン間接参照
パターンさえ間接にすることができます。
>SET PAT="3N"
>WRITE "123"?@PAT
1
間接参照は強力ですが、コードの可読性とデバッグを困難にします。動的な動作が必要な場合(たとえば、変数名やコマンドが実行時に決定される場合)に使用してください。
10. 特殊変数
MUMPSは7つの組み込み特殊変数を提供しており、すべて$で始まります。これらは読み取り専用です(SETで設定することはできません)。
10.1. $HOROLOG – 日付と時刻
$HOROLOG(略称 $H)は、days,secondsの形式の文字列を返します。ここでdaysは1840年12月31日からの日数をカウントし(日0,0はその日の最初の秒)、secondsは深夜からの秒数をカウントします(0~86399)。
>WRITE $HOROLOG
67708,51301
有用な情報を抽出するには、$PIECEを使用します。
>SET H=$H
>SET DAYS=$PIECE(H,",",1)
>SET SECS=$PIECE(H,",",2)
>SET HOURS=SECS\3600
>SET MINS=SECS\60#60
>WRITE "Seconds since midnight: ",SECS,!
>WRITE "Time: ",HOURS,":",MINS,!
奇妙なエポック(1840-12-31)は、医療記録に現れる可能性のある日付よりも前であり、うるう年の計算で日付計算が便利になるため選択されました。
10.2. $IO – 現在のデバイス
$IO(略称 $I)は、USEまたはシステムデフォルトによって設定された現在のI/Oデバイスの識別子を返します。
10.3. $JOB – プロセス識別子
$JOB(略称 $J)は、現在のプロセスを一意に識別する正の整数を返します。この値はプロセスの存続期間中一定です。
一般的な用途は、プロセス固有の一時グローバルを作成することです。
>SET ^TEMP($JOB,"SCRATCH")="work in progress"
10.4. $STORAGE – 利用可能な領域
$STORAGE(略称 $S)は、利用可能な空き領域の文字数を示す整数を返します。その正確な意味は実装定義ですが、ローカル変数とルーチンコードに残っているスペースを測定します。
>IF $STORAGE<100 GOTO ^OVERFLOW
10.5. $TEST – 最後のテスト結果
$TEST(略称 $T)は、直前のIF(引数付き)またはタイムアウト付きのOPEN、LOCK、READによって設定された真偽値(0または1)を含みます。
>READ "Input: ",X:5
>IF $TEST WRITE "Got input: ",X,!
>ELSE WRITE "Timed out.",!
10.6. $X および $Y – カーソル位置
$Xと$Yは、I/Oセクションで説明されているように、現在のデバイスでの現在の水平および垂直カーソル位置を返します。
11. ルーチンとプログラム構造
11.1. ルーチン構造
MUMPSルーチンは、プログラムの保存と交換の単位です。これは行のシーケンスで構成され、各行は行末マーカーで終了します。ルーチン全体はルーチン終了マーカーで終了します。
交換フォーマットでは:
ROUTINENAME
LABEL1 command command ;comment
command command
LABEL2 command
QUIT
最初の行(ルーチンヘッド)にはルーチン名のみが含まれます。残りの行はルーチン本体を形成します。
11.2. 行とラベル
各行には、左マージンにオプションのラベル、それに続くスペース区切り文字(ls)、そしてゼロ個以上のコマンドがあります。
CALC SET X=A+B
WRITE "Result: ",X,!
QUIT
CALC行にはラベルがあります。次の2行にはラベルがありません(スペースで始まります)。ラベルはDO、GOTO、および$TEXTのターゲットとして使用されます。
ラベルは名前(CALCなど)または整数リテラル(1、42など)にすることができます。ラベルが整数の場合、先頭のゼロは重要です:ラベル01はラベル1とは異なります。
11.3. エントリ参照
DOとGOTOは、転送先を指定するためにエントリ参照を使用します。
| 形式 | 意味 |
|---|---|
DO LABEL | 現在のルーチンのLABELというラベルの行を呼び出す |
DO ^ROUTINE | ROUTINEの最初の行を呼び出す |
DO LABEL^ROUTINE | ROUTINEのLABELというラベルの行を呼び出す |
DO LABEL+3^ROUTINE | ROUTINEのLABELから3行後の行を呼び出す |
GOTOは同じ形式を使用しますが、呼び出しではなく制御を転送します。
11.4. コマンド略称
参考のために、コマンド略称の完全なリストを以下に示します。
| コマンド | 略称 |
|---|---|
| BREAK | B |
| CLOSE | C |
| DO | D |
| ELSE | E |
| FOR | F |
| GOTO | G |
| HALT | H (引数なし) |
| HANG | H (引数あり) |
| IF | I |
| KILL | K |
| LOCK | L |
| OPEN | O |
| QUIT | Q |
| READ | R |
| SET | S |
| USE | U |
| VIEW | V |
| WRITE | W |
| XECUTE | X |
他の略称は有効ではありません。GOTOのGO、WRITEのWRなどはすべてエラーです。
12. まとめ
ここでは、電話帳という、名前と電話番号をグローバル変数に格納し、ユーザーが検索、エントリの追加、およびすべての一覧表示を行える、小さくても完全なアプリケーションを構築しましょう。
データモデルは整数サブスクリプト(移植可能な$NEXT走査に必要)を使用し、各レコードは^で区切られた文字列として格納されます。別のグローバル^PHONECTが次の利用可能なIDを追跡します。
PHONE ; Phone directory application
WRITE #,!,"=== Phone Directory ===",!
MENU WRITE !,"Options: (A)dd (L)ookup (D)irectory (Q)uit",!
READ "Choice: ",CH QUIT:CH=""
IF CH="A"!(CH="a") DO ADD GOTO MENU
IF CH="L"!(CH="l") DO LOOKUP GOTO MENU
IF CH="D"!(CH="d") DO LIST GOTO MENU
IF CH="Q"!(CH="q") QUIT
WRITE "Invalid choice.",! GOTO MENU
;
ADD WRITE !,"Add new entry:",!
READ " Name: ",NAME QUIT:NAME=""
READ " Phone: ",NUM QUIT:NUM=""
IF '$DATA(^PHONECT) SET ^PHONECT=0
SET ^PHONECT=^PHONECT+1
SET ^PHONE(^PHONECT)=NAME_"^"_NUM
WRITE " Saved as entry ",^PHONECT,".",!
QUIT
;
LOOKUP WRITE !,"Look up entry:",!
READ " Name: ",NAME QUIT:NAME=""
SET ID=0,FOUND=0
FOR I=1:1 SET ID=$NEXT(^PHONE(ID)) QUIT:ID=-1 IF $PIECE(^PHONE(ID),"^",1)=NAME SET FOUND=1 QUIT
IF FOUND WRITE " Phone: ",$PIECE(^PHONE(ID),"^",2),!
ELSE WRITE " Not found.",!
QUIT
;
LIST WRITE !,"All entries:",!
SET ID=0
FOR I=1:1 SET ID=$NEXT(^PHONE(ID)) QUIT:ID=-1 DO SHOW
QUIT
;
SHOW WRITE " ",$PIECE(^PHONE(ID),"^",1),?25,$PIECE(^PHONE(ID),"^",2),!
QUIT
この小さなプログラムは、このチュートリアルでカバーされたほとんどの機能を示しています。
-
永続ストレージのためのグローバル変数(
^PHONE、^PHONECT) -
データベース走査のための
$NEXT付き整数サブスクリプト -
区切り文字付きレコードからのフィールド抽出のための
$PIECE -
プロンプト付きのユーザー入力のためのREAD
-
分岐のためのIF/ELSE
-
サブルーチン呼び出しのためのDO
-
メニューに戻るためのGOTO
-
変数が存在するかどうかのテストのための$DATA
-
早い終了のための後置条件(
QUIT:NAME="") -
出力フォーマットのためのフォーマットコード(
!、#、?25)
データはセッション間で永続します。エントリを追加し、終了し、インタプリタを再起動すると、エントリはまだ存在します。グローバルはデータベースだからです。
| 注 | 電話帳は各レコードを^で区切られた文字列(例:「Smith, John^555-1234」)として格納し、$PIECEでフィールドを抽出します。これは歴史的に本物です。当時の本番MUMPSシステム、特にVAのDHCP/VistAは、ほぼすべてのデータを^で区切られた文字列として格納し、$PIECEでアクセスしていました。この設計は、レコード全体を単一のグローバルノードにパックし、フィールドごとに1つのBツリー検索で済みます。当時のハードウェアでは、ディスクベースのBツリー走査を最小限に抑えることが不可欠でした。代替の1976年準拠設計では、各フィールドに整数サブスクリプトを使用します(例:名前の場合は^PHONE(1,1)、番号の場合は^PHONE(1,2))が、フィールドごとに追加のBツリー検索が必要になります。 |
13. コマンドリファレンス
このセクションでは、1976年標準で定義されたすべての19コマンドの簡潔なリファレンスを提供します。各エントリは、フル構文、略称、および主要な動作をリストします。チュートリアルスタイルの説明と例については、前の章を参照してください。
13.1. BREAK
略称: B
構文: B[REAK][:tvexpr]
環境からのシグナル(通常はキープレス)まで実行を一時停止します。引数構文(存在する場合)は実装定義です。BREAKには後置条件を付けることができます。主にデバッグに使用されます。
13.2. CLOSE
略称: C
構文: C[LOSE][:tvexpr] expr[:deviceparams][,…]
exprで識別されるデバイスの所有権を解放します。deviceparamsが存在する場合、それらは実装によって定義された形式で終了手順を指定します。閉じられたデバイスが現在のデバイスである場合、実装はデフォルトデバイスを暗黙的にOPENおよびUSEする可能性があります。
CLOSE 3
C 3:(parameters)
13.3. DO
略称: D
構文: D[O][:tvexpr] entryref[:tvexpr][,…]
サブルーチンを呼び出します。実行はentryrefで示される行で継続され、QUIT(FORスコープ外)またはルーチン終了まで実行され、その後DOの後のコマンドに戻ります。
entryrefは次のいずれかです:label、label+offset、^routine、label^routine、またはlabel+offset^routine。
コマンドと個々の引数の両方に後置条件を付けることができます。引数はリスト形式で指定できます。
引数なしのDO(2つのスペースまたは行末に続く)は、1976年標準では定義されていません。
DO CALC
D INIT,^SETUP,PROC^LIB
D PRINTA:X=1,PRINTB:X=2
13.4. ELSE
略称: E
構文: E[LSE] (引数なし。コマンドの後に2つのスペースがあることに注意)
$TESTが0の場合、行の残りを実行します。ELSEは引数を取らず、後置条件を付けることはできません。
ELSEはIF '$TESTと同等ですが、$TESTを変更しません。
IF X>3 WRITE "big",!
ELSE WRITE "small",!
13.5. FOR
略称: F
構文: F[OR] lvn=forparam[,forparam…]
FORには後置条件を付けることはできません。そのスコープは現在の行の残りの部分です。
各forparamは次の3つの形式のいずれかを取ります。
-
expr– exprの値でlvnを設定してスコープを1回実行します。 -
expr1:expr2– expr1から開始し、各イテレーションでexpr2をインクリメントし、無限にループします(QUITまたはGOTOで終了)。この2パラメータ形式は、オープンエンドループを作成する標準的な方法です。 -
expr1:expr2:expr3– expr1から開始し、expr2でステップし、lvnがexpr3を超える(またはステップが負の場合はexpr3を下回る)ときに終了します。
複数のforparamは左から右に処理されます。
FOR I=1:1:10 WRITE I," "
F I=1:1 QUIT:I>5 WRITE I," "
FOR I=1,3,5,7:2:15 WRITE I," "
FOR I=1:1 READ XQUIT:X="" SET ^DATA(+X)=""
13.6. GOTO
略称: G
構文: G[OTO][:tvexpr] entryref[:tvexpr][,…]
entryrefで示される行に制御を転送します。DOとは異なり、GOTOはスタックをプッシュしません – 制御は戻りません。FORのスコープ内で実行されると、その行のすべてのFORが終了します。
コマンドと個々の引数の両方に後置条件を付けることができます。最大1つの引数が実際に実行されます(条件が真である最初のもの)。
GOTO LOOP
G A:X=1,B:X=2,C
G INIT^SETUP
13.7. HALT
略称: H(引数なし)
構文: H[ALT][:tvexpr]
現在のプロセスを終了させます。HALTは引数を取らず、引数の有無がHANGと区別する点です。
HALT
H
13.8. HANG
略称: H(引数あり)
構文: H[ANG][:tvexpr] numexpr[,…]
実行を指定された秒数だけ一時停止します。値が0または負の場合、一時停止はありません。引数はリスト形式で指定できます。
HANG 5
H 0.5,1,2
13.9. IF
略称: I
構文: I[F] tvexpr[,tvexpr…]
または引数なし:I[F](2つのスペース)
tvexprが真の場合、行の残りが実行されます。偽の場合、行の残りはスキップされ、$TESTは0に設定されます。
複数の引数(カンマ区切り)の場合、それぞれが左から右に評価されます。いずれかが偽の場合、残りの行はスキップされます。各真の引数は$TESTを1に設定し、最初の偽の引数は$TESTを0に設定します。
引数なしIFは$TESTをテストします:1であれば行は続行され、0であれば行はスキップされます。引数なしIFは$TESTを変更しません。
IFには後置条件を付けることはできません。
IF X>3 WRITE "big",!
I X>0,X<100 WRITE "in range",!
IF WRITE "previous test was true",!
13.10. KILL
略称: K
構文: K[ILL][:tvexpr] glvn[,…]
または排他的:K[ILL][:tvexpr] (lvn[,…])
または引数なし:K[ILL][:tvexpr]
-
選択的:
KILL XはXとそのすべての下位ノードを削除します。 -
排他的:
KILL (A,B)は、AとB(およびそれらの下位ノード)を除くすべてのローカル変数を削除します。排他的形式ではローカル変数名のみが許可されます。 -
引数なし:
KILLはすべてのローカル変数を削除します。
グローバル変数に対するKILL(KILL ^X)は、グローバルノードとそのサブツリー全体をディスクから削除します。
KILL X,Y,^A(3)
K (KEEP1,KEEP2)
K
13.11. LOCK
略称: L
構文: L[OCK][:tvexpr] nref[:timeout][,…]
または引数なし:L[OCK][:tvexpr]
LOCKは、名前付きリソースに対する勧告ロックを作成することにより、プロセス間協調を提供します。単一ユーザーシステムでは、LOCKは実質的な効果がありません。
引数なしLOCKは、プロセスが保持しているすべてのロックを解放します。
引数付きの場合、LOCKはまず現在保持されているすべてのロックを解放し、次に指定された順序で各名前付きロックの取得を試みます。タイムアウトが存在し、ロックが指定時間内に取得できない場合、$TESTは0に設定されます。
| 注 | LOCKはこのプライマーでは延期されます。マルチユーザー構成で関連性が出てきます。 |
13.12. OPEN
略称: O
構文: O[PEN][:tvexpr] expr[:deviceparams][:timeout][,…]
exprで識別されるデバイスの所有権を取得します。タイムアウトが存在し、デバイスが時間内に開けない場合、$TESTは0に設定されます。deviceparamsは、実装によって定義された形式でデバイス固有の初期化を指定します。
OPEN 3
O 3::10
13.13. QUIT
略称: Q
構文: Q[UIT][:tvexpr]
QUITは引数を取らず、コンテキストに応じて動作が異なります。
-
FORスコープ外: 現在のDOまたはXECUTEサブルーチン呼び出しから復帰します。ルーチンスタックが空の場合、プロセスは終了します。
-
FORスコープ内: 最も内側のFORループを終了させます。行にネストされたFORがある場合、最も内側のもののみが終了します。
QUITには後置条件を付けることができます。
QUIT
Q:X>100
13.14. READ
略称: R
構文: R[EAD][:tvexpr] readarg[,…]
各readargは次のいずれかです。
- `