Skip to content

Fixes #11571 - More updates #11574

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Dec 10, 2024
Merged

Fixes #11571 - More updates #11574

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 16 additions & 5 deletions reference/5.1/Microsoft.PowerShell.Core/About/about_Type_Conversion.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ A value of _any_ type can be coerced to a **Boolean**.
```

- For other types, null values, empty strings, and empty arrays are converted
to `$false`. Other values, including empty hashtables convert to `$true`.
to `$false`.

```powershell
PS> [boolean]''
Expand All @@ -109,7 +109,16 @@ A value of _any_ type can be coerced to a **Boolean**.
False
PS> [boolean]'Hello'
True
PS> [boolean]@(1,'Hello')
```

Other values, including empty hashtables convert to `$true`. Single-element
collections evaluate to the Boolean value of their one and only element.
Collections with more than 1 element are always `$true`.

```powershell
PS> [boolean]@(0)
False
PS> [boolean]@(0,0)
True
PS> [boolean]@{}
True
Expand Down Expand Up @@ -300,8 +309,9 @@ This common code pattern is an instance of _pseudo method syntax_, which
doesn't always work as intended. This syntax translates to:

```powershell
[byte[]] $bytes = 1..16
New-Object -TypeName System.Guid -ArgumentList $bytes # !! BROKEN
PS> [byte[]] $bytes = 1..16
PS> New-Object -TypeName System.Guid -ArgumentList $bytes
New-Object: Cannot find an overload for "Guid" and the argument count: "16".
```

Given that the type of **ArgumentList** is `[object[]]`, a single argument that
Expand All @@ -310,7 +320,8 @@ workaround is to wrap `$bytes` in an outer array so that PowerShell looks for a
constructor with parameters that match the contents of the outer array.

```powershell
PS> $guid = New-Object System.Guid(@(, $bytes))
PS> [byte[]] $bytes = 1..16
PS> $guid = New-Object -TypeName System.Guid -ArgumentList (, $bytes)
PS> $guid

Guid
Expand Down
21 changes: 16 additions & 5 deletions reference/7.4/Microsoft.PowerShell.Core/About/about_Type_Conversion.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ A value of _any_ type can be coerced to a **Boolean**.
```

- For other types, null values, empty strings, and empty arrays are converted
to `$false`. Other values, including empty hashtables convert to `$true`.
to `$false`.

```powershell
PS> [boolean]''
Expand All @@ -109,7 +109,16 @@ A value of _any_ type can be coerced to a **Boolean**.
False
PS> [boolean]'Hello'
True
PS> [boolean]@(1,'Hello')
```

Other values, including empty hashtables convert to `$true`. Single-element
collections evaluate to the Boolean value of their one and only element.
Collections with more than 1 element are always `$true`.

```powershell
PS> [boolean]@(0)
False
PS> [boolean]@(0,0)
True
PS> [boolean]@{}
True
Expand Down Expand Up @@ -300,8 +309,9 @@ This common code pattern is an instance of _pseudo method syntax_, which
doesn't always work as intended. This syntax translates to:

```powershell
[byte[]] $bytes = 1..16
New-Object -TypeName System.Guid -ArgumentList $bytes # !! BROKEN
PS> [byte[]] $bytes = 1..16
PS> New-Object -TypeName System.Guid -ArgumentList $bytes
New-Object: Cannot find an overload for "Guid" and the argument count: "16".
```

Given that the type of **ArgumentList** is `[object[]]`, a single argument that
Expand All @@ -310,7 +320,8 @@ workaround is to wrap `$bytes` in an outer array so that PowerShell looks for a
constructor with parameters that match the contents of the outer array.

```powershell
PS> $guid = New-Object System.Guid(@(, $bytes))
PS> [byte[]] $bytes = 1..16
PS> $guid = New-Object -TypeName System.Guid -ArgumentList (, $bytes)
PS> $guid

Guid
Expand Down
21 changes: 16 additions & 5 deletions reference/7.5/Microsoft.PowerShell.Core/About/about_Type_Conversion.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ A value of _any_ type can be coerced to a **Boolean**.
```

- For other types, null values, empty strings, and empty arrays are converted
to `$false`. Other values, including empty hashtables convert to `$true`.
to `$false`.

```powershell
PS> [boolean]''
Expand All @@ -109,7 +109,16 @@ A value of _any_ type can be coerced to a **Boolean**.
False
PS> [boolean]'Hello'
True
PS> [boolean]@(1,'Hello')
```

Other values, including empty hashtables convert to `$true`. Single-element
collections evaluate to the Boolean value of their one and only element.
Collections with more than 1 element are always `$true`.

```powershell
PS> [boolean]@(0)
False
PS> [boolean]@(0,0)
True
PS> [boolean]@{}
True
Expand Down Expand Up @@ -300,8 +309,9 @@ This common code pattern is an instance of _pseudo method syntax_, which
doesn't always work as intended. This syntax translates to:

```powershell
[byte[]] $bytes = 1..16
New-Object -TypeName System.Guid -ArgumentList $bytes # !! BROKEN
PS> [byte[]] $bytes = 1..16
PS> New-Object -TypeName System.Guid -ArgumentList $bytes
New-Object: Cannot find an overload for "Guid" and the argument count: "16".
```

Given that the type of **ArgumentList** is `[object[]]`, a single argument that
Expand All @@ -310,7 +320,8 @@ workaround is to wrap `$bytes` in an outer array so that PowerShell looks for a
constructor with parameters that match the contents of the outer array.

```powershell
PS> $guid = New-Object System.Guid(@(, $bytes))
PS> [byte[]] $bytes = 1..16
PS> $guid = New-Object -TypeName System.Guid -ArgumentList (, $bytes)
PS> $guid

Guid
Expand Down