CompareInfo.IsSuffix Método

Definición

Determina si una cadena termina con un sufijo específico.Determines whether a string ends with a specific suffix.

Sobrecargas

IsSuffix(String, String)

Determina si la cadena de origen especificada termina con el sufijo especificado.Determines whether the specified source string ends with the specified suffix.

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

Determina si un intervalo de caracteres de solo lectura finaliza con un sufijo específico.Determines whether a read-only span of characters ends with a specific suffix.

IsSuffix(String, String, CompareOptions)

Determina si la cadena de origen especificada termina con el sufijo especificado utilizando el valor de CompareOptions especificado.Determines whether the specified source string ends with the specified suffix using the specified CompareOptions value.

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

Determina si una cadena termina con un sufijo específico.Determines whether a string ends with a specific suffix.

IsSuffix(String, String)

Determina si la cadena de origen especificada termina con el sufijo especificado.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

Parámetros

source
String

Cadena en que se va a buscar.The string to search in.

suffix
String

Cadena que se va a comparar con el final de source.The string to compare with the end of source.

Devoluciones

Boolean

true si la longitud de suffix es menor o igual que la longitud de source y source termina con suffix; en caso contrario, false.true if the length of suffix is less than or equal to the length of source and source ends with suffix; otherwise, false.

Excepciones

El valor de source es null.source is null.

O bien-or-

El valor de suffix es null.suffix is null.

Ejemplos

En el ejemplo siguiente se determina si una cadena es el prefijo o el sufijo de otra cadena.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

Comentarios

Cada cadena comienza y termina con una subcadena vacía (""); por consiguiente, si suffix es una cadena vacía, este método devuelve true .Every string starts and ends with an empty substring (""); therefore, if suffix is an empty string, this method returns true.

Nota

Cuando sea posible, debe llamar a métodos de comparación de cadenas que tengan un parámetro de tipo CompareOptions para especificar el tipo de comparación esperada.When possible, you should call string comparison methods that have a parameter of type CompareOptions to specify the kind of comparison expected. Como norma general, use las opciones lingüísticas (con la referencia cultural actual) para comparar las cadenas que se muestran en la interfaz de usuario y especifique CompareOptions.Ordinal o CompareOptions.OrdinalIgnoreCase para las comparaciones de seguridad.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.

Consulte también

Se aplica a

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

Determina si un intervalo de caracteres de solo lectura finaliza con un sufijo específico.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

Parámetros

source
ReadOnlySpan<Char>

Intervalo de caracteres de solo lectura en el que se realizará la búsqueda.The read-only span of characters to search within.

suffix
ReadOnlySpan<Char>

Sufijo para el que se van a intentar buscar coincidencias al final de source.The suffix to attempt to match at the end of source.

options
CompareOptions

Combinación opcional de los valores de enumeración de CompareOptions que se va a usar durante la búsqueda de coincidencias.An optional combination of CompareOptions enumeration values to use during the match. El valor predeterminado es None.The default value is None.

Devoluciones

Boolean

true si suffix se produce al final de source; de lo contrario, false.true if suffix occurs at the end of source; otherwise, false.

Excepciones

options contiene una combinación no admitida de marcas.options contains an unsupported combination of flags.

Se aplica a

IsSuffix(String, String, CompareOptions)

Determina si la cadena de origen especificada termina con el sufijo especificado utilizando el valor de CompareOptions especificado.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

Parámetros

source
String

Cadena en que se va a buscar.The string to search in.

suffix
String

Cadena que se va a comparar con el final de source.The string to compare with the end of source.

options
CompareOptions

Valor que define cómo deben compararse los parámetros source y suffix.A value that defines how source and suffix should be compared. options es el valor de la enumeración Ordinal usado de forma aislada, o la combinación bit a bit de uno o varios de los valores siguientes: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth y 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.

Devoluciones

Boolean

true si la longitud de suffix es menor o igual que la longitud de source y source termina con suffix; en caso contrario, false.true if the length of suffix is less than or equal to the length of source and source ends with suffix; otherwise, false.

Excepciones

El valor de source es null.source is null.

O bien-or-

El valor de suffix es null.suffix is null.

options contiene un valor de CompareOptions no válido.options contains an invalid CompareOptions value.

Ejemplos

En el ejemplo siguiente se determina si una cadena es el prefijo o el sufijo de otra cadena mediante 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

Comentarios

Cada cadena comienza y termina con una subcadena vacía (""); por consiguiente, si suffix es una cadena vacía, este método devuelve true .Every string starts and ends with an empty substring (""); therefore, if suffix is an empty string, this method returns true.

El CompareOptions.StringSort valor no es válido para este método.The CompareOptions.StringSort value is not valid for this method.

Nota

Cuando sea posible, debe llamar a métodos de comparación de cadenas que tengan un parámetro de tipo CompareOptions para especificar el tipo de comparación esperada.When possible, you should call string comparison methods that have a parameter of type CompareOptions to specify the kind of comparison expected. Como norma general, use las opciones lingüísticas (con la referencia cultural actual) para comparar las cadenas que se muestran en la interfaz de usuario y especifique CompareOptions.Ordinal o CompareOptions.OrdinalIgnoreCase para las comparaciones de seguridad.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.

Consulte también

Se aplica a

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

Determina si una cadena termina con un sufijo específico.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

Parámetros

source
ReadOnlySpan<Char>

Intervalo de caracteres de solo lectura en el que se realizará la búsqueda.The read-only span of characters to search within.

suffix
ReadOnlySpan<Char>

El intervalo de solo lectura de caracteres que contiene el sufijo para el que se intentará buscar coincidencias al final de source.The read-only span of characters containing the suffix to attempt to match at the end of source.

options
CompareOptions

Propiedad CompareOptions que se va a usar durante la búsqueda de coincidencia.The CompareOptions to use during the match.

matchLength
Int32

Cuando este método devuelve resultados, contiene el número de caracteres de source que coincidieron con el sufijo deseado.When this method returns, contains the number of characters of source that matched the desired suffix. Puede ser distinto de la longitud de suffix si se realiza una comparación lingüística.This may be different than the length of suffix if a linguistic comparison is performed. Se establece en 0 si el sufijo no coincidía.Set to 0 if the suffix did not match.

Devoluciones

Boolean

true si suffix se produce al final de source; de lo contrario, false.true if suffix occurs at the end of source; otherwise, false.

Excepciones

options contiene una combinación no admitida de marcas.options contains an unsupported combination of flags.

Comentarios

Este método tiene mayor sobrecarga que otras IsSuffix(String, String, CompareOptions) sobrecargas que no toman un matchLength argumento.This method has greater overhead than other IsSuffix(String, String, CompareOptions) overloads that don't take a matchLength argument. Llame a esta sobrecarga solo si necesita información sobre la longitud de la coincidencia.Call this overload only if you require the match length information.

Se aplica a