#文字列比較(<文字列1>, <文字列2>[, <大小文字同一視>, <全半角同一視>])

文字列を比較します。

構文

#文字列比較(<文字列1>, <文字列2>[, <大小文字同一視>, <全半角同一視>])

#STRCMP(<文字列1>, <文字列2>[, <大小文字同一視>, <全半角同一視>])

引数

<文字列1>

比較される文字列を指定します。

<文字列2>

比較する文字列を指定します。

<大小文字同一視>

大文字小文字を無視したい文字の種類を指定します。省略したときは大文字小文字を区別します。

<全半角同一視>

全角半角を無視したい文字の種類を指定します。省略したときは全角半角を区別します。

例

#文字列比較('東京１２３大学','東京123大学')	→	1
#文字列比較('東京１２３大学','東京１２３大学')	→	0
#文字列比較('東京123大学','東京１２３大学')	→	-1

解説

• 二つの文字列を文字符号順で比較し，大小を調べます。比較演算子 ＝ では，大小関係が調べられないことに注意してください。
• 文字列を比較するとき，<大小文字同一視> によって大文字小文字を無視することができます。<大小文字同一視> を省略したときは，大文字小文字をすべて区別します。<大小文字同一視> は次の表の数字か文字を指定します。数字のときはその和を，文字のときはいずれか 1 文字を複数繋げて文字列として指定します。文字の全角半角は区別されません。ここに挙がっている以外の文字は無視されます。たとえば '露キ' と 12 は同じ意味になります。'英' は '半全' と同じです。すべての大文字小文字を無視するには，-1 または '＊' を指定します。

  数値	文字	意味
  1	半	半角文字
  2	全	全角文字
  4	希ギキ	ギリシア文字
  8	露ロ	ロシア文字 (キリール文字)
  	英	全角半角英字
  	＊	以上すべて
  	大	大文字に変換
  	小	小文字に変換

• <大小文字同一視> が指定されたとき，対象文字は指定によって大文字または小文字に変換されてから比較されます。大も小も指定されていないときは大文字に変換されます。
• 文字列を比較するとき，<全半角同一視> によって全角半角を無視することができます。<全半角同一視> を省略したときは，全角半角をすべて区別します。<全半角同一視> は次の表の数字か文字を指定します。数字のときはその和を，文字のときはいずれか 1 文字を複数繋げて文字列として指定します。文字の全角半角は区別されません。ここに挙がっている以外の文字は無視されます。たとえば '空カ' と 18 は同じ意味になります。すべての全角半角を無視するには，-1 または '＊' を指定します。

  数値	文字	意味
  1	記	記号
  2	空白	空白
  4	数	数字
  8	英	英字
  16	片カタ	カタカナ
  	＊	以上すべて

• <全半角同一視> が指定されたとき，対象文字は全角に変換されてから比較されます。また，<全半角同一視> に英字が指定されていて，<大小文字同一視> に半角英字が指定されているときは，<大小文字同一視> には全角英字も指定されているとみなされます。

戻り値

• <文字列1> が <文字列2> より小さいときは -1 を，<文字列1> が <文字列2> より大きいときは 1 を，<文字列1> と <文字列2> が等しいときは 0 をそれぞれ整数型で返します。

関連項目

比較演算子

#部分一致

#辞書順比較

#基本つづり比較

#基本つづり部分一致