util.Channels.readBinaryString

Reads a given number of bytes from a base.Channel as a character string.

Syntax

Important:

This feature is experimental, the syntax/name and semantics/behavior may change in a future version.

util.Channels.readBinaryString(
     in base.Channel,
     n INTEGER
 )
RETURNS STRING
  1. in is the channel to read from.
  2. n is the number of bytes to be read.
  3. Returns the character string corresponding to the number of bytes read.

Usage

The util.Channels.readBinaryString() reads a number of bytes from a base.Channel object, and returns the character string built from the byte sequence.

The bytes read from the channel must represent characters in the encoding defined by the current application locale.