PowerShell

Receive a Single Byte from a Socket

Demonstrates Socket.ReceiveByte, which reads exactly one byte and stores its numeric value in the ReceivedInt property. The argument selects signed or unsigned interpretation.

Background. Fixed-size integers and length prefixes are common building blocks for application-defined binary protocols. Byte order is selectable, with big-endian being network byte order.

Chilkat PowerShell Downloads

Download Chilkat for PowerShell

PowerShell

Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

$socket = New-Object Chilkat.Socket

#  Connect to the server using TLS.
$bTls = $true
$maxWaitMs = 5000
$success = $socket.Connect("example.com",5000,$bTls,$maxWaitMs)
if ($success -eq $false) {
    $($socket.LastErrorText)
    exit
}

#  Read exactly one byte.  Its numeric value is stored in the ReceivedInt property.  Passing $true
#  interprets the byte as unsigned (0 through 255); $false interprets it as signed.
$bUnsigned = $true
$success = $socket.ReceiveByte($bUnsigned)
if ($success -eq $false) {
    $($socket.LastErrorText)
    exit
}

$("Received byte value: " + $socket.ReceivedInt)