Text.Contains

Syntaxe

Text.Contains(
    text as nullable text,
    substring as text,
    optional comparer as nullable function
) as nullable logical

À propos

Détecte si text contient la valeur substring. Retourne true si la valeur est trouvée. Cette fonction ne prend pas en charge les caractères génériques ni les expressions régulières.

L’argument facultatif comparer peut être utilisé pour spécifier des comparaisons qui ne sont pas sensibles à la casse ou qui prennent en compte la culture et les paramètres régionaux. Les comparateurs intégrés suivants sont disponibles dans le langage de formule :

• Comparer.Ordinal: utilisé pour effectuer une comparaison ordinale sensible à la casse
• Comparer.OrdinalIgnoreCase: utilisé pour effectuer une comparaison ordinale non sensible à la casse
• Comparer.FromCulture: utilisé pour effectuer une comparaison prenant en compte la culture

Si le premier argument est null, cette fonction retourne null.

Tous les caractères sont traités littéralement. Par exemple, "DR", " DR", "DR " et " DR " ne sont pas considérés comme égaux les uns aux autres.

Exemple 1

Déterminez si le texte « Hello World » contient « Hello ».

Utilisation

Text.Contains("Hello World", "Hello")

Sortie

true

Exemple 2

Déterminez si le texte « Hello World » contient « hello ».

Utilisation

Text.Contains("Hello World", "hello")

Sortie

false

Exemple 3

Recherchez si le texte « Hello World » contient « hello » à l’aide d’un comparateur insensible à la casse.

Utilisation

Text.Contains("Hello World", "hello", Comparer.OrdinalIgnoreCase)

Sortie

true

Exemple 4

Recherchez les lignes d’une table contenant "A-" ou "7" dans le code du compte.

Utilisation

let
    Source = #table(type table [Account Code = text, Posted Date = date, Sales = number],
    {
        {"US-2004", #date(2023,1,20), 580},
        {"CA-8843", #date(2023,7,18), 280},
        {"PA-1274", #date(2022,1,12), 90},
        {"PA-4323", #date(2023,4,14), 187},
        {"US-1200", #date(2022,12,14), 350},
        {"PTY-507", #date(2023,6,4), 110}
    }),
    #"Filtered rows" = Table.SelectRows(
        Source, 
        each Text.Contains([Account Code], "A-") or
            Text.Contains([Account Code], "7"))
in
    #"Filtered rows"

Sortie

#table(type table [Account Code = text, Posted Date = date, Sales = number],
{
    {"CA-8843", #date(2023,7,18), 280},
    {"PA-1274", #date(2022,1,12), 90},
    {"PA-4323", #date(2023,4,14), 187},
    {"PTY-507", #date(2023,6,4), 110}
})

Contenu connexe

• Impact de la culture sur la mise en forme du texte