Skip to content

ConvertFrom-GzipString.md

Latest commit

 

History

History
135 lines (92 loc) · 3.14 KB

ConvertFrom-GzipString.md

File metadata and controls

135 lines (92 loc) · 3.14 KB
external help file PSCompression.dll-Help.xml
Module Name PSCompression
online version https://github.com/santisq/PSCompression
schema 2.0.0

ConvertFrom-GzipString

SYNOPSIS

Decompresses Gzip-compressed Base64-encoded strings.

SYNTAX

ConvertFrom-GzipString
    [-InputObject] <String[]>
    [-Encoding <Encoding>]
    [-Raw]
    [<CommonParameters>]

DESCRIPTION

The ConvertFrom-GzipString cmdlet decompresses Base64-encoded strings that were compressed using GZip compression (via the GZipStream class). It is the counterpart to ConvertTo-GzipString.

EXAMPLES

Example 1: Decompress a GZip-compressed Base64 string

PS ..\pwsh> ConvertFrom-GzipString H4sIAAAAAAAACstIzcnJ5+Uqzy/KSeHlUuTlAgBLr/K2EQAAAA==

hello
world
!

This example decompresses a GZip-compressed Base64 string, restoring the original multi-line text.

Example 2: Compare default behavior with the -Raw switch

PS ..\pwsh> $strings = 'hello', 'world', '!'
PS ..\pwsh> $compressed = $strings | ConvertTo-GzipString
PS ..\pwsh> $decompressed = $compressed | ConvertFrom-GzipString -Raw
PS ..\pwsh> $decompressed.GetType() # System.String
PS ..\pwsh> $decompressed

hello
world
!

This example compares the default behavior (outputting an array of strings split on newlines) with the -Raw switch (returning a single string with newlines preserved).

PARAMETERS

-Encoding

Specifies the text encoding to use for the decompressed output string(s).

Note

The default encoding is UTF-8 without BOM.

Type: Encoding
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: utf8NoBOM
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Specifies the GZip-compressed Base64 string(s) to decompress.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Raw

By default, the cmdlet splits the decompressed text on newline characters and outputs an array of strings. The -Raw switch returns the entire decompressed text as a single string (with newlines preserved).

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters. For more information, see about_CommonParameters.

INPUTS

System.String[]

You can pipe GZip-compressed Base64 strings to this cmdlet.

OUTPUTS

System.String

By default: System.String[] (one element per line). With -Raw: System.String (single multi-line string).

NOTES

RELATED LINKS

ConvertTo-GzipString

System.IO.Compression

GzipStream Class