System ライブラリ

• 概要 - Abstruct
• 目次 - Index
• 構造体 - Structs
• 変数 - Variables
• 関数 - Functions
• イベントハンドラ - Event Handler
• 実装コード

概要 - Abstract

VCSSL System ライブラリ は、一般的な用途において必須となるような基盤機能を提供する標準ライブラリです。

Systemライブラリは、実行対象のVCSSLプログラムを読み込むよりも先に、処理系によって自動で読み込まれます。このため System ライブラリは、特例的に import 不要で使用できます。

System ライブラリにおける具体的な機能の例としては、変数・配列に対する基本的な操作と変換、ユーザーとの入出力やファイル入出力、ファイルシステムとの単純なやり取り、オペレーティングシステムのコマンド実行などが挙げられます。これらの内のいくつかは、より高度かつ複雑な機能が、各分野に特化した標準ライブラリによっても提供されています。VCSSLにおける標準ライブラリの設計コンセプトでは、簡易用途では基本的に System ライブラリの機能を利用し、それでは機能不足が生じるような場合において、必要に応じて各種の特化したライブラリを import して利用するという使い方を想定しています。

System ライブラリでは、識別子の命名規則についても、他の標準ライブラリとはやや異なり、簡易用途における利便性を優先した、特例的なものとなっています。VCSSLの標準ライブラリにおける識別子の命名は、原則として、英単語を省略せずにロワーキャメルケースで綴る方針を採用しています。しかし System ライブラリにおいては、英単語を短縮してタイプ数を削り、必要に応じてプレフィックスやサフィックスで意味付けの補間をするような、略記的な識別子名称が多く採用されています。

目次 - Index

const string VER

処理系が対応する、VCSSLのバージョンコードを表します。

const string REV

処理系の開発リビジョンコードを表します。

const complex I

complex 型の虚数単位です。

const varcomplex VCI

varcomplex 型の虚数単位です。

const float INF

float 型の Inf （無限大） です。

const float NAN

float 型の NaN (非数) です。なお、NaN はあらゆる値と等しくありません。つまり、value == NAN といった比較で、変数 value が NaN であるかどうかを判定する事はできません。NaN の判定には nan 関数を使用してください。

const float FLOAT_MAX

float 型の最大値です。

const float FLOAT_MIN_ABS_NORMAL

正規化数の範囲内において、float 型で表現可能な、最も絶対値が小さい値（正の値、0 以外）です。

const float FLOAT_MIN_ABS_DENORMAL

非正規化数の範囲を含めて、float 型で表現可能な、最も絶対値が小さい値（正の値、0 以外）です。

const float FLOAT_MIN

FLOAT_MIN_ABS_DENORMAL と同様です。名称が短い代わりに、意味や仕様についてやや曖昧な名称であるため、基本的にはより明示的な名称の FLOAT_MIN_ABS_DENORMAL または FLOAT_MIN_ABS_NORMAL の使用が推奨されます。

const int INT_MAX

int 型の最大値です。

const int INT_MIN

int 型の最小値です。

const string EOL

環境依存の改行コードです。CR, LF, CR+LF などの中から、実行中の環境に適した値を保持しています。

const string CR

改行コード CR (0x0D) です。

const string LF

改行コード LF (0x0A) です。

const string READ

「読み込み」を行うファイル入出力モードです。open 関数で使用します。

const string WRITE

「書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string APPEND

「追記書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string READ_TSV

「TSV読み込み」を行うファイル入出力モードです。open 関数で使用します。

const string WRITE_TSV

「TSV書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string APPEND_TSV

「TSV追記書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string READ_CSV

「CSV読み込み」を行うファイル入出力モードです。open 関数で使用します。

const string WRITE_CSV

「CSV書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string APPEND_CSV

「CSV追記書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string READ_BINARY

「バイナリ読み込み」を行うファイル入出力モードです。open 関数で使用します。

const string WRITE_BINARY

「バイナリ書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string APPEND_BINARY

「バイナリ追記書き込み」を行うファイル入出力モードです。open 関数で使用します。

const string STDIN

標準入力に対してファイル入出力関数を使用するための、特別なファイルパスです。

const string STDOUT

標準出力に対してファイル入出力関数を使用するための、特別なファイルパスです。

const string STDERR

標準エラー出力に対してファイル入出力関数を使用するための、特別なファイルパスです。

const int UP

ゼロを基準とする小数点以下の部分( いわゆる Decimal part )の桁数を指定して、「 切り上げ 」を行う丸めモードです。round 関数で使用します。

const int UP_SIGNIF

有効数字の部分( いわゆる Significand part )の桁数を指定して、「 切り上げ 」を行う丸めモードです。round 関数で使用します。このモードは、VCSSL 3.3 以前において「 UP 」として試験導入されていたものです。

const int DOWN

ゼロを基準とする小数点以下の部分( いわゆる Decimal part )の桁数を指定して、「 切り下げ 」を行う丸めモードです。round 関数で使用します。

const int DOWN_SIGNIF

有効数字の部分( いわゆる Significand part )の桁数を指定として、「 切り下げ 」を行う丸めモードです。round 関数で使用します。このモードは、VCSSL 3.3 以前において「 DOWN 」として試験導入されていたものです。

const int HALF_UP

ゼロを基準とする小数点以下の部分( いわゆる Decimal part )の桁数を指定して、「 half up 丸め 」を行う丸めモードです。round 関数で使用します。

const int HALF_UP_SIGNIF

有効数字の部分( いわゆる Significand part )の桁数を指定として、「 half up 丸め 」を行う丸めモードです。round 関数で使用します。このモードは、VCSSL 3.3 以前において「 HALF_UP 」として試験導入されていたものです。

const int HALF_DOWN

ゼロを基準とする小数点以下の部分( いわゆる Decimal part )の桁数を指定して、「 half down 丸め 」を行う丸めモードです。round 関数で使用します。

const int HALF_DOWN_SIGNIF

有効数字の部分( いわゆる Significand part )の桁数を指定として、「 half down 丸め 」を行う丸めモードです。round 関数で使用します。このモードは、VCSSL 3.3 以前において「 HALF_DOWN 」として試験導入されていたものです。

const int HALF_TO_EVEN

ゼロを基準とする小数点以下の部分( いわゆる Decimal part )の桁数を指定して、「 half to even 丸め 」を行う丸めモードです。round 関数で使用します。

const int HALF_TO_EVEN_SIGNIF

有効数字の部分( いわゆる Significand part )の桁数を指定として、「 half to even 丸め 」を行う丸めモードです。round 関数で使用します。このモードは、VCSSL 3.3 以前において「 HALF_EVEN 」として試験導入されていたものです。

macro print(...)

コンソールに文字列を出力します。引数は任意型であり、自動的に文字列型に変換されます。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、空白区切りで出力されます。

macro println(...)

コンソールに文字列を出力し、改行します。引数は任意型であり、自動的に文字列型に変換されます。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、空白区切りで出力されます。

macro output(...)

プログラムの処理結果を表示するための領域に、文字列を出力します。引数は任意型であり、自動的に文字列型に変換されます。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、空白区切りで出力されます。

macro input(...)

ユーザーから、任意文字列の入力を受け付けます。引数は任意型であり、自動的に文字列型に変換され、入力項目のメッセージとして表示されます。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、改行区切りで出力されます。なお、最後の引数は、入力項目のデフォルト値として使用されます。

macro select(...)

ユーザに選択肢を提示し、選択された項目を取得します。引数は任意型であり、自動的に文字列型に変換され、選択肢として表示されます。

macro alert(...)

警告ウィンドウにメッセージを出力し、ユーザーがそれを了承するまで、プログラムの実行を待機します。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、改行区切りで出力されます。なお、警告の意図のないメッセージの出力には、VCSSL 3.4以降からほぼ同機能の pop 関数が利用できます。今後、alert は警告の意図があるメッセージに対して使用する事が推奨されます。

macro popup(...)

ポップアップウィンドウにメッセージを出力し、ユーザーがそれを了承するまで、プログラムの実行を待機します。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、改行区切りで出力されます。この関数は、現時点では alert 関数と全く同じ動作をしますが、警告の意図のないメッセージの出力に使用するため、VCSSL 3.4 から新たにサポートされたものです。alert と使い分ける事で、表示するメッセージが警告なのか通常のメッセージなのか、コード内で意図をはっきりさせる事ができます。将来的には、ウィンドウ上の表示アイコンなどが alert と違うものになる可能性もあります。

macro pop(...)

popup 関数と同じものです。この関数は、data.Stack ライブラリの pop 関数と同一名称であったため、どちらを呼び出しているかをコード上でわかりやすくしたい場合のため、後に同機能の popup 関数が追加されました。なお、Stack ライブラリの pop 関数は型パラメータを持っており、現在のVCSSLでは型パラメータの省略はできないため、この関数とシグネチャが競合する可能性は、少なくとも現時点ではありません。この関数は互換目的でサポートされており、今後も引き続き使用できますが、混乱をなるべく避けるため、特に事情がなければ今後は popup 関数を優先的に使用する事が推奨されます。

macro confirm(...)

メッセージを出力し、ユーザーに 了承 / 拒否 の二択を提示します。引数を複数指定した場合、それがどのような形で出力されるかは処理系依存です。恐らく通常は、改行区切りで出力されます。

string[ ] choose()

ユーザーにファイルを選択画面を提示し、選択されるまでプログラムの実行を待機します。

string[ ] choose(string message)

ユーザーにファイルを選択画面を提示し、選択されるまでプログラムの実行を待機します。

string[ ] choose(string message, string directory)

ユーザーにファイルを選択画面を提示し、選択されるまでプログラムの実行を待機します。

void beep()

ビープ音を鳴らします。ただし、実際に鳴らせるかどうかは環境に依存します。場合によっては、ビープ音でない音（オペレーティングシステムの警告音など）が鳴る事もあります。

void beep(int repeat)

ビープ音を鳴らします。ただし、実際に鳴らせるかどうかは環境に依存します。場合によっては、ビープ音でない音（オペレーティングシステムの警告音など）が鳴る事もあります。

void beep(int repeat, int wait)

ビープ音を鳴らします。ただし、実際に鳴らせるかどうかは環境に依存します。場合によっては、ビープ音でない音（オペレーティングシステムの警告音など）が鳴る事もあります。

void clear()

コンソールの内容をクリアします。ただし、この関数の挙動は処理系依存です。例えば、コンソールの内容が、処理系に付属したウィンドウに表示されるような場合においては、恐らく期待した通りの結果が得られます。しかし、コンソールウィンドウを持たない、標準入出力ベースの処理系においては、恐らく何も行われません。

void hide()

コンソールを非表示にします。ただし、この関数の挙動は処理系依存です。例えば、コンソールの内容が、処理系に付属したウィンドウに表示されるような場合においては、恐らく期待した通りの結果が得られます。しかし、コンソールウィンドウを持たない、標準入出力ベースの処理系においては、恐らく何も行われません。

void show()

コンソールが非表示にされている場合、表示します。ただし、この関数の挙動は処理系依存です。例えば、コンソールの内容が、処理系に付属したウィンドウに表示されるような場合においては、恐らく期待した通りの結果が得られます。しかし、コンソールウィンドウを持たない、標準入出力ベースの処理系においては、恐らく何も行われません。

int time()

プログラム実行開始からの経過時間を、ミリ秒単位で返します。

macro sleep(int milliSecond)

プログラムの実行を一時停止します。

void exit()

プログラムの実行を終了します。なお、この関数は、処理系にプログラムの終了をリクエストするものであり、必ずしも即時的に実行が終了される事が保証されるものではありません。この関数をコールするには、全てのループや分岐を抜けた後のプログラム最終行など、処理系がアイドリング状態となっているタイミングが理想的です。処理系が高速に処理を行っているタイミングでこの関数をコールすると、強制終了に近い状態となります。詳細は処理系の実装や最適化の方針などに依存しますが、処理系は、この関数がコールされた時点で、即時的に中断できないような一連の演算処理を行っている最中かもしれません。その場合はタイムラグが生じ、コール後も少しの間、実行が継続される場合があります。

void exit(int code)

終了ステータスコードを指定して、プログラムの実行を終了します。なお、この関数は、処理系にプログラムの終了をリクエストするものであり、必ずしも即時的に実行が終了される事が保証されるものではありません。この関数をコールするには、全てのループや分岐を抜けた後のプログラム最終行など、処理系がアイドリング状態となっているタイミングが理想的です。処理系が高速に処理を行っているタイミングでこの関数をコールすると、強制終了に近い状態となります。詳細は処理系の実装や最適化の方針などに依存しますが、処理系は、この関数がコールされた時点で、即時的に中断できないような一連の演算処理を行っている最中かもしれません。その場合はタイムラグが生じ、コール後も少しの間、実行が継続される場合があります。

void reset(string programName, string args[ ])

処理系をリセットし、別のプログラムを実行します。

macro error(...)

エラーメッセージを出力します。エラーメッセージ出力後、プログラムの実行が終了されるか、継続されるかは、処理系に依存します。確実に終了させたい場合は、続けて exit をコールしてください。

macro assert(bool expectedCondition)

式の値を評価し、真であれば何も行わず、偽であればエラーメッセージを出力します。プログラムの実行は恐らく終了されます。この関数はテストに使用します。

macro exec(...)

オペレーティングシステムのコマンド、または外部プログラムを、別プロセスで非同期で実行します。呼び出し元プログラムの実行は、処理の完了を待機しません。生成したプロセスと並列的に、実行を継続します。処理の実行を待機したり、標準入出力を制御したい場合は、Process ライブラリを使用してください。

macro system(...)

オペレーティングシステムのコマンド、または外部プログラムを、同期実行します。処理が完了するまで、呼び出し元プログラムの実行は待機します。

macro alloc(...)

配列の要素数を変更します。変更前後で、同じインデックスの要素は、同じ値に保たれます。

macro free(...)

配列の全次元の要素数を 0 にします。

bool exists(string filePath)

ファイルが存在するか確認します。

void mkdir(string directoryPath)

ディレクトリ（フォルダ）を新規生成します。ディレクトリが既に存在した場合は、何もしません。

bool isdir(string filePath)

ファイルがディレクトリかどうかを確認します。

string[ ] listdir(string directoryPath)

ディレクトリ内のファイル名一覧を返します。

macro rank(...)

配列の次元数を返します。例えば配列 a[11][28][32] に対して、rank(a) は 3 です。

macro length(...)

配列の要素数を返します。第二引数には、要素数を知りたい次元を、左から 0, 1, 2, ... と数えたインデックスを指定します。例えば配列 a[11][28][32] に対して、length(a, 0) は 11 であり、length(a, 1) は 28 であり、 length(a, 2) は 32 です。

bool nan( float value )

float 型の変数または値が、NaN (非数) かどうか判定します。

bool inf( float value )

float 型の変数または値が、Inf (無限大) かどうか判定します。

string bin( int number )

int 型の変数または値を、2進数で表した文字列を返します。先頭には 0b のプレフィックスが付加されます。

string oct( int number )

int 型の変数または値を、8進数で表した文字列を返します。先頭には 0 のプレフィックスが付加されます。

string hex( int number )

int 型の変数または値を、16進数で表した文字列を返します。先頭には 0x のプレフィックスが付加されます。

macro digit(arg)

varfloat 型または varcomplex 型の演算桁数を指定します。

macro digit()

varfloat 型または varcomplex 型の演算桁数を取得します。

float round(float value, int digit, int mode)

float型の値を、指定されたモードで、指定された桁数に丸めます。ただし、float型の値は、内部では2進数の浮動小数点数のデータとして保持されており、丸め処理は10進数基準で行われるため、2進/10進変換誤差についての留意が必要です。浮動小数点数の2進数と10進数の変換は、一般に有限の桁に収まらないケースがあり、微小な誤差が生じ得ます。そのため、float 値の内部データの値は、10進数ベースで想像している値とは僅かに食い違っている可能性があります。従って、対象値が丸め処理の切り上げ/切り下げの境界に非常に近い場合、一見すると奇妙な（しかし内部的には正しい処理の）結果となる場合があります。なお、float 値を文字列に変換したり print 関数で表示した結果と、この関数での丸め結果との対応が一見奇妙に思える場合もありますが、それは、前者においても内部で暗黙の丸め処理が行われるためです。もし、前者と同じ結果から、さらに追加で意図通り丸めた値が欲しい場合は、引数 value を string に変換した上で渡してください。

string round(string value, int digit, int mode)

string 型の値の内容を数値と見なして、指定されたモードで、指定された桁数に丸めます。この関数は、float 値を文字列に変換したり print 関数で表示した際と同じ内容（内部で暗黙の丸め処理が行われます）を基準として、さらに意図通り丸めたい場合などに使用します。float 型の値を直接丸める場合と比べて、2進/10進変換誤差の影響が少し異なる場合があります。詳細は、引数 value が float 型の場合の説明をご参照ください。

complex round(complex value, int digit, int mode)

complex型の値を、指定されたモードで、指定された桁数に丸めます。ただし、complex 型の実部と虚部の値は、内部では2進数の浮動小数点数のデータとして保持されており、丸め処理は10進数基準で行われるため、2進/10進変換誤差についての留意が必要です。詳細は、引数 value が float 型の場合の説明をご参照ください。

varfloat round(varfloat value, varint digit, int mode)

varfloat型の値を、指定されたモードで、指定された桁数に丸めます。

varcomplex round(varcomplex value, varint digit, int mode)

varcomplex型の値を、指定されたモードで、指定された桁数に丸めます。

void round(int mode)

varfloat 型および varcomplex 型の演算における、デフォルトの丸めモードを指定します。なお、varfloat 型および varcomplex 型の丸め制御と、この関数の実装は、現在は試験的に導入されているものです。現時点では、あらゆる演算において指定通りに丸め制御が行われる事は、必ずしも保証されません。使用する際には、事前に検証を行って下さい。varfloat 型および varcomplex 型の丸め制御、及びこの round 関数の実装は、試験導入期間を経た上で、VCSSL 4 以降での正式導入を予定しています。

float re( complex value )

complex 型の実部を返します。

float im( complex value )

complex 型の虚部を返します。

void re( complex value, float realValue )

complex 型の実部を設定します。

void im( complex value, float imagValue )

complex 型の虚部を設定します。

varfloat re( varcomplex value )

varcomplex 型の実部を返します。

varfloat im( varcomplex value )

varcomplex 型の虚部を返します。

void re( varcomplex value, varfloat realValue )

varcomplex 型の実部を設定します。

void im( varcomplex value, varfloat imagValue )

varcomplex 型の虚部を設定します。

macro save(string filePath, content)

簡易ファイル出力関数です。string 変数の保持する内容を、ファイルに保存します。

void save(string filePath)

簡易ファイル出力関数です。現在コンソールに表示されている内容を、ファイルに保存します。ただし、この関数の挙動は処理系依存です。例えば、コンソールの内容が、処理系に付属したウィンドウに表示されるような場合においては、恐らく期待した通りの結果が得られます。しかし、コンソールウィンドウを持たない、標準入出力ベースの処理系においては、恐らく何も行われません。

string load(string filePath)

簡易ファイル入力関数です。ファイルの内容を全て読み込み、そのまま文字列として返します。読み込み後、ファイルは自動的に閉じられます。

string load()

簡易ファイル入力関数です。現在コンソールに表示されている内容を取得し、そのまま文字列として返します。ただし、この関数の挙動は処理系依存です。例えば、コンソールの内容が、処理系に付属したウィンドウに表示されるような場合においては、恐らく期待した通りの結果が得られます。しかし、コンソールウィンドウを持たない、標準入出力ベースの処理系においては、恐らく何も得られません。

int open(string filePath, string mode)

ファイルを開き、固有の識別番号（ ファイルID ）を割り振って返します。引数 filePath には、通常はファイル名またはパスを指定しますが、代わりに STDIN や STDOUT, STDERR を指定して標準入出力に読み書きする事も可能です。

int open(string filePath, string mode, string textEncoding)

ファイルを開き、固有の識別番号（ ファイルID ）を割り振って返します。引数 filePath には、通常はファイル名またはパスを指定しますが、代わりに STDIN や STDOUT, STDERR を指定して標準入出力に読み書きする事も可能です。

macro openw(...)

この関数は VCSSL 1.0 世代のものであり、open( filePath, "wtsv" ) と同等の機能でファイルを開きます。この関数は互換目的でサポートされています。

macro opencsvw(...)

この関数は VCSSL 1.0 世代のものであり、open( filePath, "wcsv" ) と同等の機能でファイルを開きます。この関数は互換目的でサポートされています。

macro openr(...)

この関数は VCSSL 1.0 世代のものであり、open( filePath, "rtsv" ) と同等の機能でファイルを開きます。この関数は互換目的でサポートされています。

macro opencsvr(...)

この関数は VCSSL 1.0 世代のものであり、open( filePath, "rcsv" ) と同等の機能でファイルを開きます。この関数は互換目的でサポートされています。

void close(int fileID)

ファイルを閉じます。この時点で、バッファされている書き込み内容は全てフラッシュされます。

void flush(int fileID)

ファイルのバッファされている書き込み内容をフラッシュします。

macro write(int fileID, ...)

ファイルに内容を書き込みます。書き込み内容は任意型で、書き込み時に文字列に変換されます。書き込み内容を複数指定した場合、それがどのような形で書き込まれるかは、ファイル入出力モードに依存します。 "w" または WRITE モードの場合 : 書き込み内容が、そのまま連結されて書き込まれます。 , "wtsv" または WRITE_TSV モードの場合 : 書き込み内容が、タブ文字区切りで連結されて書き込まれます。 , "wcsv" または WRITE_CSV モードの場合 : 書き込み内容が、カンマ文字区切りで連結されて書き込まれます。 , なおこの関数は、VCSSL2.1以前では改行されますが、2.2以降では改行されません。改行付きの機能は writeln 関数が提供します。

macro writeln(int fileID, ...)

ファイルに内容を書き込み、改行します。書き込み内容は任意型で、書き込み時に文字列に変換されます。書き込み内容を複数指定した場合、それがどのような形で書き込まれるかは、ファイル入出力モードに依存します。 "w" または WRITE モードの場合 : 書き込み内容が、そのまま連結されて書き込まれます。 , "wtsv" または WRITE_TSV モードの場合 : 書き込み内容が、タブ文字区切りで連結されて書き込まれます。 , "wcsv" または WRITE_CSV モードの場合 : 書き込み内容が、カンマ文字区切りで連結されて書き込まれます。 , なお、改行コードには、実行環境に適切なものが自動的に採用されます。もしも、LF や CR などの特定の改行コードを使用したい場合は、この関数の代わりに write 関数を使用し、書き込み内容に LF や CR を付加して書き込んでください。

string[ ] read(int fileID)

ファイルの内容を全て読み込みます。戻り値は string 型配列ですが、これに読み込み内容がどのように格納されるのかは、ファイル入出力モードに依存します。 "r" または READ モードの場合 : ファイルの内容がそのまま、要素数 1 の string 型配列に格納して返されます。 , "rtsv" または READ_TSV モードの場合 : ファイルの内容が、空白及び改行区切りで、string 型配列に格納して返されます。タブ文字と半角空白は同一視されます。 , "rcsv" または READ_CSV モードの場合 : ファイルの内容が、カンマ記号及び改行区切りで、string 型配列に格納して返されます。 , CSV や TSV の読み込みでは、エンクロージャやデリミタの解釈は行われず、単純に区切り文字が存在する位置で区切られます。また、TSV ではタブ文字と半角空白は区別されません。このあたりの挙動を、より厳密に制御したい場合は、file.TextFile ライブラリを使用してください。なおこの関数は、VCSSL2.1以前では行単位の読み込みでしたが、VCSSL2.2以降から全体の読み込みに変更されました。行単位の、過去と同様の機能は readln 関数が提供します。

string[ ] readln(int fileID)

ファイルから一行の内容を読み込みます。戻り値は string 型配列ですが、これに読み込み内容がどのように格納されるのかは、ファイル入出力モードに依存します。 "r" または READ モードの場合 : ファイルの内容がそのまま、要素数 1 の string 型配列に格納して返されます。 , "rtsv" または READ_TSV モードの場合 : ファイルの内容が、空白区切りで、string 型配列に格納して返されます。タブ文字と半角空白は同一視されます。 , "rcsv" または READ_CSV モードの場合 : ファイルの内容が、カンマ記号区切りで、string 型配列に格納して返されます。 , なお、CSV や TSV の読み込みでは、エンクロージャやデリミタの解釈は行われず、単純に区切り文字が存在する位置で区切られます。また、TSV ではタブ文字と半角空白は区別されません。このあたりの挙動を、より厳密に制御したい場合は、file.TextFile ライブラリを使用してください。

string load(int fileID)

ファイルの内容を全て読み込み、そのまま文字列として返します。

string loadln(int fileID)

ファイルから一行の内容を全て読み込み、そのまま文字列として返します。

int countln(int fileID)

ファイルの行数をカウントします。

macro eval(string expression)

文字列を式として評価します。レキシカルスコープで、変数や関数へのアクセスも可能です。また、代入を行う事もできます。戻り値には、式の値が string 型配列に変換されて返されます ( 式の値が非配列であった場合は、戻り値の要素数は 1 となります )。string 型配列は、最も変換自由度の高い型であり、あらゆるプリミティブ型の配列と非配列に代入できます ( 非配列へは要素数が1の場合に限り可能です )。反面、繰り返し高速に評価したい場合、特に戻り値が int 型や float 型である場合においては、文字列を介する型変換がボトルネックとなります。そういった場合は、評価式の中で結果を変数に代入し、戻り値を利用せずに捨てる事で、ボトルネックを回避できます。

macro eval(string expression, literalType)

文字列を式として評価します。引数 1 個の eval 関数と異なるのは、式中でサフィックスが明示されていない数値リテラルを、どの型と解釈するか指定できる点です。例えば "1 / 2" の式は、通常は int 型同士の除算となるため、値は 0 です。これを float 型同士の除算と見なして 0.5 を得たい場合には、第二引数に float 型の値 ( 0.0 など ) を指定してください。なお第二引数は、型のみが意味を持ち、値は無視されます(しかしながら、初来的に何らかの意味づけが加えられる可能性もあるため、特に理由が無ければ 0 や 0.0 を指定する事が推奨されます)。

macro feval(string expression)

文字列を式として評価し、値を float 型の非配列で返します。

macro feval(string expression, literalType)

文字列を式として評価し、値を float 型の非配列で返します。

macro ieval(string expression)

文字列を式として評価し、値を int 型の非配列で返します。

macro ieval(string expression, literalType)

文字列を式として評価し、値を int 型の非配列で返します。

macro ceval(string expression)

文字列を式として評価し、値を complex 型の非配列で返します。

macro ceval(string expression, literalType)

文字列を式として評価し、値を complex 型の非配列で返します。

macro beval(string expression)

文字列を式として評価し、値を bool 型の非配列で返します。

macro beval(string expression, literalType)

文字列を式として評価し、値を bool 型の非配列で返します。

macro seval(string expression)

文字列を式として評価し、値を string 型の非配列で返します。

macro seval(string expression, literalType)

文字列を式として評価し、値を string 型の非配列で返します。

macro vfeval(string expression)

文字列を式として評価し、値を varfloat 型の非配列で返します。

macro vfeval(string expression, literalType)

文字列を式として評価し、値を varfloat 型の非配列で返します。

macro vieval(string expression)

文字列を式として評価し、値を varint 型の非配列で返します。

macro vieval(string expression, literalType)

文字列を式として評価し、値を varint 型の非配列で返します。

macro vceval(string expression)

文字列を式として評価し、値を varcomplex 型の非配列で返します。

macro vceval(string expression, literalType)

文字列を式として評価し、値を varcomplex 型の非配列で返します。

macro evaluable(string expression)

式の内容が構文的に正しいかどうかを判定します。eval 関数は構文解析に失敗すると処理速度が低下するため、式を高速に繰り返し評価したい場合、事前にこの関数で式の正当性を確認しておく事が推奨されます。

macro evaluable(string expression, literalType)

式の内容が構文的に正しいかどうかを判定します。eval 関数は構文解析に失敗すると処理速度が低下するため、式を高速に繰り返し評価したい場合、事前にこの関数で式の正当性を確認しておく事が推奨されます。

macro evaltr(string expression)

文字列を式として評価し、処理系の内部処理情報を返します。内容は完全に処理系依存です。なお、利用できる式には処理系依存の制約があり、必ずしも通常の式評価と整合する内容を返すとは限りません。また、一般に副作用のある式には使用できません。この関数は、主に開発時やデバッグ時に使用します。

macro evaltr(string expression, literalType)

文字列を式として評価し、処理系の内部処理情報を返します。内容は完全に処理系依存です。なお、利用できる式には処理系依存の制約があり、必ずしも通常の式評価と整合する内容を返すとは限りません。また、一般に副作用のある式には使用できません。この関数は、主に開発時やデバッグ時に使用します。

macro override(string functionName, string argumentType[ ], string functionCode)

関数の処理内容を、実行時に変更します。eval 関数は、ローカル変数の宣言や、複数の文を実行できないため、そのような処理を動的評価で行いたい場合には、この関数を使用します。なお、この関数でできるのは、既存の関数の処理内容を変更する事のみであり、新しい関数を宣言する事はできません。

string lf()

環境依存の改行コードを返します。VCSSL 3 以降では、定数 EOL をそのまま改行コードとして使用できます。この関数は、関数コールのオーバーヘッドを無駄に要します。新しいプログラムでは 定数 EOL の使用が推奨されます。この関数は互換目的でサポートされています。

string linefeed()

環境依存の改行コードを返します。VCSSL 3 以降では、定数 EOL をそのまま改行コードとして使用できます。この関数は、関数コールのオーバーヘッドを無駄に要します。新しいプログラムでは 定数 EOL の使用が推奨されます。この関数は互換目的でサポートされています。

void main( )

いわゆる main 関数です。全モジュールのグローバル領域の処理（例えばグローバル定数の初期化など）が完了した時点で、自動的にコールされます。複数のモジュールにおいて main 関数が存在する場合、モジュールの読み込み順序に基づいて、最後に定義されたものだけがコールされます（この点は一般のイベントハンドラと異なります）。

void main( string args[ ] )

いわゆる main 関数です。全モジュールのグローバル領域の処理（例えばグローバル定数の初期化など）が完了した時点で、自動的にコールされます。複数のモジュールにおいて main 関数が存在する場合、モジュールの読み込み順序に基づいて、最後に定義されたものだけがコールされます（この点は一般のイベントハンドラと異なります）。

構造体 - Structs

- なし - None -

変数 - Variables

関数 - Functions

イベントハンドラ - Event Handler