npt-japanese

% Function STRING=, STRING/=, STRING<, STRING>, STRING<=, STRING>=, STRING-EQUAL, STRING-NOT-EQUAL, STRING-LESSP, STRING-GREATERP, STRING-NOT-GREATERP, STRING-NOT-LESSP

UP


Function STRING=, STRING/=, STRING<, STRING>, STRING<=, STRING>=, STRING-EQUAL, STRING-NOT-EQUAL, STRING-LESSP, STRING-GREATERP, STRING-NOT-GREATERP, STRING-NOT-LESSP

Function STRING=, STRING/=, STRING<, STRING>, STRING<=, STRING>=, STRING-EQUAL, STRING-NOT-EQUAL, STRING-LESSP, STRING-GREATERP, STRING-NOT-GREATERP, STRING-NOT-LESSP

構文

string= string1 string2 &key start1 end1 start2 end2 => generalized-boolean
string/= string1 string2 &key start1 end1 start2 end2 => mismatch-index
string< string1 string2 &key start1 end1 start2 end2 => mismatch-index
string> string1 string2 &key start1 end1 start2 end2 => mismatch-index
string<= string1 string2 &key start1 end1 start2 end2 => mismatch-index
string>= string1 string2 &key start1 end1 start2 end2 => mismatch-index
string-equal string1 string2 &key start1 end1 start2 end2 => generalized-boolean
string-not-equal string1 string2 &key start1 end1 start2 end2 => mismatch-index
string-lessp string1 string2 &key start1 end1 start2 end2 => mismatch-index
string-greaterp string1 string2 &key start1 end1 start2 end2 => mismatch-index
string-not-greaterp string1 string2 &key start1 end1 start2 end2 => mismatch-index
string-not-lessp string1 string2 &key start1 end1 start2 end2 => mismatch-index

引数と戻り値

string1 - string-designator
string2 - string-designator
start1, end1 - 文字列の境界インデックス指定子。 startendの標準値はそれぞれ0nil
start2, end2 - 文字列の境界インデックス指定子。 startendの標準値はそれぞれ0nil
generalized-boolean - generalized-boolean mismatch-index - string1の境界内インデックスか、nil

定義

これらの関数はstring1string2の辞書式比較を行います。 string=string-equalは等式関数と呼ばれます。 その他の関数は不等式関数です。 これらの関数が行う比較演算は、 start1end1で囲まれたstring1の部分文字列と、 start2end2で囲まれたstring2の部分文字列に限定されます。

文字列aと文字列bが等しいとは、 どちらも同じ個数の文字を保有しており、 各文字がchar=char-equalの適用において等しい場合です。

文字列aが文字列bより小さいとは、 両者の文字が異なる最初の位置で、 aの文字がchar<またはchar-lesspに従って bの対応する文字より小さい場合、 あるいは文字列aが文字列bのプレフィックス (文字の長さが短く、aのすべての文字に一致する)の場合です。

等式関数は、文字列が等しい場合は generalized-booleantrueを返却し、 それ以外はfalseを返却します。

不等式関数は、文字列が等しくない場合は mismatch-indextrueを返却し、 それ以外はfalseを返却します。

もしmismatch-indextrueの場合は、 string1の開始位置をオフセット値として、 2つの部分文字列が異なっている最初の文字の位置を整数で返却します。

比較は次のように行われます。

例文

(string= "foo" "foo") =>  true
(string= "foo" "Foo") =>  false
(string= "foo" "bar") =>  false
(string= "together" "frog" :start1 1 :end1 3 :start2 2) =>  true
(string-equal "foo" "Foo") =>  true
(string= "abcd" "01234abcd9012" :start2 5 :end2 9) =>  true
(string< "aaaa" "aaab") =>  3
(string>= "aaaaa" "aaaa") =>  4
(string-not-greaterp "Abcde" "abcdE") =>  5
(string-lessp "012AAAA789" "01aaab6" :start1 3 :end1 7
                                     :start2 2 :end2 6) =>  6
(string-not-equal "AAAA" "aaaA") =>  false

副作用

なし。

影響

なし。

例外

なし。

参考

char=

備考

equalは、2つの文字列を比較するときstring=を呼び出します。


TOP, Github