String.CompareOrdinal 方法

定义

命名空间:

System

程序集:

netstandard.dll, System.Runtime.dll

通过计算每个字符串中相应 String 对象的数值来比较两个 Char 对象。

重载

CompareOrdinal(String, String)	通过计算每个字符串中相应 String 对象的数值来比较两个指定的 Char 对象。
CompareOrdinal(String, Int32, String, Int32, Int32)	通过计算每个子字符串中相应 String 对象的数值来比较两个指定的 Char 对象的子字符串。

CompareOrdinal(String, String)

Source:

String.Comparison.cs

通过计算每个字符串中相应 String 对象的数值来比较两个指定的 Char 对象。

C#

public static int CompareOrdinal(string? strA, string? strB);

参数

strA

String

要比较的第一个字符串。

strB

String

要比较的第二个字符串。

返回

Int32

一个整数，指示两个比较字之间的词法关系。

“值”	条件
小于零	strA 小于 strB。
零	strA 与 strB 相等。
大于零	strA 大于 strB。

示例

以下示例对两个字符串执行和序号比较，这些字符串仅在大小写上不同。

C#

// Sample for String.CompareOrdinal(String, String)
using System;

class Sample {
    public static void Main() {
    String str1 = "ABCD";
    String str2 = "abcd";
    String str;
    int result;

    Console.WriteLine();
    Console.WriteLine("Compare the numeric values of the corresponding Char objects in each string.");
    Console.WriteLine("str1 = '{0}', str2 = '{1}'", str1, str2);
    result = String.CompareOrdinal(str1, str2);
    str = ((result < 0) ? "less than" : ((result > 0) ? "greater than" : "equal to"));
    Console.Write("String '{0}' is ", str1);
    Console.Write("{0} ", str);
    Console.WriteLine("String '{0}'.", str2);
    }
}
/*
This example produces the following results:

Compare the numeric values of the corresponding Char objects in each string.
str1 = 'ABCD', str2 = 'abcd'
String 'ABCD' is less than String 'abcd'.
*/

注解

此方法使用序号排序规则执行区分大小写的比较。 有关单词、字符串和序号排序的详细信息，请参阅 System.Globalization.CompareOptions。 若要使用序号排序规则执行不区分大小写的比较，请调用 方法，Compare(String, String, StringComparison)comparisonType并将 参数设置为 StringComparison.OrdinalIgnoreCase。

因为 CompareOrdinal(String, String) 是静态方法， strA 并且可以 strB 是 null。 如果两个值为 null，则该方法返回 0 (零) ，这指示 strA 和 strB 相等。 如果只有一个值是 null，则该方法认为非 null 值更大。

另请参阅

• Int32
• Compare(String, String)
• CompareTo(Object)

CompareOrdinal(String, Int32, String, Int32, Int32)

Source:

String.Comparison.cs

通过计算每个子字符串中相应 String 对象的数值来比较两个指定的 Char 对象的子字符串。

C#

public static int CompareOrdinal(string? strA, int indexA, string? strB, int indexB, int length);

参数

strA

String

要在比较中使用的第一个字符串。

indexA

Int32

strA 中子字符串的起始索引。

strB

String

要在比较中使用的第二个字符串。

indexB

Int32

strB 中子字符串的起始索引。

length

Int32

要比较的子字符串中字符的最大数量。

返回

Int32

一个 32 位带符号整数，指示两个比较数之间的词法关系。

“值”	条件
小于零	strA 中的子字符串小于 strB 中的子字符串。
零	子字符串相等，或者 length 为零。
大于零	strA 中的子字符串大于 strB 中的子字符串。

例外

ArgumentOutOfRangeException

strA 不为 null ，且 indexA 大于 strA.Length。

或

strB 不为 null ，且 indexB 大于 strB.Length。

或

indexA、indexB 或 length 为负数。

示例

以下示例演示和 CompareOrdinalCompare 使用不同的排序顺序。

C#

using System;
using System.Globalization;

class Test
{
    public static void Main(String[] args)
    {
    String strLow = "abc";
    String strCap = "ABC";
    String result = "equal to ";
    int x = 0;
    int pos = 1;

// The Unicode codepoint for 'b' is greater than the codepoint for 'B'.
    x = String.CompareOrdinal(strLow, pos, strCap, pos, 1);
    if (x < 0) result = "less than";
    if (x > 0) result = "greater than";
    Console.WriteLine("CompareOrdinal(\"{0}\"[{2}], \"{1}\"[{2}]):", strLow, strCap, pos);
    Console.WriteLine("   '{0}' is {1} '{2}'", strLow[pos], result, strCap[pos]);

// In U.S. English culture, 'b' is linguistically less than 'B'.
    x = String.Compare(strLow, pos, strCap, pos, 1, false, new CultureInfo("en-US"));
    if (x < 0) result = "less than";
    else if (x > 0) result = "greater than";
    Console.WriteLine("Compare(\"{0}\"[{2}], \"{1}\"[{2}]):", strLow, strCap, pos);
    Console.WriteLine("   '{0}' is {1} '{2}'", strLow[pos], result, strCap[pos]);
    }
}

注解

indexA、 indexB和 length 参数必须是非否定的。

比较的字符数是长度越少越strA少， 长度strB越少indexB， 和 lengthindexA。

此方法使用序号排序规则执行区分大小写的比较。 有关单词、字符串和序号排序的详细信息，请参阅 System.Globalization.CompareOptions。 若要使用序号排序规则执行不区分大小写的比较，请调用 方法，Compare(String, Int32, String, Int32, Int32, StringComparison)comparisonType并将 参数设置为 StringComparison.OrdinalIgnoreCase。

因为 CompareOrdinal(String, String) 是静态方法， strA 并且可以 strB 是 null。 如果两个值为 null，则该方法返回 0 (零) ，这指示 strA 和 strB 相等。 如果只有一个值是 null，则该方法认为非 null 值更大。

另请参阅

• Compare(String, String)
• CompareTo(Object)
• Int32