CompareInfo.IsSuffix Metoda

Definice

Obor názvů:

System.Globalization

Sestavení:

netstandard.dll, System.Runtime.dll

Určuje, zda řetězec končí konkrétní příponou.

Přetížení

Name	Description
IsSuffix(String, String)	Určuje, zda zadaný zdrojový řetězec končí zadanou příponou.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Určuje, zda rozsah znaků určený jen pro čtení končí konkrétní příponou.
IsSuffix(String, String, CompareOptions)	Určuje, zda zadaný zdrojový řetězec končí zadanou příponou pomocí zadané CompareOptions hodnoty.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Určuje, zda řetězec končí konkrétní příponou.

IsSuffix(String, String)

Zdroj:

CompareInfo.cs

Určuje, zda zadaný zdrojový řetězec končí zadanou příponou.

public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix);

public bool IsSuffix(string source, string suffix);

member this.IsSuffix : string * string -> bool

Public Function IsSuffix (source As String, suffix As String) As Boolean

Parametry

source

String

Řetězec, ve který se má hledat.

suffix

String

Řetězec, který se má porovnat s koncem .source

Návraty

Boolean

true je-li délka suffix menší než nebo rovna délce source a source končí na suffix; jinak , false.

Výjimky

ArgumentNullException

source je null.

nebo

suffix je null.

Příklady

Následující příklad určuje, zda řetězec je předpona nebo přípona jiného řetězce.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "llegar";
      String myXfix = "lle";

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myComp = CultureInfo.InvariantCulture.CompareInfo;

      // Determines whether myXfix is a prefix of "calle" and "llegar".
      Console.WriteLine( "IsPrefix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsPrefix( myStr1, myXfix ) );
      Console.WriteLine( "IsPrefix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsPrefix( myStr2, myXfix ) );

      // Determines whether myXfix is a suffix of "calle" and "llegar".
      Console.WriteLine( "IsSuffix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsSuffix( myStr1, myXfix ) );
      Console.WriteLine( "IsSuffix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsSuffix( myStr2, myXfix ) );
   }
}


/*
This code produces the following output.

IsPrefix( calle, lle ) : False
IsPrefix( llegar, lle ) : True
IsSuffix( calle, lle ) : True
IsSuffix( llegar, lle ) : False

*/

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "llegar"
      Dim myXfix As [String] = "lle"

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myComp As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      ' Determines whether myXfix is a prefix of "calle" and "llegar".
      Console.WriteLine("IsPrefix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsPrefix(myStr1, myXfix))
      Console.WriteLine("IsPrefix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsPrefix(myStr2, myXfix))

      ' Determines whether myXfix is a suffix of "calle" and "llegar".
      Console.WriteLine("IsSuffix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsSuffix(myStr1, myXfix))
      Console.WriteLine("IsSuffix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsSuffix(myStr2, myXfix))

   End Sub

End Class


'This code produces the following output.
'
'IsPrefix( calle, lle ) : False
'IsPrefix( llegar, lle ) : True
'IsSuffix( calle, lle ) : True
'IsSuffix( llegar, lle ) : False

Poznámky

Každý řetězec začíná a končí prázdným podřetězcem (""); proto pokud suffix je prázdný řetězec, tato metoda vrátí true.

Note

Pokud je to možné, měli byste volat metody porovnání řetězců, které mají parametr typu CompareOptions k určení druhu očekávaného porovnání. Obecně platí, že pro porovnávání řetězců zobrazených v uživatelském rozhraní použijte jazykové volby (s využitím aktuální kultury) a zadejte CompareOptions.Ordinal nebo CompareOptions.OrdinalIgnoreCase pro bezpečnostní porovnání.

Viz také

• IsPrefix(String, String, CompareOptions)

IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Zdroj:

CompareInfo.cs

Určuje, zda rozsah znaků určený jen pro čtení končí konkrétní příponou.

public bool IsSuffix(ReadOnlySpan<char> source, ReadOnlySpan<char> suffix, System.Globalization.CompareOptions options = System.Globalization.CompareOptions.None);

member this.IsSuffix : ReadOnlySpan<char> * ReadOnlySpan<char> * System.Globalization.CompareOptions -> bool

Public Function IsSuffix (source As ReadOnlySpan(Of Char), suffix As ReadOnlySpan(Of Char), Optional options As CompareOptions = System.Globalization.CompareOptions.None) As Boolean

Parametry

source

ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, které se mají prohledávat.

suffix

ReadOnlySpan<Char>

Přípona, která se pokusí shodovat na konci .source

options

CompareOptions

Volitelná kombinace hodnot výčtu CompareOptions , které se mají použít během shody. Výchozí hodnota je None.

Návraty

Boolean

true dojde-li suffix na konci source; jinak , false.

Výjimky

ArgumentException

options obsahuje nepodporovanou kombinaci příznaků.

IsSuffix(String, String, CompareOptions)

Zdroj:

CompareInfo.cs

Určuje, zda zadaný zdrojový řetězec končí zadanou příponou pomocí zadané CompareOptions hodnoty.

public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix, System::Globalization::CompareOptions options);

public bool IsSuffix(string source, string suffix, System.Globalization.CompareOptions options);

member this.IsSuffix : string * string * System.Globalization.CompareOptions -> bool

Public Function IsSuffix (source As String, suffix As String, options As CompareOptions) As Boolean

Parametry

source

String

Řetězec, ve který se má hledat.

suffix

String

Řetězec, který se má porovnat s koncem .source

options

CompareOptions

Hodnota, která definuje, jak source a suffix má být porovnána. optionsje buď hodnota Ordinal výčtu použitá samostatně, nebo bitová kombinace jedné nebo více následujících hodnot: IgnoreCase, , IgnoreSymbols, IgnoreNonSpaceIgnoreWidtha IgnoreKanaType.

Návraty

Boolean

true je-li délka suffix menší než nebo rovna délce source a source končí na suffix; jinak , false.

Výjimky

ArgumentNullException

source je null.

nebo

suffix je null.

ArgumentException

options obsahuje neplatnou CompareOptions hodnotu.

Příklady

Následující příklad určuje, zda řetězec je předpona nebo přípona jiného řetězce pomocí CompareOptions.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "llegar";
      String myXfix = "LLE";

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myComp = CultureInfo.InvariantCulture.CompareInfo;

      Console.WriteLine( "IsSuffix \"{0}\", \"{1}\"", myStr1, myXfix );
      Console.WriteLine( "   With no CompareOptions            : {0}", myComp.IsSuffix( myStr1, myXfix ) );
      Console.WriteLine( "   With None                         : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.None ) );
      Console.WriteLine( "   With Ordinal                      : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.Ordinal ) );
      Console.WriteLine( "   With IgnoreCase                   : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.IgnoreCase ) );

      Console.WriteLine( "IsPrefix \"{0}\", \"{1}\"", myStr2, myXfix );
      Console.WriteLine( "   With no CompareOptions            : {0}", myComp.IsPrefix( myStr2, myXfix ) );
      Console.WriteLine( "   With None                         : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.None ) );
      Console.WriteLine( "   With Ordinal                      : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.Ordinal ) );
      Console.WriteLine( "   With IgnoreCase                   : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.IgnoreCase ) );
   }
}


/*
This code produces the following output.

IsSuffix "calle", "LLE"
   With no CompareOptions            : False
   With None                         : False
   With Ordinal                      : False
   With IgnoreCase                   : True
IsPrefix "llegar", "LLE"
   With no CompareOptions            : False
   With None                         : False
   With Ordinal                      : False
   With IgnoreCase                   : True

*/

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "llegar"
      Dim myXfix As [String] = "LLE"

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myComp As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      Console.WriteLine("IsSuffix ""{0}"", ""{1}""", myStr1, myXfix)
      Console.WriteLine("   With no CompareOptions            : {0}", myComp.IsSuffix(myStr1, myXfix))
      Console.WriteLine("   With None                         : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.None))
      Console.WriteLine("   With Ordinal                      : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.Ordinal))
      Console.WriteLine("   With IgnoreCase                   : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.IgnoreCase))

      Console.WriteLine("IsPrefix ""{0}"", ""{1}""", myStr2, myXfix)
      Console.WriteLine("   With no CompareOptions            : {0}", myComp.IsPrefix(myStr2, myXfix))
      Console.WriteLine("   With None                         : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.None))
      Console.WriteLine("   With Ordinal                      : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.Ordinal))
      Console.WriteLine("   With IgnoreCase                   : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.IgnoreCase))

   End Sub

End Class


'This code produces the following output.
'
'IsSuffix "calle", "LLE"
'   With no CompareOptions            : False
'   With None                         : False
'   With Ordinal                      : False
'   With IgnoreCase                   : True
'IsPrefix "llegar", "LLE"
'   With no CompareOptions            : False
'   With None                         : False
'   With Ordinal                      : False
'   With IgnoreCase                   : True

Poznámky

Každý řetězec začíná a končí prázdným podřetězcem (""); proto pokud suffix je prázdný řetězec, tato metoda vrátí true.

Hodnoty CompareOptions.NumericOrdering a CompareOptions.StringSort hodnoty nejsou pro tuto metodu platné.

Note

Pokud je to možné, měli byste volat metody porovnání řetězců, které mají parametr typu CompareOptions k určení druhu očekávaného porovnání. Obecně platí, že pro porovnávání řetězců zobrazených v uživatelském rozhraní použijte jazykové volby (s využitím aktuální kultury) a zadejte CompareOptions.Ordinal nebo CompareOptions.OrdinalIgnoreCase pro bezpečnostní porovnání.

Viz také

• IsPrefix(String, String, CompareOptions)
• CompareOptions

IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Zdroj:

CompareInfo.cs

Určuje, zda řetězec končí konkrétní příponou.

public:
 bool IsSuffix(ReadOnlySpan<char> source, ReadOnlySpan<char> suffix, System::Globalization::CompareOptions options, [Runtime::InteropServices::Out] int % matchLength);

public bool IsSuffix(ReadOnlySpan<char> source, ReadOnlySpan<char> suffix, System.Globalization.CompareOptions options, out int matchLength);

member this.IsSuffix : ReadOnlySpan<char> * ReadOnlySpan<char> * System.Globalization.CompareOptions * int -> bool

Public Function IsSuffix (source As ReadOnlySpan(Of Char), suffix As ReadOnlySpan(Of Char), options As CompareOptions, ByRef matchLength As Integer) As Boolean

Parametry

source

ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, které se mají prohledávat.

suffix

ReadOnlySpan<Char>

Rozsah znaků obsahujících příponu, která se má na konci sourcesouboru shodovat, je jen pro čtení.

options

CompareOptions

Použití CompareOptions během zápasu.

matchLength

Int32

Pokud tato metoda vrátí, obsahuje počet znaků source , které odpovídaly požadované příponě. Může se lišit od délky suffix , pokud se provede lingvistické porovnání. Pokud se přípona neshodovala, nastavte na hodnotu 0.

Návraty

Boolean

true dojde-li suffix na konci source; jinak , false.

Výjimky

ArgumentException

options obsahuje nepodporovanou kombinaci příznaků.

Poznámky

Tato metoda má větší režii než jiná IsSuffix(String, String, CompareOptions) přetížení, která nepřebírají matchLength argument. Toto přetížení zavolejte pouze v případě, že požadujete informace o délce shody.