concatenate()

システム関数 StrLib.concatenate は、2 つのストリングを連結します。

  StrLib.concatenate(
    target VagText inOut,
    source VagText in)
  returns (result INT)
result
関数から戻される (INT 型か、長さが 9 で小数部がない BIN 型と同等と定義された) 次のいずれかの値を受け取る数値項目。
-1
連結されたストリングが長すぎてターゲット項目と適合しないため、ストリングが切り捨てられた (後述)
0
連結されたストリングがターゲット項目に適合する
target
ターゲット項目
source
ソース項目またはリテラル

2 つのストリングを連結すると、以下のようになります。

  1. ターゲット・ストリングの末尾のスペースや NULL がすべて削除される。
  2. ステップ 1 で生成されたストリングにソース・ストリングが付加される。
  3. ステップ 2 で生成されたストリングがターゲット・ストリング項目よりも長い場合は、ストリングが切り捨てられる。ターゲット・ストリング項目よりも短い場合は、ブランクが埋め込まれる。

  phrase = "and/  "; // CHAR(7)  
  or     = "or";
  result =
    StrLib.concatenate(phrase,or);
  if (result == 0)
    print phrase;  // phrase = "and/or "
  end

関連する概念
EGL 関数の構文図

関連する参照項目
EGL ライブラリー StrLib

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.