CompareInfo.IsSuffix Metodo

Definizione

Determina se una stringa termina con un suffisso specifico.

Overload

IsSuffix(String, String)

Determina se la stringa di origine specificata termina con il suffisso specificato.

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

Determina se un intervallo di caratteri di sola lettura termina con un suffisso specifico.

IsSuffix(String, String, CompareOptions)

Determina se la stringa di origine specificata termina con il suffisso specificato usando il valore CompareOptions specificato.

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

Determina se una stringa termina con un suffisso specifico.

IsSuffix(String, String)

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Determina se la stringa di origine specificata termina con il suffisso specificato.

C#
public virtual bool IsSuffix (string source, string suffix);
C#
public bool IsSuffix (string source, string suffix);

Parametri

source
String

Stringa in cui effettuare la ricerca.

suffix
String

Stringa da confrontare con la fine di source.

Restituisce

true se la lunghezza di suffix è minore o uguale alla lunghezza di source e se source termina con suffix. In caso contrario, false.

Eccezioni

source è null.

-oppure-

suffix è null.

Esempio

Nell'esempio seguente viene determinato se una stringa è il prefisso o il suffisso di un'altra stringa.

C#
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

*/

Commenti

Ogni stringa inizia e termina con una sottostringa vuota (""); pertanto, se suffix è una stringa vuota, questo metodo restituisce true.

Nota

Quando possibile, è necessario chiamare metodi di confronto tra stringhe con un parametro di tipo CompareOptions per specificare il tipo di confronto previsto. Come regola generale, usare le opzioni linguistiche (usando le impostazioni cultura correnti) per confrontare le stringhe visualizzate nell'interfaccia utente e specificare CompareOptions.Ordinal o CompareOptions.OrdinalIgnoreCase per i confronti di sicurezza.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.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
.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.6, 2.0, 2.1
UWP 10.0

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

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Determina se un intervallo di caratteri di sola lettura termina con un suffisso specifico.

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

Parametri

source
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura in cui eseguire la ricerca.

suffix
ReadOnlySpan<Char>

Suffisso per il quale provare a trovare una corrispondenza alla fine di source.

options
CompareOptions

Combinazione facoltativa di valori di enumerazione di CompareOptions da usare durante la ricerca della corrispondenza. Il valore predefinito è None.

Restituisce

true se suffix viene trovato alla fine di source; in caso contrario, false.

Eccezioni

options contiene una combinazione non supportata di flag.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 5, 6, 7, 8, 9

IsSuffix(String, String, CompareOptions)

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Determina se la stringa di origine specificata termina con il suffisso specificato usando il valore CompareOptions specificato.

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

Parametri

source
String

Stringa in cui effettuare la ricerca.

suffix
String

Stringa da confrontare con la fine di source.

options
CompareOptions

Valore che definisce la modalità di confronto di source e suffix. options è il valore di enumerazione Ordinal utilizzato da solo o la combinazione bit per bit di uno o più dei seguenti valori: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth e IgnoreKanaType.

Restituisce

true se la lunghezza di suffix è minore o uguale alla lunghezza di source e se source termina con suffix. In caso contrario, false.

Eccezioni

source è null.

-oppure-

suffix è null.

options contiene un valore di CompareOptions non valido.

Esempio

Nell'esempio seguente viene determinato se una stringa è il prefisso o il suffisso di un'altra stringa usando CompareOptions.

C#
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

*/

Commenti

Ogni stringa inizia e termina con una sottostringa vuota (""); pertanto, se suffix è una stringa vuota, questo metodo restituisce true.

Il CompareOptions.StringSort valore non è valido per questo metodo.

Nota

Quando possibile, è necessario chiamare metodi di confronto tra stringhe con un parametro di tipo CompareOptions per specificare il tipo di confronto previsto. Come regola generale, usare le opzioni linguistiche (usando le impostazioni cultura correnti) per confrontare le stringhe visualizzate nell'interfaccia utente e specificare CompareOptions.Ordinal o CompareOptions.OrdinalIgnoreCase per i confronti di sicurezza.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.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
.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.6, 2.0, 2.1
UWP 10.0

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

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Determina se una stringa termina con un suffisso specifico.

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

Parametri

source
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura in cui eseguire la ricerca.

suffix
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura contenente il suffisso per tentare di trovare una corrispondenza alla fine di source.

options
CompareOptions

Proprietà CompareOptions da usare durante la corrispondenza.

matchLength
Int32

Quando termina, questo metodo contiene il numero di caratteri di source che corrispondono al suffisso desiderato. Questo valore può essere diverso dalla lunghezza di suffix se viene eseguito un confronto linguistico. Impostare su 0 se il suffisso non corrisponde.

Restituisce

true se suffix viene trovato alla fine di source; in caso contrario, false.

Eccezioni

options contiene una combinazione non supportata di flag.

Commenti

Questo metodo ha un sovraccarico maggiore rispetto ad altri IsSuffix(String, String, CompareOptions) overload che non accettano un matchLength argomento. Chiamare questo overload solo se sono necessarie le informazioni sulla lunghezza della corrispondenza.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 5, 6, 7, 8, 9