Baca dalam bahasa Inggris

Bagikan melalui


String.CompareOrdinal Metode

Definisi

Membandingkan dua String objek dengan mengevaluasi nilai numerik objek terkait Char di setiap string.

Overload

CompareOrdinal(String, String)

Membandingkan String dua objek tertentu dengan mengevaluasi nilai numerik objek terkait Char di setiap string.

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

Membandingkan substring dari dua objek tertentu String dengan mengevaluasi nilai numerik objek terkait Char di setiap substring.

CompareOrdinal(String, String)

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Membandingkan String dua objek tertentu dengan mengevaluasi nilai numerik objek terkait Char di setiap string.

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

Parameter

strA
String

String pertama yang dibandingkan.

strB
String

String kedua untuk dibandingkan.

Mengembalikan

Bilangan bulat yang menunjukkan hubungan leksikal antara dua perbandingan.

Nilai Kondisi
Kurang dari nol strA kurang dari strB.
Nol strA dan strB sama.
Lebih besar dari nol strA lebih besar dari strB.

Contoh

Contoh berikut melakukan perbandingan ordinal dari dua string yang hanya berbeda dalam kasus.

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'.
*/

Keterangan

Metode ini melakukan perbandingan peka huruf besar/kecil menggunakan aturan pengurutan ordinal. Untuk informasi selengkapnya tentang pengurutan kata, string, dan ordinal, lihat System.Globalization.CompareOptions. Untuk melakukan perbandingan yang tidak peka huruf besar/kecil menggunakan aturan pengurutan ordinal, panggil Compare(String, String, StringComparison) metode dengan argumen yang comparisonType diatur ke StringComparison.OrdinalIgnoreCase.

Karena CompareOrdinal(String, String) merupakan metode statis, strA dan strB dapat berupa null. Jika kedua nilai adalah null, metode mengembalikan 0 (nol), yang menunjukkan bahwa strA dan strB sama. Jika hanya salah satu nilai , nullmetode menganggap nilai non-null lebih besar.

Lihat juga

Berlaku untuk

.NET 10 dan versi lainnya
Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Membandingkan substring dari dua objek tertentu String dengan mengevaluasi nilai numerik objek terkait Char di setiap substring.

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

Parameter

strA
String

String pertama yang digunakan dalam perbandingan.

indexA
Int32

Indeks awal substring di strA.

strB
String

String kedua yang digunakan dalam perbandingan.

indexB
Int32

Indeks awal substring di strB.

length
Int32

Jumlah maksimum karakter dalam substring yang akan dibandingkan.

Mengembalikan

Bilangan bulat bertanda 32-bit yang menunjukkan hubungan leksikal antara kedua comparands.

Nilai Kondisi
Kurang dari nol Substring di strA kurang dari substring di strB.
Nol Substring sama, atau length nol.
Lebih besar dari nol Substring di strA lebih besar dari substring di strB.

Pengecualian

strA tidak null dan indexA lebih besar dari strA.Length.

-atau-

strB tidak null dan indexB lebih besar dari strB.Length.

-atau-

indexA, indexB, atau length negatif.

Contoh

Contoh berikut menunjukkan bahwa CompareOrdinal dan Compare menggunakan urutan pengurutan yang berbeda.

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]);
    }
}

Keterangan

Parameter indexA, indexB, dan length harus nonnegative.

Jumlah karakter yang dibandingkan adalah lebih sedikit dari panjang strA kurang , panjang strB lebih sedikit indexB, dan lengthindexA.

Metode ini melakukan perbandingan peka huruf besar/kecil menggunakan aturan pengurutan ordinal. Untuk informasi selengkapnya tentang pengurutan kata, string, dan ordinal, lihat System.Globalization.CompareOptions. Untuk melakukan perbandingan yang tidak peka huruf besar/kecil menggunakan aturan pengurutan ordinal, panggil Compare(String, Int32, String, Int32, Int32, StringComparison) metode dengan argumen yang comparisonType diatur ke StringComparison.OrdinalIgnoreCase.

Karena CompareOrdinal(String, String) merupakan metode statis, strA dan strB dapat berupa null. Jika kedua nilai adalah null, metode mengembalikan 0 (nol), yang menunjukkan bahwa strA dan strB sama. Jika hanya salah satu nilai , nullmetode menganggap nilai non-null lebih besar.

Lihat juga

Berlaku untuk

.NET 10 dan versi lainnya
Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0