標準文字列関数のリファレンス(iLogic)

iLogic では、iLogic のルールに含めることができるテキスト パラメータの文字列関数を提供しています。

文字列関数にアクセスするには、iLogic の[ルールを編集]ダイアログの[スニペット]領域にある[システム]タブで、[文字列]ノードを展開します。

標準文字列関数

iLogic で使用するほとんどの文字列関数は、VB.NET 文字列ライブラリの要素として提供されています。次のように強化されました。

Left() CStr()
Compare Now()
Len() DateString
Right() TimeString
Mid() Val(string)
LCase() Read All Text
UCase()  

これらの関数のドキュメンテーションは、http://msdn.microsoft.com/ja-jp/library/system.string_methods(VS.80).aspxから使用できます。

iLogic 文字列関数

いくつかの文字列関数は iLogic 専用です。

機能 目的 例 :
CDblAny(string) テキスト文字列を倍精度値に変換します。VB.NET の CDbl 関数と類似する関数です。Windows の言語設定に関係なく、カンマまたはピリオドを小数点として使用し、テキスト文字列を変換します。テキスト文字列が有効な数値を示していないときは、エラーになる場合があります。

x = CDblAny("3.14159")は 3.14159 を返します。

x = CDblAny("3,14159")は 3.14159 を返します。

RoundToFraction(value, fractionFactor, RoundingMethod.Round)

数値を、インチ単位の計測値を表す分数形式のテキスト文字列にします。

分数(例、"1/2")、または数値と分数(例、"3 5/8")で返します。値を分数の倍数に丸めます。

fractionFactor は、1/2、1/4、1/8、1/16、1/32、1/64、または 1/128 にする必要があります。

RoundingMethod.Round は、最も近い fractionFactor の倍数に丸めます。

RoundToFraction(0.7502, 1/4, RoundingMethod.Round)' は "1/4" を返します。

RoundToFraction(value, fractionFactor, RoundingMethod.RoundUp)

数値を、インチ単位の計測値を表す分数形式のテキスト文字列にします。

分数(例、"1/2")、または数値と分数(例、"3 5/8")で返します。値を分数の倍数に丸めます。

fractionFactor は、1/2、1/4、1/8、1/16、1/32、1/64、または 1/128 にする必要があります。

RoundingMethod.RoundUp は、値以上で最も近い fractionFactor の倍数に丸めます。

RoundToFraction(0.7502, 1/4, RoundingMethod.RoundUp)' は "3/4" を返します。

RoundToFraction(0.749, 1/4, RoundingMethod.RoundUp) ' は "3/4" を返します。

RoundToFraction(0.749, 1/8, RoundingMethod.RoundUp)' は "3/4" を返します。

RoundToFraction(0.7, 1/8, RoundingMethod.RoundUp) ' は "3/4" を返します。

RoundToFraction(0.6, 1/4, RoundingMethod.RoundUp)' は "3/4" を返します。

RoundToFraction(0.6, 1/8, RoundingMethod.RoundUp) ' は "5/8" を返します。

RoundToFraction(value, fractionFactor, RoundingMethod.RoundDown)

数値を、インチ単位の計測値を表す分数形式のテキスト文字列にします。

分数(例、"1/2")、または数値と分数(例、"3 5/8")で返します。値を分数の倍数に丸めます。

fractionFactor は、1/2、1/4、1/8、1/16、1/32、1/64、または 1/128 にする必要があります。

RoundingMethod.RoundDown は、値以下で最も近い fractionFactor の倍数に丸めます。

RoundToFraction(0.7502, 1/4, RoundingMethod.RoundDown) ' は "3/4" を返します。

RoundToFraction(0.749, 1/4, RoundingMethod.RoundDown) ' は "1/2" を返します。

FormatAsFraction(value, [numberOfDecimals])

数値を、インチ単位の計測値を表す分数形式のテキスト文字列にします。

分数(例、"1/2")、または数値と分数(例、"3 5/8")で返します。ただし、この戻り値は分母が 2 のべき乗の分数で、分子を整数で表せる場合のみです(分母は最大 128 で、分子の許容差は 0.0000001)。それ以外は、小数値を返します。

小数値が返される場合、numberofDecimals が結果のテキスト文字列の丸めに影響します。この引数は省略可能で、指定しない場合の既定は 3 です。

FormatAsFraction(0.75) ' は "3/4" を返します。

FormatAsFraction(2.375)' は "2 3/8" を返します。

FormatAsFraction(2.4) ' は "2.4" を返します。

FormatAsFraction(2.00001) ' は "2" を返します。

注: iLogic テキストパラメータを数値に変換するには CDblAny 関数を使用します。