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?

Left

文字列の左端から、指定した数の文字を返すか、置換します。

Synopsis

Left(string,length)

Left(string,length)=value

引数

string 左端の文字を返す文字列式。
length 返すか、または置換する string の先頭からの文字数を示す正の整数に評価される数値式。小数点以下を持つ数値は整数に切り捨てられます。length が 0 または負の数の場合、Left は長さゼロの文字列 ("") を返します。length が 0 または負の数の場合、Left は置換を実行しません。lengthstring の文字数以上のときは、文字列全体が返されます (または置換されます)。埋め込みは実行されません。
value 文字列先頭の指定した数の文字の置換に使用される値。文字列として評価される式。

概要

Left 関数には以下の 2 つの使用方法があります。

  • string の先頭 (左端) の部分文字列を返します。これには構文 Left(string,length) が使用されます。

  • string の先頭 (左端) の部分文字列を置換します。置換部分文字列は、元の部分文字列と同じ長さでも、長くても、短くてもかまいません。これには構文 Left(string,length)=value が使用されます。

Left(string,length) は、string の左端の文字または文字列を返します。引数 length は、返す string の文字数を指定します。length が 0 または負の数の場合、Left は空の文字列 ("") を返します。string 長より長い length を指定した場合、文字列全体が返されます。

Left(string,length)=value は、string の左端の文字または文字列を value に置換します。引数 length は、置換する string の文字数を指定します。length が 0 または負の数の場合、string は変更されません。これは、string が空の文字列 ("") の場合も同じです。lengthstring の長さより長い場合、stringvalue によって置換されます。

string の文字数を指定するには、Len 関数を使用します。

Right 関数は、文字列の最後 (右端) から指定された数の文字数を返します (または置換します)。Mid 関数は、文字列内の指定した開始ポイントからの指定数の文字を返します (または置換します)。

以下の例では、Left 関数を使用して、mystr の最初の 3 文字、最初の 99 文字 (この例ではすべての文字)、および最初の 0 文字を返します。

Dim mystr
mystr = "InterSystems"
Println "length 3:",Left(mystr,3)   ' Returns "Int"
Println "length 99:",Left(mystr,99) ' Returns "InterSystems"
Println "length 0:",Left(mystr,0)   ' Returns ""

以下の例では、Left 関数を使用して mystr の最初の 3 文字を 5 文字の文字列に置換します。

Dim mystr
mystr = "NtrSystems"
PrintLn mystr
Left(mystr,3)="Inter"
PrintLn mystr

以下の例では、mystr の最初の 3 文字を削除します (NULL 文字列に置換します)。

Dim mystr
mystr = "NtrSystems"
PrintLn mystr
Left(mystr,3)=""
PrintLn mystr

以下の例では、length が mystr の長さより長いため、mystr のすべての文字が置き換えられます。

Dim mystr
mystr = "Oracle"
PrintLn mystr
Left(mystr,99)="InterSystems"
PrintLn mystr

以下の例は、length=0 の場合は、mystr に何も影響を与えないことを示しています。

Dim mystr
Dim empstr
mystr = "InterSystems"
empstr = ""
PrintLn mystr
Left(mystr,0)="Bongo"
PrintLn "string out:",mystr
Left(empstr,0)="BongoSystems"
PrintLn "string out:",empstr

関連項目

FeedbackOpens in a new tab