@Contains (式言語)

構文

@Contains( string ; substring )

パラメータ

string

文字列または文字列リスト。検索する文字列を指定します。

substring

文字列または文字列リスト。string の中で検索する文字列を指定します。

戻り値

flag

Boolean 型。

• 文字列のいずれかに部分文字列が含まれているときは True (1) が返されます。
• 部分文字列がどの文字列にも含まれていないときは False (0) が返されます。
  注: 部分文字列の要素のいずれかが Null 文字列 ("") のときは、常に True が返されます。

使用法

この関数では大文字と小文字が区別されます。

いずれかのパラメータがリストである場合、パラメータ 1 のいずれかの要素にパラメータ 2 のいずれかの要素が含まれていれば、この関数は 1 を返します。

部分文字列がリッチテキストフィールドに含まれているかどうかを調べることはできません。

完全一致 (パラメータ 2 とパラメータ 1 が等しい) を調べる場合は、この関数を使用しないでください。パラメータ 1 とパラメータ 2 が完全に一致していない状態でパラメータ 1 にパラメータ 2 が含まれる場合は、正しい結果が得られません。等価演算子または @IsMember 関数を使用すると、より効率的に正しい結果を取得することができます。

例

1. 次の例では、部分文字列「Th」が文字列「Hi There」に含まれることを示す 1 が返されます。

   @Contains("Hi There";"Th")

2. 次の例では、文字列リストのアイテムが他の文字列リストに含まれていることを示す 1 が返されます。

   @Contains("Tom":"Dick":"Harry";"Harry":"Tom")

3. 次の例では、一方のパラメータの単一文字列アイテムが、他方のパラメータを構成する文字列リストに含まれていることを示す 1 が返されます。

   @Contains("Tom";"Tom":"Dick":"Harry")

4. この入力確認式は、[RequestShipDate] フィールドの日付が有効か、あるいは [ProductLeadTime] というフィールドに「weeks」または「month」という語句が含まれているかを調べます。ユーザーが文書を保存するとき、いずれかの条件が True ならばメッセージボックスに「You must request a valid ship date」と表示されます。

   @If(@Contains(ProductLeadTime;"weeks":"month"); @If(!@IsTime(RequestedShipDate);
   @Failure("You must request a valid ship date.");@Success;@Success)

5. 次のビュー選択式によって作成される新しいビューには、[Subject] フィールドに「Mary Lamb」という文字列 (大文字か小文字かを問わない) が含まれている文書のみが表示されます。

   SELECT form = "Memo" & @Contains(@LowerCase(Subject); "mary lamb")

6. 次のアクションを実行するユーザーに ACL で [WebUser] ロールが割り当てられているときは、Notes フォームの代わりに Web フォームが開きます。

   @Command([Compose]; @If(@Contains(@UserRoles; "WebUser"); "WebForm"; "NotesForm"))

   注: この例を使用するには、[このデータベースのレプリカはすべて共通のアクセス制御リストを用いる] オプションを選択する必要があります。

クロスリファレンス

LotusScript® 言語の InStr 関数