組み込み関数

組み込み関数は一時的なデータ項目であり、関数が指定されたステートメントの実行中に値が決まり、参照が可能になります。組み込み関数の名前はCOBOL語です。

実行されるサービスに応じて、算術、統計、日付/時刻、財務、文字処理、その他の関数に分類することができます。関数は、その名前を必要な引数と一緒に指定して手続き部のステートメントで使用し、実行後の結果として英数字、数字、または整数の値を返します。

関数識別子は、その関数のタイプのデータ項目を使用できるところであればどこでも指定することができます。関数の引数は、同じ関数についての他の評価を含めて、その結果が引数の条件を満たしている場合、任意の関数または関数を含む式にすることができます。

関数識別子の一般的な形式は以下のとおりです。

関数の特性には以下のようなものがあります。

このように関数が返す値のタイプと特性は、その関数の引数によって決定されます。引数のタイプと可変かどうかは、関数の定義によって変わります。

組み込み関数の評価は、コンテキストには影響されません。すなわち、関数の評価は、関数以外の操作や演算には影響を与えません。ただし、引数の属性によって影響を受ける場合があります。

手続き部内のステートメントでは、それぞれの関数の定義は、それと同じ位置にある識別子に関連する参照変更や修飾があれば、それらが評価されるときに同時に評価されます。

組み込み関数は、任意のデータ項目として使用され、以下のようなタイプがあります。

引数は、関数の値を決めるために使用される値です。関数に応じて引数が不要な場合もあれば、1つまたは複数を必要とする場合もあります。また、可変数の引数を指定できる関数もあります。特定の識別子、算術式、または整数を指定することができ、それぞれの引数が解釈および評価され、最終的に関数の値が決まります。指定できる引数のタイプは以下のとおりです。

以下は、引数内の小文字を大文字に置き換える英数字タイプ関数UPPER-CASEの使用例です。このステートメントは、HELLOをDATA-NAMEに移動させます。

以下は、数字タイプ関数の使用例です。このステートメントは、数字関数SUMを​​使用して、A、B、およびCの値を加算し、その結果をNUM-ITEMに保存します。

関数の定義は、各組み込み関数の引数のタイプ、関数のタイプ、および戻り値を指定します。

引数のタイプと関数のタイプは、以下のような省略形の文字を使用します。

以下は、組み込み関数の引数、関数のタイプ、戻り値をまとめた表です。

ACOSは数字タイプの関数であり、指定された引数の逆余弦（COS）の値を返します。

ANNUITYは数字タイプの関数です。特定の期間につき特定の金利で、各期ごとに支払われる年金の初期値に対する割合を近似で表した値を返します。

ASINは数字タイプの関数であり、指定された引数の逆正弦（SIN）値を返します。

ATANは数字タイプの関数であり、指定された引数の逆正接（TAN）値を返します。

CHARは英数字タイプの関数であり、指定された引数の値に相当する照合シーケンス位置にある英数字を返します。

COSは数字タイプの関数であり、引数によって指定されたCOS値を返します。

CURRENT-DATEは、英数字タイプの関数です。カレンダー上の日付、時刻、およびこの関数が実行されるシステムで提供されているグリニッジ標準時との時差を表す21文字の英数字を返します。

DATE-OF-INTEGERは整数タイプの関数です。グレゴリオ暦の日付を整数で表した形式から標準形式の日付（YYYYMMDD）に変換します。

DATE-TO-YYYYMMDDは、整数タイプの関数です。argument-1の値を、2桁の年で表した日付形式（YYMMDD）から4桁で表した日付形式（YYYYMMDD）に変換します。argument-2は、実行時に開始の年に加わって追加される、前の2桁を指定するための引数として使用されます。

DAY-OF-INTEGERは整数タイプの関数です。グレゴリオ暦の日付を整数で表した日から年間通算日形式（YYYYDDD）に変換します。

DAY-TO-YYYYDDDは、整数タイプの関数です。

FACTORIALは整数タイプの関数であり、指定された引数の階乗値を返します。

INTEGERは整数タイプの関数であり、指定された引数より小さいか等しい最大の整数を返します。

INTEGER-OF-DATEは整数タイプの関数です。グレゴリオ暦の日付を標準形式の日付（YYYYMMDD）から整数で表した日付形式に変換します。

INTEGER-OF-DAYは整数タイプの関数です。グレゴリオ暦の日付を年間通算日形式（YYYYDDD）に変換した整数を返します。

INTEGER-PARTは整数タイプの関数であり、指定された引数の整数部分を返します。

LENGTHは整数タイプの関数であり、引数の長さに相当する整数を返します。

LOGは数字タイプの関数であり、指定された引数のe（自然対数）を底とする対数の近似値を返します。

LOG10は数字タイプの関数であり、指定された引数の10を底とする対数の近似値を返します。

LOWER-CASEは、引数に含まれている大文字を小文字に変換する関数です。関数のタイプは、以下のとおり引数のタイプによって異なります。

MAXは引数の最大値を返す関数です。関数のタイプは、以下のとおり引数のタイプによって異なります。

MEANは数字タイプの関数であり、引数の算術平均の近似に相当する数字を返します。

MEDIANは数字タイプの関数です。複数の引数をソートして作成されたリストの中で中央値を持つ引数を返します。

MIDRANGEは数字タイプの関数であり、最小値と最大値の算術平均の近似値を返します。

MINは、引数の最小値を返す関数です。

関数のタイプは、以下のとおり引数のタイプによって異なります。

MODは整数タイプの関数です。argument-1をargument-2で割った余りの整数値を返します。戻り値は、argument-1とargument-2のうち、桁数が少ない方と同じ桁数の整数です。

NUMVALは数字タイプの関数です。引数として指定された英数字の文字列で表した数値を返します。文字列の中に空白または連続表示の文字がある場合は、その文字を削除して数値を計算します。

NUMVAL-Cは数字タイプの関数です。引数として指定された英数字の文字列で表した数値を返します。文字列の中に空白または連続表示の文字がある場合は、その文字を削除して数値を計算します。

ORDは整数タイプの関数です。プログラム照合シーケンスの中で、この引数が持つ順序に相当する整数を返します。最小値は1です。

ORD-MAXは整数タイプの関数です。指定された引数から最大値のプログラム照合シーケンス上の順序を返します。

ORD-MINは整数タイプの関数です。指定された引数から最小値のプログラム照合シーケンス上の順序を返します。

PRESENT-VALUEは数字タイプの関数です。argument-2に指定された将来の期間満了時の一定額を、argument-1に指定された割引率を適用して、現在の値の近似値を返します。

RANDOMは数字タイプの関数です。長方形分布（rectangular distribution）からランダムに抽出した数字を返します。

RANGEは、最大引数の値から最小引数の値を減算した結果を返す関数です。

以下のとおり、関数のタイプは引数のタイプによって異なります。

REMは数字タイプの関数です。argument-1をargument-2で割った余りの値を返します。

REVERSEは、指定された引数の文字列と同じ文字を使用して順番のみ逆ソートさせた値を返す関数です。引数と戻り値の文字列の長さは同じです。

以下のとおり、関数のタイプは引数のタイプによって異なります。

SINは数字タイプの関数であり、指定された引数のSIN値を返します。

SQRTは数字タイプの関数であり、指定された引数の平方根に近似する数値を返します。

STANDARD-DEVIATIONは数字タイプの関数です。引数の標準偏差に近似する数値を返します。

SUMは、指定された引数の合計を返す関数です。

関数のタイプは、以下のとおり引数のタイプによって異なります。

TANは数字タイプの関数です。指定された引数の正接（TAN）値を返します。

TEST-NUMVALは、argument-1の内容がNUMVAL関数の引数の仕様に準拠しているかを確認します。

TEST-NUMVAL-Cは、argument-1の内容がNUMVAL-C関数の引数の仕様に準拠しているかを確認します。

TRIMは、argument-1の文字列に対してLEADINGとTRAILING、または両方の余分なスペースを削除します。

UPPER-CASEは、指定された引数の小文字をそれぞれに対応する大文字に変換する関数です。

関数のタイプは、以下のとおり引数のタイプによって異なります。

VARIANCEは数字タイプの関数であり、引数の分散に近似する数値を返します。

WHEN-COMPILEDは英数字タイプの関数です。プログラムがコンパイルされたシステムから提供されるプログラムのコンパイル時間を返します。

YEAR-TO-YYYYは整数タイプの関数です。argument-1の2桁の年を4桁の年に変換します。argument-2に指定した値と実行された時点の年を加算した値に近い年に拡張されます。