HOWTO · PowerShell

Come controllare se una stringa è vuota in PowerShell

L'articolo parla di un metodo di stringa che può essere utilizzato per verificare se una data stringa è null o vuota in PowerShell.

In questa pagina

Quando convalidi un input in PowerShell, decidi prima quale valore vuoi rifiutare: $null, una stringa di lunghezza zero ('') oppure un testo composto solo da spazi bianchi. Sono condizioni diverse. Usa [string]::IsNullOrEmpty() per le prime due, un controllo di veridicità quando vuoi sfruttare il comportamento condizionale di PowerShell e un controllo della lunghezza dopo la rimozione degli spazi quando vuoi considerare vuoto anche un input composto solo da spazi bianchi.

Distinguere $null, le stringhe vuote e gli spazi bianchi

$null indica l’assenza di un valore: non è una stringa. Una stringa vuota ha zero caratteri. Una stringa composta solo da spazi bianchi, come ' ', contiene uno o più caratteri, anche se può sembrare vuota. Anche una variabile a cui non è stato assegnato un valore restituisce $null nell’accesso ordinario alle variabili di PowerShell.

Scegli il controllo in base alla regola di input. Per esempio, potresti rifiutare un nome obbligatorio se è null, vuoto o composto solo da spazi bianchi; se invece gli spazi hanno un significato, non rimuoverli automaticamente.

Usare [string]::IsNullOrEmpty() per controllare se un valore è null o vuoto

Il metodo statico [string]::IsNullOrEmpty($value) restituisce true quando il valore è $null o una stringa di lunghezza zero. Non considera vuoti gli spazi. È una scelta chiara quando vuoi rifiutare sia i valori assenti sia quelli senza caratteri.

Esegui questo esempio:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

$value = 'PowerShell'
if ([string]::IsNullOrEmpty($value)) {
    'No value supplied.'
} else {
    "Value: $value"
}

Questo esempio stampa Value: PowerShell e, per il valore assegnato, segue il ramo previsto per un valore non vuoto.

Usare la veridicità di PowerShell per controlli concisi

In una condizione, PowerShell considera falsi $null e ''; quindi if (-not $value) è un modo conciso per gestire entrambi. Una stringa che contiene spazi, invece, è vera. La veridicità è comoda quando questo comportamento corrisponde all’esigenza, ma non significa «contiene caratteri visibili».

Questa forma affianca la decisione al valore che esamina. Usala quando lo script deve basarsi direttamente sulla conversione condizionale di PowerShell e non serve una classificazione separata. In uno script reale, il ramo vero può chiedere un input, saltare un’operazione o selezionare un valore predefinito; l’altro ramo può proseguire con il valore fornito. Associa l’azione del ramo alla regola richiesta dal programma e usa il metodo specifico descritto sopra quando vuoi rendere la condizione immediatamente riconoscibile. L’esempio usa un normale valore testuale e stampa quale ramo viene scelto.

Esegui questo esempio:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

$value = 'PowerShell'
if (-not $value) {
    'Falsy value.'
} else {
    'Truthy value.'
}

Con questa condizione, una stringa contenente spazi segue il ramo vero. Se gli spazi devono contare come contenuto vuoto, usa un controllo più specifico.

Confrontare una stringa con una stringa vuota o verificarne la lunghezza

Usa $value -eq '' per confrontare direttamente un valore con una stringa di lunghezza zero. Questo confronto, da solo, non considera vuoto il testo composto solo da spazi bianchi. Per verificare il numero di caratteri, puoi usare $value.Length -eq 0, ma controlla prima che il valore non sia $null, altrimenti l’accesso a .Length non è sicuro:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

if ($null -ne $value -and $value.Length -eq 0) {
    'The value is an empty string.'
}

Il controllo evita di accedere a una proprietà quando il valore è null. Se la regola deve includere anche i valori null, [string]::IsNullOrEmpty() esprime l’intento più direttamente.

Controllare separatamente le stringhe composte solo da spazi bianchi

Per considerare vuoto un input composto solo da spazi bianchi, rimuovi gli spazi e controlla la lunghezza del risultato. La rimozione elimina gli spazi iniziali e finali; non modifica la variabile originale a meno che tu non assegni il risultato.

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

$value = '   '
if ([string]::IsNullOrEmpty($value) -or $value.Trim().Length -eq 0) {
    'The value is null, empty, or whitespace-only.'
}

La prima condizione si interrompe quando il valore è $null, quindi .Trim() viene chiamato solo se il valore non è null. Questo schema raggruppa i valori null, quelli di lunghezza zero e quelli composti solo da spazi bianchi. Se devi distinguere questi casi, controllali separatamente invece di combinarli in un’unica condizione.

Controllare più stringhe insieme

Usa -or quando un qualsiasi valore mancante deve attivare lo stesso ramo e -and quando tutti i valori devono soddisfare la condizione. Per esempio, la condizione seguente rileva se uno dei due input è null o vuoto:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

$firstName = 'Ada'
$lastName = ''

if ([string]::IsNullOrEmpty($firstName) -or [string]::IsNullOrEmpty($lastName)) {
    'At least one name is missing.'
} else {
    'Both names are present.'
}

In questo caso viene scelto il ramo per i valori mancanti perché $lastName ha lunghezza zero. Sostituisci -or con -and solo se la regola prevista richiede che entrambi i valori siano null o vuoti prima di entrare in quel ramo. Per includere anche i valori composti solo da spazi bianchi in uno dei due controlli, applica a ciascun valore anche il controllo dopo la rimozione degli spazi.