HOWTO · PowerShell
在 PowerShell 中檢查字串是否為空
本文描述了一個可用於在 PowerShell 中檢查給定字串是否為空或 null 的字串方法。
本頁內容
在 PowerShell 中驗證輸入時,先判斷你要排除的是哪種值:$null、長度為零的字串(''),還是只含空白字元的文字。這些是不同的狀態。若要檢查前兩者,請使用 [string]::IsNullOrEmpty();若要採用 PowerShell 的條件判斷行為,則可使用真值檢查;若只含空白字元也應視為空白,請檢查去除空白後的字串長度。
區分 $null、空字串與空白字元
$null 代表沒有值,本身不是字串。空字串的字元數為零。只含空白字元的字串(例如 ' ')至少包含一個字元,只是看起來可能是空的。在一般的 PowerShell 變數存取中,尚未指定值的變數也會得到 $null。
請依輸入規則選擇檢查方式。例如,必填姓名可能需要排除 null、空字串和只含空白字元的輸入;如果空格具有意義,就不應在未明確要求時自動移除。
使用 [string]::IsNullOrEmpty() 檢查 null 或空字串
靜態方法 [string]::IsNullOrEmpty($value) 在值為 $null 或長度為零的字串時會傳回 true。它不會把空格視為空字串。如果 null 和零字元的值都不可接受,這是清楚直接的預設選擇。
執行此範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
$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.'
}
這個防範檢查可避免對 null 值存取屬性。如果規則也要涵蓋 null,使用 [string]::IsNullOrEmpty() 會更直接地表達這項意圖。
另外檢查只含空白字元的字串
若要將只含空白字元的輸入視為空白,請先移除字串首尾的空白,再檢查結果長度。除非將修剪後的結果指派回變數,否則修剪不會修改原始變數。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
$value = ' '
if ([string]::IsNullOrEmpty($value) -or $value.Trim().Length -eq 0) {
'The value is null, empty, or whitespace-only.'
}
第一個條件會在值為 $null 時短路,因此只有值非 null 時才會執行 .Trim()。這種寫法會將 null、零長度和只含空白字元的值歸為同一類。如果需要區分這些情況,請分別檢查,不要將它們合併成一個條件。
一起檢查多個字串
如果任一值缺少時都應進入同一分支,請使用 -or;如果每個值都必須符合條件,則使用 -and。例如,以下條件會檢查兩個輸入是否有任一個為 null 或空字串:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
$firstName = 'Ada'
$lastName = ''
if ([string]::IsNullOrEmpty($firstName) -or [string]::IsNullOrEmpty($lastName)) {
'At least one name is missing.'
} else {
'Both names are present.'
}
此處因為 $lastName 的字元數為零,所以會選取缺少值的分支。只有在規則要求兩個值都必須為 null 或空字串時,才將 -or 換成 -and。若兩種判斷都要涵蓋只含空白字元的值,也請分別對每個值套用修剪後檢查的方式。