String.IndexOfAny Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Signale l'index de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié. La méthode retourne -1 si les caractères du tableau sont introuvables dans cette instance.

Surcharges

IndexOfAny(Char[])	Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié.
IndexOfAny(Char[], Int32)	Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié. La recherche commence à une position de caractère spécifiée.
IndexOfAny(Char[], Int32, Int32)	Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié. La recherche commence à une position de caractère spécifiée et examine un nombre spécifié de positions de caractère.

IndexOfAny(Char[])

Source:

String.Searching.cs

Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié.

C#

public int IndexOfAny (char[] anyOf);

Paramètres

anyOf

Char[]

Tableau de caractères Unicode contenant un ou plusieurs caractères à rechercher.

Retours

Int32

Position d'index de base zéro de la première occurrence dans cette instance où un caractère quelconque dans anyOf a été trouvé ; -1 si aucun caractère dans anyOf n'a été trouvé.

Exceptions

ArgumentNullException

anyOf est null.

Exemples

L’exemple suivant recherche la première voyelle d’une chaîne.

C#

using System;

public class Example
{
   public static void Main()
   {
      char[] chars = { 'a', 'e', 'i', 'o', 'u', 'y', 
                       'A', 'E', 'I', 'O', 'U', 'Y' };
      String s = "The long and winding road...";
      Console.WriteLine("The first vowel in \n   {0}\nis found at position {1}", 
                        s, s.IndexOfAny(chars) + 1);                         
   }
}
// The example displays the following output:
//       The first vowel in
//          The long and winding road...
//       is found at position 3

Remarques

La numérotation d’index commence à partir de zéro.

La recherche respecte anyOf la casse. Si anyOf est un tableau vide, la méthode trouve une correspondance au début de la chaîne (c’est-à-dire à l’index zéro).

Cette méthode effectue une recherche ordinale (insensible à la culture), où un caractère est considéré comme équivalent à un autre caractère uniquement si ses valeurs scalaires Unicode sont identiques. Pour effectuer une recherche sensible à la culture, utilisez la CompareInfo.IndexOf méthode, dans laquelle une valeur scalaire Unicode représentant un caractère précomposé, comme la ligature « Æ » (U+00C6), peut être considérée comme équivalente à toute occurrence des composants du caractère dans la séquence appropriée, telle que « AE » (U+0041, U+0045), en fonction de la culture.

Voir aussi

• IndexOf(Char)
• LastIndexOf(Char)
• LastIndexOfAny(Char[])

IndexOfAny(Char[], Int32)

Source:

String.Searching.cs

Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié. La recherche commence à une position de caractère spécifiée.

C#

public int IndexOfAny (char[] anyOf, int startIndex);

Paramètres

anyOf

Char[]

Tableau de caractères Unicode contenant un ou plusieurs caractères à rechercher.

startIndex

Int32

Position de départ de la recherche.

Retours

Int32

Position d'index de base zéro de la première occurrence dans cette instance où un caractère quelconque dans anyOf a été trouvé ; -1 si aucun caractère dans anyOf n'a été trouvé.

Exceptions

ArgumentNullException

anyOf est null.

ArgumentOutOfRangeException

startIndex est un nombre négatif.

- ou -

startIndex est supérieur au nombre de caractères dans cette instance.

Exemples

L’exemple suivant recherche l’index de l’occurrence d’un caractère de la chaîne « is » dans une sous-chaîne d’une autre chaîne.

C#

// Sample for String.IndexOfAny(Char[], Int32)
using System;

class Sample {
    public static void Main()
    {
    string br1 = "0----+----1----+----2----+----3----+----4----+----5----+----6----+-";
    string br2 = "0123456789012345678901234567890123456789012345678901234567890123456";
    string str = "Now is the time for all good men to come to the aid of their party.";
    int start;
    int at;
    string target = "is";
    char[] anyOf = target.ToCharArray();

    start = str.Length/2;
    Console.WriteLine();
    Console.WriteLine("The first character occurrence from position {0} to {1}.",
                           start, str.Length-1);
    Console.WriteLine("{1}{0}{2}{0}{3}{0}", Environment.NewLine, br1, br2, str);
    Console.Write("A character in '{0}' occurs at position: ", target);

    at = str.IndexOfAny(anyOf, start);
    if (at > -1)
        Console.Write(at);
    else
        Console.Write("(not found)");
    Console.WriteLine();
    }
}
/*

The first character occurrence from position 33 to 66.
0----+----1----+----2----+----3----+----4----+----5----+----6----+-
0123456789012345678901234567890123456789012345678901234567890123456
Now is the time for all good men to come to the aid of their party.

A character in 'is' occurs at position: 49

*/

Remarques

La numérotation d’index commence à partir de zéro. Le startIndex paramètre peut varier de 0 à un de moins que la longueur de la chaîne instance.

Les plages de recherche vont de startIndex la fin de la chaîne.

La recherche respecte anyOf la casse.

Cette méthode effectue une recherche ordinale (insensible à la culture), où un caractère est considéré comme équivalent à un autre caractère uniquement si sa valeur scalaire Unicode est identique. Pour effectuer une recherche sensible à la culture, utilisez la CompareInfo.IndexOf méthode, dans laquelle une valeur scalaire Unicode représentant un caractère précomposé, comme la ligature « Æ » (U+00C6), peut être considérée comme équivalente à toute occurrence des composants du caractère dans la séquence appropriée, telle que « AE » (U+0041, U+0045), en fonction de la culture.

Voir aussi

• Char
• Int32
• Array
• IndexOf(Char)
• LastIndexOf(Char)
• LastIndexOfAny(Char[])

IndexOfAny(Char[], Int32, Int32)

Source:

String.Searching.cs

Signale l'index de base zéro de la première occurrence dans cette instance de tout caractère d'un tableau de caractères Unicode spécifié. La recherche commence à une position de caractère spécifiée et examine un nombre spécifié de positions de caractère.

C#

public int IndexOfAny (char[] anyOf, int startIndex, int count);

Paramètres

anyOf

Char[]

Tableau de caractères Unicode contenant un ou plusieurs caractères à rechercher.

startIndex

Int32

Position de départ de la recherche.

count

Int32

Nombre de positions de caractère à examiner.

Retours

Int32

Position d'index de base zéro de la première occurrence dans cette instance où un caractère quelconque dans anyOf a été trouvé ; -1 si aucun caractère dans anyOf n'a été trouvé.

Exceptions

ArgumentNullException

anyOf est null.

ArgumentOutOfRangeException

count ou startIndex est un nombre négatif.

- ou -

count + startIndex est supérieur au nombre de caractères dans cette instance.

Exemples

L’exemple suivant recherche l’index de l’occurrence d’un caractère de la chaîne « aid » dans une sous-chaîne d’une autre chaîne.

C#

// Sample for String.IndexOfAny(Char[], Int32, Int32)
using System;

class Sample {
    public static void Main()
    {
    string br1 = "0----+----1----+----2----+----3----+----4----+----5----+----6----+-";
    string br2 = "0123456789012345678901234567890123456789012345678901234567890123456";
    string str = "Now is the time for all good men to come to the aid of their party.";
    int start;
    int at;
    int count;
    string target = "aid";
    char[] anyOf = target.ToCharArray();

    start = (str.Length-1)/3;
    count = (str.Length-1)/4;
    Console.WriteLine();
    Console.WriteLine("The first character occurrence from position {0} for {1} characters.", start, count);
    Console.WriteLine("{1}{0}{2}{0}{3}{0}", Environment.NewLine, br1, br2, str);
    Console.Write("A character in '{0}' occurs at position: ", target);

    at = str.IndexOfAny(anyOf, start, count);
    if (at > -1)
        Console.Write(at);
    else
        Console.Write("(not found)");
    Console.WriteLine();
    }
}
/*

The first character occurrence from position 22 for 16 characters.
0----+----1----+----2----+----3----+----4----+----5----+----6----+-
0123456789012345678901234567890123456789012345678901234567890123456
Now is the time for all good men to come to the aid of their party.

A character in 'aid' occurs at position: 27

*/

Remarques

La recherche commence à startIndex et continue à startIndex + count -1. Le caractère à startIndex + count n’est pas inclus dans la recherche.

La numérotation d’index commence à partir de zéro. Le startIndex paramètre peut varier de 0 à un de moins que la longueur de la chaîne instance.

La recherche respecte anyOf la casse.

Cette méthode effectue une recherche ordinale (insensible à la culture), où un caractère est considéré comme équivalent à un autre caractère uniquement si sa valeur scalaire Unicode est identique. Pour effectuer une recherche sensible à la culture, utilisez la CompareInfo.IndexOf méthode, dans laquelle une valeur scalaire Unicode représentant un caractère précomposé, comme la ligature « Æ » (U+00C6), peut être considérée comme équivalente à toute occurrence des composants du caractère dans la séquence appropriée, telle que « AE » (U+0041, U+0045), en fonction de la culture.

Voir aussi

• Char
• Int32
• Array
• IndexOf(Char)
• LastIndexOf(Char)
• LastIndexOfAny(Char[])