HOWTO · PowerShell
Vérifier si une chaîne est vide en PowerShell
L'article parle d'une méthode de chaîne qui peut être utilisée pour vérifier si une chaîne donnée est nulle ou vide en PowerShell.
Sur cette page
Pour valider une entrée dans PowerShell, commencez par déterminer quelle valeur doit être rejetée : $null, une chaîne de longueur nulle ('') ou un texte composé uniquement d’espaces. Il s’agit de situations différentes. Utilisez [string]::IsNullOrEmpty() pour les deux premières, un test de vérité lorsque vous souhaitez le comportement conditionnel de PowerShell, et un test de longueur après suppression des espaces si les chaînes qui ne contiennent que des espaces doivent aussi être considérées comme vides.
Distinguer $null, les chaînes vides et les espaces
$null signifie qu’il n’y a aucune valeur ; ce n’est pas une chaîne. Une chaîne vide contient zéro caractère. Une chaîne composée uniquement d’espaces, comme ' ', contient un ou plusieurs caractères, même si elle semble vide. Lorsqu’on y accède normalement dans PowerShell, une variable à laquelle aucune valeur n’a été affectée prend également la valeur $null.
Choisissez le test selon la règle de validation. Par exemple, un nom obligatoire peut rejeter les valeurs nulles, les chaînes vides et celles qui ne contiennent que des espaces. En revanche, si les espaces ont un sens pour une valeur, ne les supprimez pas implicitement.
Utiliser [string]::IsNullOrEmpty() pour tester les valeurs nulles ou vides
La méthode statique [string]::IsNullOrEmpty($value) renvoie true lorsque la valeur est $null ou correspond à une chaîne de longueur nulle. Elle ne considère pas les espaces comme une chaîne vide. C’est un choix simple lorsque les valeurs absentes et celles qui ne contiennent aucun caractère sont toutes deux inacceptables.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
$value = 'PowerShell'
if ([string]::IsNullOrEmpty($value)) {
'No value supplied.'
} else {
"Value: $value"
}
Cet exemple affiche Value: PowerShell et suit la branche indiquant que la valeur affectée n’est pas vide.
Utiliser la valeur de vérité de PowerShell pour des tests concis
Dans une condition, PowerShell considère $null et '' comme faux. Ainsi, if (-not $value) permet de traiter les deux cas de façon concise. Une chaîne contenant des espaces est toutefois vraie. La valeur de vérité est pratique lorsque ce comportement correspond au besoin ; elle ne signifie pas « contient des caractères visibles ».
Cette forme place la décision près de la valeur examinée. Utilisez-la lorsque le script doit appliquer directement la conversion conditionnelle de PowerShell et qu’il n’est pas nécessaire de distinguer les cas séparément. Dans un script réel, la branche vraie peut demander une saisie, ignorer une opération ou choisir une valeur par défaut ; l’autre branche peut continuer avec la valeur fournie. Faites correspondre l’action de la branche à la règle voulue par le programme. Si vous souhaitez que la condition soit plus explicite au premier coup d’œil, utilisez la méthode présentée plus haut. L’exemple utilise une valeur textuelle courante et affiche la branche sélectionnée.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
$value = 'PowerShell'
if (-not $value) {
'Falsy value.'
} else {
'Truthy value.'
}
Avec cette condition, une chaîne composée d’espaces suit la branche vraie. Utilisez un test plus précis si ces espaces doivent être considérés comme du vide.
Comparer une chaîne à une chaîne vide ou examiner sa longueur
Utilisez $value -eq '' pour comparer directement une valeur à une chaîne de longueur nulle. Ce test ne considère pas à lui seul les textes composés uniquement d’espaces comme vides. Pour vérifier le nombre de caractères, utilisez $value.Length -eq 0, mais testez d’abord $null afin d’éviter d’accéder à .Length sur une valeur nulle :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
if ($null -ne $value -and $value.Length -eq 0) {
'The value is an empty string.'
}
Cette garde évite l’accès à une propriété lorsque la valeur est nulle. Si la règle doit aussi couvrir les valeurs nulles, [string]::IsNullOrEmpty() exprime cette intention plus directement.
Traiter séparément les chaînes composées uniquement d’espaces
Pour considérer comme vide une entrée composée uniquement d’espaces, supprimez les espaces, puis vérifiez la longueur du résultat. La suppression porte sur les espaces au début et à la fin ; elle ne modifie pas la variable d’origine, sauf si vous affectez le résultat à cette variable.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
$value = ' '
if ([string]::IsNullOrEmpty($value) -or $value.Trim().Length -eq 0) {
'The value is null, empty, or whitespace-only.'
}
La première condition s’arrête dès que la valeur est $null ; .Trim() n’est donc appelé que si la valeur n’est pas nulle. Ce modèle regroupe les valeurs nulles, les chaînes de longueur nulle et celles qui ne contiennent que des espaces. Si vous devez distinguer ces cas, testez-les séparément au lieu de les réunir dans une seule condition.
Vérifier plusieurs chaînes à la fois
Utilisez -or lorsqu’une valeur manquante, quelle qu’elle soit, doit déclencher la même branche, et -and lorsque chaque valeur doit satisfaire la condition. Par exemple, cette condition détecte si l’une ou l’autre entrée est nulle ou vide :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
$firstName = 'Ada'
$lastName = ''
if ([string]::IsNullOrEmpty($firstName) -or [string]::IsNullOrEmpty($lastName)) {
'At least one name is missing.'
} else {
'Both names are present.'
}
Ici, la branche des valeurs manquantes est sélectionnée parce que $lastName ne contient aucun caractère. Remplacez -or par -and uniquement si la règle voulue est que les deux valeurs soient nulles ou vides pour déclencher cette branche. Pour inclure les chaînes composées uniquement d’espaces, appliquez aussi le test après suppression des espaces à chaque valeur.