@ToNumber (式言語)

構文

@ToNumber( value )

パラメータ

value

文字列、数値、そのリスト。変換できない値の場合、「値が数値に変換できません。」というエラーが返されます。

戻り値

number

数値または数値リスト。value を数値に変換したものが返されます。

使用法

パラメータがリストである場合、この関数はリストの各要素ごとに処理され、戻り値は同じ数の要素を持つリストになります。いずれかの要素が変換できない場合、エラーが発生します。

関数のパラメータが数値でなければならない場合に、データ型が数値である値を確実に渡すようにする場合に便利です。

例

1. 次の例では、20 と 40 がリストで返されます。

   @ToNumber("20" : "40")

2. 次の例では、「値が数値に変換できません。」というエラーが返されます。

   @ToNumber("20" : "r")

3. 次の例では、テキストフィールドの値 "20" と、数値フィールドの値 10 が数値に変換されます。このようにすると、2 つの数値を必要とする @Sum 関数を使用して、これらのフィールドの値の合計を計算できます。次の式では、30 が返されます。

   @Sum(@ToNumber(numberField);@ToNumber(textField))

クロスリファレンス

LotusScript® 言語の Val 関数

LotusScript 言語の Str 関数

LotusScript 言語の CInt 関数

LotusScript 言語の CLng 関数

LotusScript 言語の CSng 関数

LotusScript 言語の CDbl 関数