テスト関数

バージョン:

2023.1

Last modified: March 07, 2023

テスト関数はデータ比較を実行します。テスト関数を使用して、値のデータ型を識別するか、値が存在するかどうかを判別します。テスト関数は、すべてのデータ型で使用できます。

CompareDictionary

CompareDictionary(a,b): 大文字と小文字の違いを無視して 2 つの文字列を比較し、数値と思われるテキストは数値順に比較します。この関数は、a < b の場合は -1、a==b の場合は 0、a > b の場合は 1 を返します。

この関数は、辞書比較と完全に同じ順序ではありません。つまり、特定の言語の規則を使用して辞書のソートを実行するように構成されている場合、ソートツールと同じように発音区別記号を処理しません。

例

CompareDictionary("apples", "bananas") は -1 を返します。

CompareDictionary("APPLES","bananas") は -1 を返します。

CompareDictionary("apples","BANANAS") は -1 を返します。

CompareDictionary("Cherries","Bananas") は 1 を返します。

CompareDictionary("Bananas","bananas") は 0 を返します。

CompareDictionary("2","10") は、-1 を返します (文字「2」が文字「1」より大きいですが、2 は 10 より小さい)。

CompareDictionary("minus -2","minus -10") は 1 を返します (2 は -10より大きい)。マイナス記号は、空白の先頭または後でのみ認識されます)。

CompareDictionary("minus-2","minus-10") は -1 を返します (2 は 10 より小さい)。スペースの後にないマイナス記号は、数値の一部としてカウントされません)。

CompareDictionary("pi 3.14","pi 6.28e-1") は、1 を返します (浮動小数点数の構文を認識し、3.14 は 0.628 よりも大きいと判断します)。

CompareDictionary("12.00","12.0") は、1 を返します (数値が同じ値の場合、桁数が長い方が大きいとみなされます)。

CompareDictionary("a", "À") は -1 を返します。

CompareDictionary("n","ñ") は、-1 を返します (ラテンアルファベットでは、マークの付いた文字は、マークの付いていない文字よりも大きいと見なされます)。

CompareDictionary("o","ñ") は、-1 を返します (スペイン語辞書では、Ñ は O よりも小さいとみなされます)。これは言語的な辞書での比較ではありません)。

CompareDictionary("ñ","Ñ") 　は、0 を返します (マークの付いた文字は大文字と小文字を区別せずに比較されます)。

CompareDigits

CompareDigits(a, b, nNumDigits): 2 つの数値を比較し、指定した桁数 (nNumDigits) まで同じかどうかを判断します。

この比較では、差のある先頭の桁が A と B の大きい方の NumDigits 桁もしくはそれより右にある場合、A と B は等しいと判断します。

nNumDigits パラメーターは Null であってはならず、1 から 19 の間でなければなりません。そうでない場合は、エラーが発生します。整数以外の値を指定した場合は、最も近い整数に四捨五入されます (NumDigits は 0.5 - 19.499 の範囲で指定できます)。

例

CompareDigits(12345, 12444, 3) は "True" を返します (差は 99 で、その先頭桁は A の先頭桁の 3 桁右にあります)。

CompareDigits(12345, 12445, 3) は "False" を返します　(差は 100 で、その先頭桁は A の先頭桁の 2 桁だけ右にあります)。

CompareDigits(12.345, 12.347, 3) は "True" を返します　(差は 0.002 で、その先頭桁は A の先頭桁の 4 桁右にあります)。

CompareDigits(12.345, 12.435, 3) は "True" を返します (差は 0.09 で、その先頭桁は A の先頭桁の 3 桁右にあります)。

CompareDigits( .91234, .91334, 3) は "False" を返します (差は .001 で、その先頭桁は A の先頭桁の 2 桁だけ右にあります)。

CompareEpsilon

CompareEpsilon(a, b, epsilon): 2 つの浮動小数点数を比較し、その差がイプシロン以内の場合は True を返します。

例

CompareEpsilon(123.456789101112, 123.456789101114, 0.0001) は "True" を返します。

CompareEpsilon(123.456, 123.456789101112, 0.0001) は "False" を返します。

IsEmpty

IsEmpty(v): v が NULL または "" であるかどうかをテストします。

例

Name (v)	IsEmpty
John	False
	True
Mary	False
[Null]	True

IsInteger

IsInteger(v): 整数に変換できる値が (v) に含まれているかどうかをテストします。含まれている場合は、True を返します。

例

値 (v)	IsInteger
1	True
1.23	False
B	False

IsNull

IsNull(v): (v) が NULL かどうかをテストします。v が NULL の場合は True を返し、それ以外の場合は False を返します。

行に NULL 値を入力するには、 NULL() 関数を使用します。

例

Name (v)	IsNull
John	False
[Null]	True
Mary	False

IsNumber

IsNumber(v): (v) のフィールド型が数値かどうかをテストします。

SpatialObj

IsSpatialObj(v): (v) のフィールド型が空間オブジェクトかどうかをテストします。

IsString

IsString(v): (v) のフィールド型が文字列かどうかをテストします。