Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

STRING

式を文字列に変換して連結する関数。

Synopsis

STRING(string1[,string2][,...][,stringn])

引数

string フィールド名、文字列リテラル、数値、または他の関数の結果となる式。基本となるデータ型は、任意の文字タイプ (CHAR や VARCHAR2 など) とすることができます。フィールド名が指定されている場合は、論理値が使用されます。

概要

STRING は、1 つ以上の string を STRING 形式に変換し、これらの文字列を単一の文字列に連結します。ケース変換は実行されません。

STRING は、文字列変換する前に数値をキャノニック形式に変換します。そのため、算術演算が実行され、数値の先頭および末尾のゼロと先頭のプラス記号が取り除かれます。

string 引数の 1 つが NULL の場合、STRING は NULL を返します。string 引数の 1 つが空文字列 ('') の場合、STRING はその他の引数を連結します。STRING は、空白を保持します。

%SQLSTRING 関数を使用すると、データを文字列の大文字と小文字を区別して比較するための値に変換します。また、%SQLUPPER 関数は、データを文字列の大文字と小文字を区別せずに比較するための値に変換します。

以下の埋め込み SQL の例では、STRING により 3 つの部分文字列を単一の文字列に連結しています。また、空白スペース、空文字列、および NULL の処理についても示しています。

   &sql(SELECT STRING('a','b','c'),
               STRING('a',' ','c'),
               STRING('a','','c'),
               STRING('a',NULL,'c')
        INTO :w,:x,:y,:z)
   IF SQLCODE'=0 {
     WRITE !,"Error code ",SQLCODE }
   ELSE {
     WRITE !,"Resulting string is:",w
     WRITE !,"Resulting string is:",x
     WRITE !,"Resulting string is:",y
     WRITE !,"Resulting string is:",z }

以下の埋め込み SQL の例では、STRING により数値を文字列に変換しています。これらすべての STRING 関数は、文字列 '123' を返します。

   &sql(SELECT STRING(123),
               STRING(+00123.00),
               STRING('1',23),
               STRING(1,(10*2)+3)
        INTO :w,:x,:y,:z)
   IF SQLCODE'=0 {
     WRITE !,"Error code ",SQLCODE }
   ELSE {
     WRITE !,"Resulting string is:",w
     WRITE !,"Resulting string is:",x
     WRITE !,"Resulting string is:",y
     WRITE !,"Resulting string is:",z }

以下の埋め込み SQL の例では、STRING を使用してフィールドからサンプル・データを取得し、これを文字列に変換しています。

   &sql(SELECT STRING(Name,Age)
        INTO :x
        FROM Sample.Person)
   IF SQLCODE'=0 {
     WRITE !,"Error code ",SQLCODE }
   ELSE {
     WRITE !,"Resulting string is:",x }

関連項目

%STRING %SQLUPPER %SQLSTRING STR

FeedbackOpens in a new tab