@Left (式言語)

構文

@Left( stringToSearch ; numberOfChars ) @Left( stringToSearch ; subString )

パラメータ

stringToSearch

文字列または文字列リスト。左端部分の文字を取得する文字列を指定します。

numberOfChars

数値。返される文字数を指定します。2 を指定すると文字列の最初の 2 文字が返され、5 を指定すると最初の 5 文字が返されます。負の数値を指定すると、文字列全体が返されます。

subString

文字列。stringToSearch のサブ文字列です。@Left では、subString の左側にある文字が返されます。subString の検索では、stringToSearch は左から右に検索されます。

戻り値

resultString

文字列または文字列リスト。stringToSearch の左端部分の文字です。返される文字数は、numberOfChars またはsubString で決まります。stringToSearch に subString が見つからない場合は、Null 文字列 ("") が返されます。

使用法

最初のパラメータがリストである場合、この関数はリストの各要素ごとに処理され、戻り値は同じ数の要素を持つリストになります。

例

1. 次の例では、Len が返されます。

   @Left("Lennard Wallace";3)

2. 次の例では、[Contact] フィールドの文字列が Lennard Wallace のとき、Lennard Wal が返されます。

   @Left(Contact;"la")

3. 次の例では、[Author] フィールドの文字列が Timothy Altman のとき、Tim が返されます。

   @Left(Author;3)

4. 次の例では、[Author] フィールドの文字列が Timothy Altman のとき、Timothy が返されます。

   @Left(Author;" ")

5. 次の例では、L と W がリストで返されます。

   @Left("Lennard" : "Wallace"; 1)

クロスリファレンス

LotusScript® 言語の Left 関数

LotusScript 言語の StrLeft 関数