Char.CompareTo メソッド

指定したオブジェクトとこのインスタンスを比較し、これらの相対値を示す値を返します。

Public Overridable Function CompareTo( _
   ByVal value As Object _) As Integer
[C#]
public virtual int CompareTo(objectvalue);
[C++]
public: virtual int CompareTo(Object* value);
[JScript]
public function CompareTo(
   value : Object) : int;

パラメータ

• value
  比較対象のオブジェクト、または null 参照 (Visual Basic では Nothing) 。

戻り値

このインスタンスと value の相対値を示す符号付き数値。

例外

解説

Char のすべてのインスタンスは、その値に関係なく、 null 参照 (Visual Basic では Nothing) より大きいと見なされます。

value は null 参照 (Nothing) であるか、または Char のインスタンスである必要があります。それ以外の場合は、例外がスローされます。

このメソッドによって実行されるのは、このインスタンスのエンコードされた値と value を基にした比較であり、一般的な辞書の特性に基づくものとはいえません。

このメソッドは、 IComparable インターフェイスをサポートするために実装します。

使用例

[Visual Basic, C#, C++] CompareTo のサンプルを次に示します。

 
Imports System

Module CompareToSample

    Sub Main()

        Dim chA As Char
        chA = "A"c
        Dim chB As Char
        chB = "B"c

        Console.WriteLine(chA.CompareTo("A"c))  ' Output: "0" (meaning they're equal)
        Console.WriteLine("b"c.CompareTo(chB))  ' Output: "32" (meaning 'b' is 32 greater than 'B')
    Console.WriteLine(chA.CompareTo(chB))    ' Output: "-1" (meaning 'A' is less than 'B' by 1)

    End Sub

End Module

[C#] 
using System;

public class CompareToSample {
    public static void Main() {
        char chA = 'A';
        char chB = 'B';

        Console.WriteLine(chA.CompareTo('A'));    // Output: "0" (meaning they're equal)
        Console.WriteLine('b'.CompareTo(chB));    // Output: "32" (meaning 'b' is greater than 'B' by 32)
        Console.WriteLine(chA.CompareTo(chB));    // Output: "-1" (meaning 'A' is less than 'B' by 1)
    }
}

[C++] 
#using <mscorlib.dll>
using namespace System;

int main() {
    char chA = 'A';
    char chB = 'B';

    Console::WriteLine(chA.CompareTo(__box('A')));    // Output: "0" (meaning they're equal)
    Console::WriteLine('b'.CompareTo(__box(chB)));    // Output: "32" (meaning 'b' is greater than 'B' by 32)
    Console::WriteLine(chA.CompareTo(__box(chB)));    // Output: "-1" (meaning 'A' is less than 'B' by 1)
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

Char 構造体 | Char メンバ | System 名前空間 | IComparable | Char.Equals