String.CompareToとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

String.CompareTo メソッド (String)

このインスタンスと、指定した String オブジェクトを比較します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Function CompareTo ( _
    strB As String _
) As Integer
Visual Basic (使用法)
Dim instance As String
Dim strB As String
Dim returnValue As Integer

returnValue = instance.CompareTo(strB)
C#
public int CompareTo (
    string strB
)
C++
public:
virtual int CompareTo (
    String^ strB
) sealed
J#
public final int CompareTo (
    String strB
)
JScript
public final function CompareTo (
    strB : String
) : int

パラメータ

strB

String。

戻り値
2 つの比較対照値の構文上の関係を示す 32 ビット符号付き整数。

値

条件

0 より小さい値

このインスタンスは、strB よりも小さくなっています。

0

このインスタンスは strB と等価です。

0 より大きい値

このインスタンスは strB よりも大きくなっています。

または

strB が null 参照 (Visual Basic では Nothing) です。

解説解説

このメソッドは、現在のカルチャを使用して、単語 (大文字/小文字を区別し、カルチャに依存した) 比較を実行します。単語、文字列、序数の並べ替えの詳細については、「System.Globalization.CompareOptions」を参照してください。

このメソッドの動作の詳細については、Compare メソッドの解説を参照してください。

このメソッドは、System.IComparable インターフェイスを実装し、文字列を保持するオブジェクトのボックス化を解除する必要がないため、String.CompareTo メソッドと比べ、若干パフォーマンスが向上しています。

使用例使用例

CompareTo メソッドを別の String と共に使用する方法については、次のコード例を参照してください。

Visual Basic
Imports System


Public Class CompareToTest
    
    Public Shared Sub Main()
        Dim strFirst As String
 = "Goodbye"
        Dim strSecond As String
 = "Hello"
        Dim strThird As String
 = "a small string"
        Dim strFourth As String
 = "goodbye"
        
        
        ' compare a string to itself
        Console.WriteLine(CompareStrings(strFirst, strFirst))
        
        Console.WriteLine(CompareStrings(strFirst, strSecond))
        Console.WriteLine(CompareStrings(strFirst, strThird))
        
        ' compare a string to another string that varies only by case
        Console.WriteLine(CompareStrings(strFirst, strFourth))
        Console.WriteLine(CompareStrings(strFourth, strFirst))
    End Sub 'Main
    
    
    Private Shared Function
 CompareStrings(str1 As String, str2 As
 String) As String
        Dim cmpVal As Integer
 = str1.CompareTo(str2)
        If cmpVal = 0 Then
            
            ' compare the values, using the CompareTo method on the
 first string
            
            ' the values are the same
            Return "The strings have the same
 value!"
        Else
            If cmpVal > 0 Then
                
                ' the first value is greater than the second value
                Return "The first string is
 greater than the second string!"
            Else
                
                ' the second string is greater than the first string
                Return "The second string is
 greater than the first string!"
            End If
        End If
    End Function 'CompareStrings
End Class 'CompareToTest
C#
using System;

public class CompareToTest {
    public static void Main()
 {

        string strFirst = "Goodbye";
        string strSecond = "Hello";
        string strThird = "a small string";
        string strFourth = "goodbye";

        // compare a string to itself
        Console.WriteLine (CompareStrings(strFirst, strFirst));

        Console.WriteLine (CompareStrings(strFirst, strSecond));
        Console.WriteLine (CompareStrings(strFirst, strThird));

        // compare a string to another string that varies only by case
        Console.WriteLine (CompareStrings(strFirst, strFourth));
        Console.WriteLine (CompareStrings(strFourth, strFirst));
    }

    private static string
 CompareStrings( string str1, string str2
 ) {

        // compare the values, using the CompareTo method on the first
 string
        int cmpVal = str1.CompareTo(str2);

    if (cmpVal == 0) // the values are the same
            return "The strings have the same value!";

        else if (cmpVal > 0) //
 the first value is greater than the second value
            return "The first string is
 greater than the second string!";
            
        else // the second string is greater than
 the first string
            return "The second string
 is greater than the first string!";
    }
}
C++
using namespace System;
String^ CompareStrings( String^ str1, String^ str2 )
{
   
   // compare the values, using the CompareTo method on the first string
   int cmpVal = str1->CompareTo( str2 );
   if ( cmpVal == 0 )
      
   // the values are the same
   return "The strings have the same value!";
   else
   if ( cmpVal > 0 )
      
   // the first value is greater than the second value
   return "The first string is greater
 than the second string!";
   // the second string is greater than the first string
   else
      
   // the second string is greater than the first string
   return "The second string is greater
 than the first string!";
}

int main()
{
   String^ strFirst = "Goodbye";
   String^ strSecond = "Hello";
   String^ strThird = "a small String*";
   String^ strFourth = "goodbye";
   
   // compare a String* to itself
   Console::WriteLine( CompareStrings( strFirst, strFirst ) );
   Console::WriteLine( CompareStrings( strFirst, strSecond ) );
   Console::WriteLine( CompareStrings( strFirst, strThird ) );
   
   // compare a String* to another String* that varies only by case
   Console::WriteLine( CompareStrings( strFirst, strFourth ) );
   Console::WriteLine( CompareStrings( strFourth, strFirst ) );
}
J#
import System.*;

public class CompareToTest
{
    public static void main(String[]
 args)
    {
        String strFirst = "Goodbye";
        String strSecond = "Hello";
        String strThird = "a small string";
        String strFourth = "goodbye";

        // compare a string to itself
        Console.WriteLine(CompareStrings(strFirst, strFirst));
        Console.WriteLine(CompareStrings(strFirst, strSecond));
        Console.WriteLine(CompareStrings(strFirst, strThird));

        // compare a string to another string that varies only by case
        Console.WriteLine(CompareStrings(strFirst, strFourth));
        Console.WriteLine(CompareStrings(strFourth, strFirst));
    } //main

    private static String CompareStrings(String
 str1, String str2)
    {
        // compare the values, using the CompareTo method on the first
 string
        int cmpVal = str1.CompareTo(str2);
        if (cmpVal == 0) { // the values are the
 same
            return "The strings have the same value!";
        }
        else {
            if (cmpVal > 0) { 
                // the first value is greater than the second value
                return "The first string is
 greater than the second string!";
            }
            else { // the second string is greater
 than the first string
                return "The second string
 is greater than the first string!";
            }
        }
    } //CompareStrings 
} //CompareToTest
JScript
import System;

public class CompareToTest {
    public static function
 Main() : void  {

        var strFirst : String = "Goodbye";
        var strSecond : String = "Hello";
        var strThird : String = "a small string";
        var strFourth : String = "goodbye";

        // compare a string to itself
        Console.WriteLine (CompareStrings(strFirst, strFirst));

        Console.WriteLine (CompareStrings(strFirst, strSecond));
        Console.WriteLine (CompareStrings(strFirst, strThird));

        // compare a string to another string that varies only by case
        Console.WriteLine (CompareStrings(strFirst, strFourth));
        Console.WriteLine (CompareStrings(strFourth, strFirst));
    }

    private static function
 CompareStrings( str1 : String, str2 : String ) : String  {

        // compare the values, using the CompareTo method on the first
 string
        var cmpVal : int = str1.CompareTo(str2);

        if (cmpVal == 0) // the values are the same
            return "The strings have the same value!";

        else if (cmpVal > 0) //
 the first value is greater than the second value
            return "The first string is
 greater than the second string!";
            
        else // the second string is greater than
 the first string
            return "The second string
 is greater than the first string!";
    }
}
CompareToTest.Main();

いくつかの値型および参照型について、ジェネリック バージョンと非ジェネリック バージョンの CompareTo メソッドのコード例を次に示します。

Visual Basic
' This example demonstrates the generic and non-generic versions of
 the 
' CompareTo method for several base types.
' The non-generic version takes a parameter of type Object, while the
 generic
' version takes a type-specific parameter, such as Boolean, Int32, or
 Double.

Imports System

Class Sample
   Public Shared Sub Main()
      Dim nl As String =
 Environment.NewLine
      Dim msg As String
 = _
          "{0}The following is the result of using the generic
 and non-generic{0}" & _
          "versions of the CompareTo method for several base types:{0}"
      
      Dim now As DateTime = DateTime.Now
      ' Time span = 11 days, 22 hours, 33 minutes, 44 seconds
      Dim tsX As New TimeSpan(11,
 22, 33, 44)
      ' Version = 1.2.333.4
      Dim versX As New Version("1.2.333.4")
      ' Guid = CA761232-ED42-11CE-BACD-00AA0057B223
      Dim guidX As New Guid("{CA761232-ED42-11CE-BACD-00AA0057B223}")
      
      Dim a1 As [Boolean] = True,
    a2 As [Boolean] = True
      Dim b1 As [Byte] = 1,          b2 As
 [Byte] = 1
      Dim c1 As Int16 = -2,          c2 As
 Int16 = 2
      Dim d1 As Int32 = 3,           d2 As
 Int32 = 3
      Dim e1 As Int64 = 4,           e2 As
 Int64 = -4
      Dim f1 As [Decimal] = -5.5D,   f2 As
 [Decimal] = 5.5D
      Dim g1 As [Single] = 6.6F,     g2 As
 [Single] = 6.6F
      Dim h1 As [Double] = 7.7,      h2 As
 [Double] = -7.7
      Dim i1 As [Char] = "A"c,
       i2 As [Char] = "A"c
      Dim j1 As String =
 "abc",      j2 As String
 = "abc"
      Dim k1 As DateTime = now,      k2 As
 DateTime = now
      Dim l1 As TimeSpan = tsX,      l2 As
 TimeSpan = tsX
      Dim m1 As Version = versX,     m2 As
 New Version("2.0")
      Dim n1 As Guid = guidX,        n2 As
 Guid = guidX
      
      ' The following types are not CLS-compliant.
      ' SByte, UInt16, UInt32, UInt64

      Console.WriteLine(msg, nl)
      Try
         ' The second and third Show method call parameters are automatically
 boxed because
         ' the second and third Show method declaration arguments expect
 type Object.

         Show("Boolean:  ", a1, a2, a1.CompareTo(a2),
 a1.CompareTo(CObj(a2)))
         Show("Byte:     ", b1, b2, b1.CompareTo(b2),
 b1.CompareTo(CObj(b2)))
         Show("Int16:    ", c1, c2, c1.CompareTo(c2),
 c1.CompareTo(CObj(c2)))
         Show("Int32:    ", d1, d2, d1.CompareTo(d2),
 d1.CompareTo(CObj(d2)))
         Show("Int64:    ", e1, e2, e1.CompareTo(e2),
 e1.CompareTo(CObj(e2)))
         Show("Decimal:  ", f1, f2, f1.CompareTo(f2),
 f1.CompareTo(CObj(f2)))
         Show("Single:   ", g1, g2, g1.CompareTo(g2),
 g1.CompareTo(CObj(g2)))
         Show("Double:   ", h1, h2, h1.CompareTo(h2),
 h1.CompareTo(CObj(h2)))
         Show("Char:     ", i1, i2, i1.CompareTo(i2),
 i1.CompareTo(CObj(i2)))
         Show("String:   ", j1, j2, j1.CompareTo(j2),
 j1.CompareTo(CObj(j2)))
         Show("DateTime: ", k1, k2, k1.CompareTo(k2),
 k1.CompareTo(CObj(k2)))
         Show("TimeSpan: ", l1, l2, l1.CompareTo(l2),
 l1.CompareTo(CObj(l2)))
         Show("Version:  ", m1, m2, m1.CompareTo(m2),
 m1.CompareTo(CObj(m2)))
         Show("Guid:     ", n1, n2, n1.CompareTo(n2),
 n1.CompareTo(CObj(n2)))
         '
         Console.WriteLine("{0}The following types are not CLS-compliant:",
 nl)
         Console.WriteLine("SByte, UInt16, UInt32, UInt64")

      Catch e As Exception
         Console.WriteLine(e)
      End Try
   End Sub 'Main
   
   Public Shared Sub Show(caption
 As String, var1 As [Object],
 var2 As [Object], _
                          resultGeneric As Integer,
 resultNonGeneric As Integer)
      Dim relation As String
      
      Console.Write(caption)
      If resultGeneric = resultNonGeneric Then
         If resultGeneric < 0 Then
            relation = "less than"
         ElseIf resultGeneric > 0 Then
            relation = "greater than"
         Else
            relation = "equal to"
         End If
         Console.WriteLine("{0} is {1} {2}", var1,
 relation, var2)
      
      ' The following condition will never occur because the generic
 and non-generic
      ' CompareTo methods are equivalent.

      Else
         Console.WriteLine("Generic CompareTo = {0}; non-generic
 CompareTo = {1}", _
                            resultGeneric, resultNonGeneric)
      End If
   End Sub 'Show
End Class 'Sample
'
'This example produces the following results:
'
'The following is the result of using the generic and non-generic versions
 of the
'CompareTo method for several base types:
'
'Boolean:  True is equal to True
'Byte:     1 is equal to 1
'Int16:    -2 is less than 2
'Int32:    3 is equal to 3
'Int64:    4 is greater than -4
'Decimal:  -5.5 is less than 5.5
'Single:   6.6 is equal to 6.6
'Double:   7.7 is greater than -7.7
'Char:     A is equal to A
'String:   abc is equal to abc
'DateTime: 12/1/2003 5:37:46 PM is equal to 12/1/2003 5:37:46 PM
'TimeSpan: 11.22:33:44 is equal to 11.22:33:44
'Version:  1.2.333.4 is less than 2.0
'Guid:     ca761232-ed42-11ce-bacd-00aa0057b223 is equal to ca761232-ed42-11ce-bacd-00
'aa0057b223
'
'The following types are not CLS-compliant:
'SByte, UInt16, UInt32, UInt64
'
C#
// This example demonstrates the generic and non-generic versions of
 the 
// CompareTo method for several base types.
// The non-generic version takes a parameter of type Object, while the
 generic
// version takes a type-specific parameter, such as Boolean, Int32,
 or Double.

using System;

class Sample 
{
    public static void Main()
 
    {
    string    nl = Environment.NewLine;
    string    msg = "{0}The following is the result of using
 the generic and non-generic{0}" +
                    "versions of the CompareTo method for
 several base types:{0}";

    DateTime  now = DateTime.Now;
// Time span = 11 days, 22 hours, 33 minutes, 44 seconds
    TimeSpan  tsX = new TimeSpan(11, 22, 33, 44); 
// Version = 1.2.333.4
    Version   versX = new Version("1.2.333.4");  
// Guid = CA761232-ED42-11CE-BACD-00AA0057B223
    Guid      guidX = new Guid("{CA761232-ED42-11CE-BACD-00AA0057B223}");

    Boolean  a1 = true,  a2 = true;
    Byte     b1 = 1,     b2 = 1;
    Int16    c1 = -2,    c2 = 2;
    Int32    d1 = 3,     d2 = 3;
    Int64    e1 = 4,     e2 = -4;
    Decimal  f1 = -5.5m, f2 = 5.5m;
    Single   g1 = 6.6f,  g2 = 6.6f;
    Double   h1 = 7.7d,  h2 = -7.7d;
    Char     i1 = 'A',   i2 = 'A';
    String   j1 = "abc", j2 = "abc";
    DateTime k1 = now,   k2 = now;
    TimeSpan l1 = tsX,   l2 = tsX;
    Version  m1 = versX, m2 = new Version("2.0");
    Guid     n1 = guidX, n2 = guidX;

// The following types are not CLS-compliant.
    SByte    w1 = 8,     w2 = 8;
    UInt16   x1 = 9,     x2 = 9;
    UInt32   y1 = 10,    y2 = 10;
    UInt64   z1 = 11,    z2 = 11;
//
    Console.WriteLine(msg, nl);
    try 
        {
// The second and third Show method call parameters are automatically
 boxed because
// the second and third Show method declaration arguments expect type
 Object.

        Show("Boolean:  ", a1, a2, a1.CompareTo(a2), a1.CompareTo((Object)a2));
        Show("Byte:     ", b1, b2, b1.CompareTo(b2), b1.CompareTo((Object)b2));
        Show("Int16:    ", c1, c2, c1.CompareTo(c2), c1.CompareTo((Object)c2));
        Show("Int32:    ", d1, d2, d1.CompareTo(d2), d1.CompareTo((Object)d2));
        Show("Int64:    ", e1, e2, e1.CompareTo(e2), e1.CompareTo((Object)e2));
        Show("Decimal:  ", f1, f2, f1.CompareTo(f2), f1.CompareTo((Object)f2));
        Show("Single:   ", g1, g2, g1.CompareTo(g2), g1.CompareTo((Object)g2));
        Show("Double:   ", h1, h2, h1.CompareTo(h2), h1.CompareTo((Object)h2));
        Show("Char:     ", i1, i2, i1.CompareTo(i2), i1.CompareTo((Object)i2));
        Show("String:   ", j1, j2, j1.CompareTo(j2), j1.CompareTo((Object)j2));
        Show("DateTime: ", k1, k2, k1.CompareTo(k2), k1.CompareTo((Object)k2));
        Show("TimeSpan: ", l1, l2, l1.CompareTo(l2), l1.CompareTo((Object)l2));
        Show("Version:  ", m1, m2, m1.CompareTo(m2), m1.CompareTo((Object)m2));
        Show("Guid:     ", n1, n2, n1.CompareTo(n2), n1.CompareTo((Object)n2));
//
        Console.WriteLine("{0}The following types are not CLS-compliant:",
 nl);
        Show("SByte:    ", w1, w2, w1.CompareTo(w2), w1.CompareTo((Object)w2));
        Show("UInt16:   ", x1, x2, x1.CompareTo(x2), x1.CompareTo((Object)x2));
        Show("UInt32:   ", y1, y2, y1.CompareTo(y2), y1.CompareTo((Object)y2));
        Show("UInt64:   ", z1, z2, z1.CompareTo(z2), z1.CompareTo((Object)z2));
        }
    catch (Exception e)
        {
        Console.WriteLine(e);
        }
    }

    public static void Show(string
 caption, Object var1, Object var2, 
                            int resultGeneric, int
 resultNonGeneric)
    {
    string relation;

    Console.Write(caption);
    if (resultGeneric == resultNonGeneric) 
        {
        if      (resultGeneric < 0) relation = "less than";
        else if (resultGeneric > 0) relation
 = "greater than";
        else                        relation = "equal to";
        Console.WriteLine("{0} is {1} {2}", var1, relation, var2);
        }

// The following condition will never occur because the generic and
 non-generic
// CompareTo methods are equivalent.

    else
        {
        Console.WriteLine("Generic CompareTo = {0}; non-generic CompareTo =
 {1}", 
                           resultGeneric, resultNonGeneric);
        }
   }
}
/*
This example produces the following results:

The following is the result of using the generic and non-generic
 versions of the
CompareTo method for several base types:

Boolean:  True is equal to True
Byte:     1 is equal to 1
Int16:    -2 is less than 2
Int32:    3 is equal to 3
Int64:    4 is greater than -4
Decimal:  -5.5 is less than 5.5
Single:   6.6 is equal to 6.6
Double:   7.7 is greater than -7.7
Char:     A is equal to A
String:   abc is equal to abc
DateTime: 12/1/2003 5:37:46 PM is equal to 12/1/2003 5:37:46 PM
TimeSpan: 11.22:33:44 is equal to 11.22:33:44
Version:  1.2.333.4 is less than 2.0
Guid:     ca761232-ed42-11ce-bacd-00aa0057b223 is equal to ca761232-ed42-11ce-bacd-00
aa0057b223

The following types are not CLS-compliant:
SByte:    8 is equal to 8
UInt16:   9 is equal to 9
UInt32:   10 is equal to 10
UInt64:   11 is equal to 11
*/
C++
// CompareTo method for several base types.
// The non-generic version takes a parameter of type Object, while the
 generic
// version takes a type-specific parameter, such as Boolean, Int32,
 or Double.
using namespace System;
void Show( String^ caption, Object^ var1, Object^ var2, int
 resultGeneric, int resultNonGeneric )
{
   String^ relation;
   Console::Write( caption );
   if ( resultGeneric == resultNonGeneric )
   {
      if ( resultGeneric < 0 )
            relation = "less than";
      else
      if ( resultGeneric > 0 )
            relation = "greater than";
      else
            relation = "equal to";
      Console::WriteLine( "{0} is {1} {2}", var1, relation, var2 );
   }
   // The following condition will never occur because the generic and
 non-generic
   // CompareTo methods are equivalent.
   else
   {
      Console::WriteLine( "Generic CompareTo = {0}; non-generic CompareTo =
 {1}", resultGeneric, resultNonGeneric );
   }
}

int main()
{
   String^ nl = Environment::NewLine;
   String^ msg = "{0}The following is the result of using
 the generic and non-generic{0}"
   "versions of the CompareTo method for several base
 types:{0}";
   Object^ obj; // An Object used to insure CompareTo(Object) is called.

   DateTime now = DateTime::Now;
   
   // Time span = 11 days, 22 hours, 33 minutes, 44 seconds
   TimeSpan tsX = TimeSpan(11,22,33,44);
   
   // Version = 1.2.333.4
   Version^ versX = gcnew Version(  "1.2.333.4" );
   
   // Guid = CA761232-ED42-11CE-BACD-00AA0057B223
   Guid guidX = Guid( "{CA761232-ED42-11CE-BACD-00AA0057B223}");
   Boolean a1 = true,a2 = true;
   Byte b1 = 1,b2 = 1;
   Int16 c1 = -2,c2 = 2;
   Int32 d1 = 3,d2 = 3;
   Int64 e1 = 4,e2 = -4;
   Decimal f1 = Decimal(-5.5), f2 = Decimal(5.5);
   Single g1 = 6.6f,g2 = 6.6f;
   Double h1 = 7.7,h2 = -7.7;
   Char i1 = 'A',i2 = 'A';
   String^ j1 = "abc", ^j2 = "abc";
   DateTime k1 = now,k2 = now;
   TimeSpan l1 = tsX,l2 = tsX;
   Version^ m1 = versX, ^m2 = gcnew Version(  "2.0" );
   Guid n1 = guidX,n2 = guidX;
   
   // The following types are not CLS-compliant.
   SByte w1 = 8,w2 = 8;
   UInt16 x1 = 9,x2 = 9;
   UInt32 y1 = 10,y2 = 10;
   UInt64 z1 = 11,z2 = 11;
   
   //
   Console::WriteLine( msg, nl );
   try
   {
      Show( "Boolean: ", a1, a2, a1.CompareTo( a2 ), a1.CompareTo( a2 )
 );
      Show( "Byte:    ", b1, b2, b1.CompareTo( b2 ), b1.CompareTo( b2 )
 );
      Show( "Int16:   ", c1, c2, c1.CompareTo( c2 ), c1.CompareTo( c2 )
 );
      Show( "Int32:   ", d1, d2, d1.CompareTo( d2 ), d1.CompareTo( d2 )
 );
      Show( "Int64:   ", e1, e2, e1.CompareTo( e2 ), e1.CompareTo( e2 )
 );
      Show( "Decimal: ", f1, f2, f1.CompareTo( f2 ), f1.CompareTo( f2 )
 );
      Show( "Single:  ", g1, g2, g1.CompareTo( g2 ), g1.CompareTo( g2 )
 );
      Show( "Double:  ", h1, h2, h1.CompareTo( h2 ), h1.CompareTo( h2 )
 );
      Show( "Char:    ", i1, i2, i1.CompareTo( i2 ), i1.CompareTo( i2 )
 );
      
      // Use an anonymous object to hide the String object.
      obj = j2;
      Show( "String:  ", j1, j2, j1->CompareTo( j2 ), j1->CompareTo(
 obj ) );
      Show( "DateTime:", k1, k2, k1.CompareTo( k2 ), k1.CompareTo( k2 )
 );
      Show(  "TimeSpan: ", l1, l2, l1.CompareTo( l2 ), l1.CompareTo( l2
 ) );
      
      // Use an anonymous object to hide the Version object.
      obj = m2;
      Show(  "Version:  ", m1, m2, m1->CompareTo( m2 ), m1->CompareTo(
 obj ) );
      Show(  "Guid:     ", n1, n2, n1.CompareTo( n2 ), n1.CompareTo( n2
 ) );
      
      //
      Console::WriteLine( "{0}The following types are not CLS-compliant:",
 nl );
      Show( "SByte:   ", w1, w2, w1.CompareTo( w2 ), w1.CompareTo( w2 )
 );
      Show( "UInt16:  ", x1, x2, x1.CompareTo( x2 ), x1.CompareTo( x2 )
 );
      Show( "UInt32:  ", y1, y2, y1.CompareTo( y2 ), y1.CompareTo( y2 )
 );
      Show( "UInt64:  ", z1, z2, z1.CompareTo( z2 ), z1.CompareTo( z2 )
 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e );
   }

}

/*
This example produces the following results:

The following is the result of using the generic and non-generic
 versions of the
CompareTo method for several base types:

Boolean:  True is equal to True
Byte:     1 is equal to 1
Int16:    -2 is less than 2
Int32:    3 is equal to 3
Int64:    4 is greater than -4
Decimal:  -5.5 is less than 5.5
Single:   6.6 is equal to 6.6
Double:   7.7 is greater than -7.7
Char:     A is equal to A
String:   abc is equal to abc
DateTime: 12/1/2003 5:37:46 PM is equal to 12/1/2003 5:37:46 PM
TimeSpan: 11.22:33:44 is equal to 11.22:33:44
Version:  1.2.333.4 is less than 2.0
Guid:     ca761232-ed42-11ce-bacd-00aa0057b223 is equal to ca761232-ed42-11ce-bacd-00
aa0057b223

The following types are not CLS-compliant:
SByte:    8 is equal to 8
UInt16:   9 is equal to 9
UInt32:   10 is equal to 10
UInt64:   11 is equal to 11
*/
J#
// This example demonstrates the generic and non-generic versions of
 the 
// CompareTo method for several base types.
// The non-generic version takes a parameter of type Object, while the
 generic
// version takes a type-specific parameter, such as Boolean, Int32,
 or Double.

import System.*;

class Sample
{
    public static void main(String[]
 args)
    {
        String nl = Environment.get_NewLine();
        String msg = "{0}The following is the result of using
 the generic and"
            +" non-generic{0}versions of the CompareTo method for"
            +" several base types:{0}";

        DateTime now = DateTime.get_Now();

        // Time span = 11 days, 22 hours, 33 minutes, 44 seconds
        TimeSpan tsX = new TimeSpan(11, 22, 33, 44);

        // Version = 1.2.333.4
        Version versX = new Version("1.2.333.4");

        // Guid = CA761232-ED42-11CE-BACD-00AA0057B223
        Guid guidX = new Guid("{CA761232-ED42-11CE-BACD-00AA0057B223}");

        System.Boolean a1 = true,a2 = true;
        System.Byte b1 = (System.Byte)1,b2 =(System.Byte)1;
        Int16 c1 = (System.Int16)(-2),c2 = (System.Int16)2;
        Int32 d1 = (System.Int32)3,d2 = (System.Int32)3;
        Int64 e1 = (System.Int64)4,e2 = (System.Int64)(-4);
        Decimal f1 = new Decimal(-5.5),f2 = new
 Decimal(5.5);
        Single g1 = (System.Single)6.6,g2 = (System.Single)6.6;
        System.Double h1 = (System.Double)7.7,h2 = (System.Double)(-7.7);
        System.Char i1 = (System.Char)'A',i2 = (System.Char)'A';;
        String j1 = "abc", j2 = "abc";
        DateTime k1 = now, k2 = now;
        TimeSpan l1 = tsX, l2 = tsX;
        Version m1 = versX, m2 = new Version("2.0");
        Guid n1 = guidX, n2 = guidX;

        // The following types are not CLS-compliant.
        SByte w1 = (System.SByte)8,w2 = (System.SByte)8;
        UInt16 x1 = (System.UInt16)9,x2 = (System.UInt16)9;
        UInt32 y1 = (System.UInt32)10,y2 = (System.UInt32)10;
        UInt64 z1 = (System.UInt64)11,z2 = (System.UInt64)11;
        //
        Console.WriteLine(msg, nl);
        try {
            // The second and third Show method call parameters are
            // automatically boxed because the second and third Show
 method
            // declaration arguments expect type Object.
            Show("Boolean:  ", a1, a2, a1.CompareTo(a2),
                a1.CompareTo((Object)a2));
            Show("Byte:     ", b1, b2, b1.CompareTo(b2),
                b1.CompareTo((Object)b2));
            Show("Int16:    ", c1, c2, c1.CompareTo(c2), 
                c1.CompareTo((Object)c2));
            Show("Int32:    ", d1, d2, d1.CompareTo(d2),
                d1.CompareTo((Object)d2));
            Show("Int64:    ", e1, e2, e1.CompareTo(e2),
                e1.CompareTo(((Object)e2)));
            Show("Decimal:  ", f1, f2, f1.CompareTo(f2),
                f1.CompareTo((Object)f2));
            Show("Single:   ", g1, g2, g1.CompareTo(g2),
                g1.CompareTo((Object)g2));
            Show("Double:   ", h1, h2, h1.CompareTo(h2),
                h1.CompareTo((Object)h2));
            Show("Char:     ", i1, i2, i1.CompareTo(i2), 
                i1.CompareTo(((Object)i2)));
            Show("String:   ", j1, j2, j1.CompareTo(j2),
                j1.CompareTo((Object)j2));
            Show("DateTime: ", k1, k2, k1.CompareTo(k2),
                k1.CompareTo((Object)(k2)));
            Show("TimeSpan: ", l1, l2, l1.CompareTo(l2),
                l1.CompareTo((Object)l2));
            Show("Version:  ", m1, m2, m1.CompareTo(m2), 
                m1.CompareTo((Object)m2));
            Show("Guid:     ", n1, n2, n1.CompareTo(n2), 
                n1.CompareTo((Object)n2));
            //
            Console.WriteLine(
                "{0}The following types are not CLS-compliant:", nl);
            Show("SByte:    ", w1, w2, w1.CompareTo(w2),
                w1.CompareTo((Object)w2));
            Show("UInt16:   ", x1, x2, x1.CompareTo(x2), 
                x1.CompareTo((Object)x2));
            Show("UInt32:   ", y1, y2, y1.CompareTo(y2),
                y1.CompareTo((Object)y2));
            Show("UInt64:   ", z1, z2, z1.CompareTo(z2),
                z1.CompareTo((Object)z2));
        }
        catch (System.Exception e) {
            Console.WriteLine(e);
        }
    } //main

    public static void Show(String
 caption, Object var1, Object var2,
        int resultGeneric, int resultNonGeneric)
    {
        String relation;

        Console.Write(caption);
        if (resultGeneric == resultNonGeneric) {
            if (resultGeneric < 0) {
                relation = "less than";
            }
            else {
                if (resultGeneric > 0) {
                    relation = "greater than";
                }
                else {
                    relation = "equal to";
                }
            }
            Console.WriteLine("{0} is {1} {2}", var1, relation, var2);
        }
        // The following condition will never occur because the generic
 and 
        // non-generic CompareTo methods are equivalent.
        else {
            Console.WriteLine("Generic CompareTo = {0};"
                +" non-generic CompareTo = {1}",
                System.Convert.ToString(resultGeneric),
                System.Convert.ToString(resultNonGeneric));
        }
    } //Show
} //Sample
/*
This example produces the following results:

The following is the result of using the generic and non-generic
 versions of the
CompareTo method for several base types:

Boolean:  True is equal to True
Byte:     1 is equal to 1
Int16:    -2 is less than 2
Int32:    3 is equal to 3
Int64:    4 is greater than -4
Decimal:  -5.5 is less than 5.5
Single:   6.6 is equal to 6.6
Double:   7.7 is greater than -7.7
Char:     A is equal to A
String:   abc is equal to abc
DateTime: 12/1/2003 5:37:46 PM is equal to 12/1/2003 5:37:46 PM
TimeSpan: 11.22:33:44 is equal to 11.22:33:44
Version:  1.2.333.4 is less than 2.0
Guid:     ca761232-ed42-11ce-bacd-00aa0057b223 is equal to ca761232-ed42
-11ce-bacd-00aa0057b223

The following types are not CLS-compliant:
SByte:    8 is equal to 8
UInt16:   9 is equal to 9
UInt32:   10 is equal to 10
UInt64:   11 is equal to 11
*/
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間
Compare
CompareOrdinal

String.CompareTo メソッド (Object)

このインスタンスと、指定した Object を比較します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Function CompareTo ( _
    value As Object _
) As Integer
Visual Basic (使用法)
Dim instance As String
Dim value As Object
Dim returnValue As Integer

returnValue = instance.CompareTo(value)
C#
public int CompareTo (
    Object value
)
C++
public:
virtual int CompareTo (
    Object^ value
) sealed
J#
public final int CompareTo (
    Object value
)
JScript
public final function CompareTo (
    value : Object
) : int

パラメータ

value

String に評価される Object。

戻り値
2 つの比較対照値の構文上の関係を示す 32 ビット符号付き整数。

値

条件

0 より小さい値

このインスタンスは、value よりも小さくなっています。

0

このインスタンスは value と等価です。

0 より大きい値

このインスタンスは value よりも大きくなっています。

または

value が null 参照 (Visual Basic では Nothing) です。

例外例外
例外の種類条件

ArgumentException

value が String ではありません。

解説解説

value は String オブジェクトである必要があります。

このメソッドは、現在のカルチャを使用して、単語 (大文字/小文字を区別し、カルチャに依存した) 比較を実行します。単語、文字列、序数の並べ替えの詳細については、「System.Globalization.CompareOptions」を参照してください。

このメソッドの動作の詳細については、Compare メソッドの解説を参照してください。

使用例使用例

CompareTo メソッドを Object と共に使用する方法については、次のコード例を参照してください。

Visual Basic
Imports System

Public Class [MyClass]
End Class '[MyClass]

Public Class ArgExceptionExample
   
   Public Shared Sub Main()
      Dim my As New [MyClass]()
      Dim s As String =
 "sometext"
      Try
         Dim i As Integer
 = s.CompareTo(my)
      Catch e As Exception
         Console.WriteLine("Error: {0}", e.ToString())
      End Try
   End Sub 'Main
End Class 'ArgExceptionExample
C#
using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static void Main()
      {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
         {
         int i = s.CompareTo(my);
         }
            catch (Exception e) 
            {
            Console.WriteLine("Error: {0}",e.ToString());
            }
      }
}
C++
using namespace System;
public ref class MyClass{};

int main()
{
   MyClass^ my = gcnew MyClass;
   String^ s = "sometext";
   try
   {
      int i = s->CompareTo( my );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error: {0}", e->ToString() );
   }

}
J#
import System.*;

public class MyClass
{
} //MyClass

public class ArgExceptionExample
{
    public static void main(String[]
 args)
    {
        MyClass my = new MyClass();
        String s = "sometext";
        try {
            int i = s.CompareTo(my);
        }
        catch (System.Exception e) {
            Console.WriteLine("Error: {0}", e.ToString());
        }
    } //main
} //ArgExceptionExample
JScript
import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function
 Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間
Compare
CompareOrdinal

String.CompareTo メソッド

指定したオブジェクトまたは String とこのインスタンスを比較し、これらの相対値を示す値を返します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
String.CompareTo (Object) このインスタンスと、指定した Object を比較します。

.NET Compact Framework によってサポートされています。

String.CompareTo (String) このインスタンスと、指定した String オブジェクトを比較します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

String クラス
String メンバ
System 名前空間
Compare
CompareOrdinal

急上昇のことば

四宮ありす
救出
たまゆら
確かに
倫理観
このページでは「.NET Framework クラス ライブラリ リファレンス」からString.CompareToを検索した結果を表示しています。
Weblioに収録されているすべての辞書からString.CompareToを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からString.CompareTo を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「String.CompareTo」の関連用語

1
String.CompareTo メソッド
.NET Framework クラス ライブラリ リファレンス
96% |||||

2
Exception.ToString メソッド
.NET Framework クラス ライブラリ リファレンス
14% |||||

String.CompareToのお隣キーワード

String.Compare メソッド

String.CompareOrdinal メソッド

String.CompareTo

String.CompareTo メソッド

StringCollection メソッド

StringCollection メンバ

StringComparer クラス

StringComparer コンストラクタ

StringComparer プロパティ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


String.CompareToのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS