HOWTO · PowerShell

Como verificar se uma string está vazia no PowerShell

O artigo fala sobre um método de string que pode ser usado para verificar se uma determinada string é nula ou vazia no PowerShell.

Nesta página

Ao validar a entrada no PowerShell, primeiro decida qual valor deve ser rejeitado: $null, uma string de comprimento zero ('') ou texto formado apenas por espaços em branco. São estados diferentes. Use [string]::IsNullOrEmpty() para os dois primeiros, um teste de veracidade quando o comportamento condicional do PowerShell for o desejado e um teste do comprimento após remover os espaços quando uma entrada formada só por espaços também deva ser considerada em branco.

Diferencie $null, strings vazias e espaços em branco

$null representa a ausência de um valor; não é uma string. Uma string vazia tem zero caracteres. Uma string formada apenas por espaços, como ' ', contém um ou mais caracteres, embora possa parecer vazia. No acesso comum a variáveis do PowerShell, uma variável à qual nenhum valor foi atribuído também é avaliada como $null.

Escolha o teste de acordo com a regra de entrada. Por exemplo, um nome obrigatório pode rejeitar valores nulos, vazios e formados apenas por espaços; já um valor em que os espaços sejam significativos não deve ser aparado implicitamente.

Use [string]::IsNullOrEmpty() para verificar valores nulos ou vazios

O método estático [string]::IsNullOrEmpty($value) retorna verdadeiro quando o valor é $null ou uma string de comprimento zero. Ele não considera espaços como vazio. É uma opção padrão clara quando tanto a ausência de valor quanto um valor com zero caracteres são inaceitáveis.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

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

Este exemplo imprime Value: PowerShell e segue o ramo de valor não vazio para o valor atribuído. O rótulo Value: permanece em inglês no exemplo.

Use a veracidade do PowerShell para testes concisos

Em uma condição, o PowerShell trata $null e '' como falso; por isso, if (-not $value) é uma forma concisa de lidar com ambos. Uma string que contém espaços, porém, é verdadeira. A veracidade é conveniente quando esse comportamento corresponde à tarefa; ela não significa “contém caracteres visíveis”.

Essa forma coloca a decisão junto ao valor que está sendo verificado. Use-a quando o script deve seguir diretamente a conversão condicional do PowerShell e não for necessário classificar o valor separadamente. Em um script real, o ramo verdadeiro pode solicitar uma entrada, ignorar uma operação ou selecionar um valor padrão; o outro ramo pode continuar usando o valor fornecido. Alinhe a ação de cada ramo à regra de que o programa precisa e use o método exato acima quando quiser deixar a condição fácil de reconhecer. O exemplo usa um valor de texto comum e imprime qual ramo foi selecionado.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

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

Para essa condição, uma string que contém espaços segue o ramo verdadeiro. Use um teste mais específico se os espaços devem ser considerados em branco.

Compare uma string com uma string vazia ou verifique seu comprimento

Use $value -eq '' quando quiser comparar diretamente com uma string de comprimento zero. Por si só, essa comparação não classifica texto formado apenas por espaços como vazio. Para verificar a quantidade de caracteres, use $value.Length -eq 0, mas proteja-se contra $null antes de acessar .Length:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

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

A proteção evita o acesso à propriedade quando o valor é nulo. Se a regra também incluir valores nulos, [string]::IsNullOrEmpty() expressa essa intenção de forma mais direta.

Verifique separadamente strings formadas apenas por espaços

Para considerar uma entrada formada apenas por espaços como em branco, remova os espaços e verifique o comprimento resultante. Essa remoção elimina os espaços em branco do início e do fim; ela não altera a variável original, a menos que você atribua a ela o resultado.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

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

A primeira condição é avaliada com curto-circuito para $null, então .Trim() só é chamado quando o valor não é nulo. Esse padrão agrupa valores nulos, strings de comprimento zero e strings formadas apenas por espaços. Se precisar distinguir esses casos, teste-os separadamente em vez de combiná-los em uma única condição.

Verifique várias strings em conjunto

Use -or quando qualquer valor ausente deva acionar o mesmo ramo e -and quando todos os valores precisarem atender à condição. Por exemplo, esta condição detecta se qualquer uma das entradas é nula ou vazia:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

$firstName = 'Ada'
$lastName = ''

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

Aqui, o ramo de valor ausente é selecionado porque $lastName tem zero caracteres. Substitua -or por -and somente quando a regra pretendida exigir que ambos os valores sejam nulos ou vazios para acionar esse ramo. Para incluir valores formados apenas por espaços em qualquer uma das decisões, aplique também o teste após a remoção dos espaços a cada valor.