HOWTO · PowerShell

在PowerShell中检查字符串是否为空

本文讨论了一种可以用于检查给定字符串是否为空的字符串方法。

本页内容

在 PowerShell 中验证输入时,先确定要拒绝的是哪种值:$null、长度为零的字符串(''),还是只包含空白字符的文本。这些是不同的状态。前两种情况可使用 [string]::IsNullOrEmpty();如果需要的是 PowerShell 条件判断所采用的真值行为,可使用真值检查;如果仅含空白字符的输入也应视为空白,则可检查去除首尾空白后的字符串长度。

区分 $null、空字符串和空白字符

$null 表示没有值;它不是字符串。空字符串的字符数为零。仅含空白字符的字符串(例如 ' ')包含一个或多个字符,尽管看起来可能是空的。在普通的 PowerShell 变量访问中,尚未赋值的变量也会求值为 $null。

应根据输入规则选择检查方式。例如,必填的姓名可能不允许为空值、空字符串或仅含空白字符的输入;如果空格具有实际意义,就不应在没有明确要求时自动删除它们。

使用 [string]::IsNullOrEmpty() 检查空值或空字符串

静态方法 [string]::IsNullOrEmpty($value) 在值为 $null 或长度为零的字符串时返回 true。它不会把空格视为空字符串。如果不接受缺失值或零字符值,这是一种清晰的默认检查方式。

运行以下示例:

本节中的代码以及显示的标签或输出仍为英文。

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

此示例会打印 Value: PowerShell,并针对已赋值的值进入非空分支。

使用 PowerShell 真值进行简洁检查

PowerShell 在条件判断中会将 $null 和 '' 视为 false,因此 if (-not $value) 可以简洁地处理这两种情况。不过,包含空格的字符串为 true。只有当这种行为符合任务要求时,真值检查才方便;它并不表示“包含可见字符”。

这种写法将判断放在所检查的值旁边。如果脚本应直接遵循 PowerShell 的条件转换行为,并且无需单独分类,就可以使用它。在实际脚本中,true 分支可以提示输入、跳过操作或选择默认值;另一个分支则可以继续使用提供的值。分支中的操作应符合程序所需的规则。如果希望条件一目了然,也可以使用上面介绍的明确方法。示例使用常见的文本值,并打印所选分支。

运行以下示例:

本节中的代码以及显示的标签或输出仍为英文。

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

在这个条件中,包含空格的字符串会进入真值分支。如果空格也应视为空白,请使用更具体的检查方式。

将字符串与空字符串比较或检查其长度

如果要直接比较长度为零的字符串,可使用 $value -eq ''。单靠此比较无法将仅含空白字符的文本判定为空。若要检查字符数,可以使用 $value.Length -eq 0;但访问 .Length 前必须先处理 $null:

本节中的代码以及显示的标签或输出仍为英文。

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

这个保护条件可以避免对空值访问属性。如果规则也要求检查空值,[string]::IsNullOrEmpty() 能更直接地表达这一意图。

单独检查仅含空白字符的字符串

如果要把仅含空白字符的输入视为空白,可先去除首尾空白,再检查结果的长度。除非将处理结果赋回变量,否则去除空白不会修改原变量。

本节中的代码以及显示的标签或输出仍为英文。

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

第一个条件遇到 $null 时会短路,因此只有值非空时才会调用 .Trim()。此模式会将空值、零长度字符串和仅含空白字符的字符串归为一类。如果需要区分这些情况,应分别检查,而不是把它们合并为一个条件。

一起检查多个字符串

当任意一个值缺失都应进入同一分支时,使用 -or;当每个值都必须符合条件时,使用 -and。例如,下面的条件会检查两个输入中是否有任意一个为空值或空字符串:

本节中的代码以及显示的标签或输出仍为英文。

$firstName = 'Ada'
$lastName = ''

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

这里会进入缺失值分支,因为 $lastName 的字符数为零。只有当预期规则是两个值都必须为空值或空字符串才进入该分支时,才将 -or 替换为 -and。如果这两种判断也要将仅含空白字符的值视为空白,还需对每个值应用去除空白后的长度检查。