CompareInfo.IsSuffix Methode

Definition

Bestimmt, ob eine Zeichenfolge mit einem angegebenen Suffix endet.Determines whether a string ends with a specific suffix.

Überlädt

IsSuffix(String, String)

Bestimmt, ob die angegebene Quellzeichenfolge mit dem angegebenen Suffix endet.Determines whether the specified source string ends with the specified suffix.

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

Bestimmt, ob eine schreibgeschützte Zeichenspanne mit einem bestimmten Suffix endet.Determines whether a read-only span of characters ends with a specific suffix.

IsSuffix(String, String, CompareOptions)

Bestimmt mithilfe des angegebenenCompareOptions-Werts, ob die angegebene Quellzeichenfolge mit dem angegebenen Suffix endet.Determines whether the specified source string ends with the specified suffix using the specified CompareOptions value.

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

Bestimmt, ob eine Zeichenfolge mit einem angegebenen Suffix endet.Determines whether a string ends with a specific suffix.

IsSuffix(String, String)

Bestimmt, ob die angegebene Quellzeichenfolge mit dem angegebenen Suffix endet.Determines whether the specified source string ends with the specified suffix.

public:
 virtual bool IsSuffix(System::String ^ source, System::String ^ suffix);
public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix);
public virtual bool IsSuffix (string source, string suffix);
public bool IsSuffix (string source, string suffix);
abstract member IsSuffix : string * string -> bool
override this.IsSuffix : string * string -> bool
member this.IsSuffix : string * string -> bool
Public Overridable Function IsSuffix (source As String, suffix As String) As Boolean
Public Function IsSuffix (source As String, suffix As String) As Boolean

Parameter

source
String

Die zu durchsuchende Zeichenfolge.The string to search in.

suffix
String

Die Zeichenfolge, die mit dem Ende von source verglichen werden soll.The string to compare with the end of source.

Gibt zurück

Boolean

true, wenn die Länge von suffix kleiner oder gleich der Länge von source ist und source mit suffix endet, andernfalls false.true if the length of suffix is less than or equal to the length of source and source ends with suffix; otherwise, false.

Ausnahmen

source ist null.source is null.

- oder - -or-

suffix ist null.suffix is null.

Beispiele

Im folgenden Beispiel wird bestimmt, ob eine Zeichenfolge das Präfix oder Suffix einer anderen Zeichenfolge ist.The following example determines whether a string is the prefix or suffix of another string.

using namespace System;
using namespace System::Globalization;
int 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 S"calle" and S"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 S"calle" and S"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

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

Hinweise

Jede Zeichenfolge beginnt und endet mit einer leeren Teil Zeichenfolge (""); Wenn daher suffix eine leere Zeichenfolge ist, gibt diese Methode zurück true .Every string starts and ends with an empty substring (""); therefore, if suffix is an empty string, this method returns true.

Hinweis

Wenn möglich, sollten Sie Zeichen folgen Vergleichsmethoden aufrufen, die einen Parameter vom Typ aufweisen CompareOptions , um die Art des erwarteten Vergleichs anzugeben.When possible, you should call string comparison methods that have a parameter of type CompareOptions to specify the kind of comparison expected. Verwenden Sie als allgemeine Regel linguistische Optionen (unter Verwendung der aktuellen Kultur) zum Vergleichen von Zeichen folgen, die in der Benutzeroberfläche angezeigt werden, und geben Sie CompareOptions.Ordinal oder CompareOptions.OrdinalIgnoreCase für Sicherheits Vergleiche an.As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify CompareOptions.Ordinal or CompareOptions.OrdinalIgnoreCase for security comparisons.

Weitere Informationen

Gilt für:

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

Bestimmt, ob eine schreibgeschützte Zeichenspanne mit einem bestimmten Suffix endet.Determines whether a read-only span of characters ends with a specific suffix.

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

Parameter

source
ReadOnlySpan<Char>

Die schreibgeschützte Zeichenspanne, die durchsucht werden soll.The read-only span of characters to search within.

suffix
ReadOnlySpan<Char>

Das Suffix, das am Ende von source abgeglichen werden soll.The suffix to attempt to match at the end of source.

options
CompareOptions

Eine optionale Kombination aus CompareOptions-Enumerationswerten, die während des Abgleichs verwendet werden sollen.An optional combination of CompareOptions enumeration values to use during the match. Der Standardwert ist None.The default value is None.

Gibt zurück

Boolean

true, wenn suffix am Ende von source auftritt, andernfalls false.true if suffix occurs at the end of source; otherwise, false.

Ausnahmen

options enthält eine nicht unterstützte Flagkombination.options contains an unsupported combination of flags.

Gilt für:

IsSuffix(String, String, CompareOptions)

Bestimmt mithilfe des angegebenenCompareOptions-Werts, ob die angegebene Quellzeichenfolge mit dem angegebenen Suffix endet.Determines whether the specified source string ends with the specified suffix using the specified CompareOptions value.

public:
 virtual bool IsSuffix(System::String ^ source, System::String ^ suffix, System::Globalization::CompareOptions options);
public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix, System::Globalization::CompareOptions options);
public virtual bool IsSuffix (string source, string suffix, System.Globalization.CompareOptions options);
public bool IsSuffix (string source, string suffix, System.Globalization.CompareOptions options);
abstract member IsSuffix : string * string * System.Globalization.CompareOptions -> bool
override this.IsSuffix : string * string * System.Globalization.CompareOptions -> bool
member this.IsSuffix : string * string * System.Globalization.CompareOptions -> bool
Public Overridable Function IsSuffix (source As String, suffix As String, options As CompareOptions) As Boolean
Public Function IsSuffix (source As String, suffix As String, options As CompareOptions) As Boolean

Parameter

source
String

Die zu durchsuchende Zeichenfolge.The string to search in.

suffix
String

Die Zeichenfolge, die mit dem Ende von source verglichen werden soll.The string to compare with the end of source.

options
CompareOptions

Ein Wert, der definiert, wie source und suffix verglichen werden sollen.A value that defines how source and suffix should be compared. options ist entweder der allein verwendete Enumerationswert Ordinal oder die bitweise Kombination eines oder mehrerer der folgenden Werte: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth und IgnoreKanaType.options is either the enumeration value Ordinal used by itself, or the bitwise combination of one or more of the following values: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth, and IgnoreKanaType.

Gibt zurück

Boolean

true, wenn die Länge von suffix kleiner oder gleich der Länge von source ist und source mit suffix endet, andernfalls false.true if the length of suffix is less than or equal to the length of source and source ends with suffix; otherwise, false.

Ausnahmen

source ist null.source is null.

- oder - -or-

suffix ist null.suffix is null.

options enthält einen ungültigen CompareOptions-Wert.options contains an invalid CompareOptions value.

Beispiele

Im folgenden Beispiel wird mithilfe von bestimmt, ob eine Zeichenfolge das Präfix oder Suffix einer anderen Zeichenfolge ist CompareOptions .The following example determines whether a string is the prefix or suffix of another string using CompareOptions.

using namespace System;
using namespace System::Globalization;
int 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
*/
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

Hinweise

Jede Zeichenfolge beginnt und endet mit einer leeren Teil Zeichenfolge (""); Wenn daher suffix eine leere Zeichenfolge ist, gibt diese Methode zurück true .Every string starts and ends with an empty substring (""); therefore, if suffix is an empty string, this method returns true.

Der CompareOptions.StringSort Wert ist für diese Methode ungültig.The CompareOptions.StringSort value is not valid for this method.

Hinweis

Wenn möglich, sollten Sie Zeichen folgen Vergleichsmethoden aufrufen, die einen Parameter vom Typ aufweisen CompareOptions , um die Art des erwarteten Vergleichs anzugeben.When possible, you should call string comparison methods that have a parameter of type CompareOptions to specify the kind of comparison expected. Verwenden Sie als allgemeine Regel linguistische Optionen (unter Verwendung der aktuellen Kultur) zum Vergleichen von Zeichen folgen, die in der Benutzeroberfläche angezeigt werden, und geben Sie CompareOptions.Ordinal oder CompareOptions.OrdinalIgnoreCase für Sicherheits Vergleiche an.As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify CompareOptions.Ordinal or CompareOptions.OrdinalIgnoreCase for security comparisons.

Weitere Informationen

Gilt für:

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

Bestimmt, ob eine Zeichenfolge mit einem angegebenen Suffix endet.Determines whether a string ends with a specific suffix.

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

Parameter

source
ReadOnlySpan<Char>

Die schreibgeschützte Zeichenspanne, die durchsucht werden soll.The read-only span of characters to search within.

suffix
ReadOnlySpan<Char>

Die schreibgeschützte Zeichenspanne, die das Suffix enthält, mit dem versucht wird, eine Entsprechung am Ende von source zu ermitteln.The read-only span of characters containing the suffix to attempt to match at the end of source.

options
CompareOptions

Die bei der Übereinstimmung zu verwendenden CompareOptions.The CompareOptions to use during the match.

matchLength
Int32

In der Rückgabe dieser Methode ist die Anzahl der Zeichen aus source enthalten, die mit dem gewünschten Suffix übereinstimmen.When this method returns, contains the number of characters of source that matched the desired suffix. Dies kann sich von der Länge von suffix unterscheiden, wenn ein linguistischer Vergleich durchgeführt wird.This may be different than the length of suffix if a linguistic comparison is performed. Wird auf 0 festgelegt, wenn das Suffix nicht übereinstimmt.Set to 0 if the suffix did not match.

Gibt zurück

Boolean

true, wenn suffix am Ende von source auftritt, andernfalls false.true if suffix occurs at the end of source; otherwise, false.

Ausnahmen

options enthält eine nicht unterstützte Flagkombination.options contains an unsupported combination of flags.

Hinweise

Diese Methode hat mehr Aufwand als andere IsSuffix(String, String, CompareOptions) über Ladungen, die kein- matchLength Argument annehmen.This method has greater overhead than other IsSuffix(String, String, CompareOptions) overloads that don't take a matchLength argument. Diese Überladung wird nur aufgerufen, wenn Sie die Übereinstimmungs Längen Informationen benötigen.Call this overload only if you require the match length information.

Gilt für: