ketraterm-parser/io.github.ketraterm.parser.api/TerminalCustomOscHandler/handle

handle

abstract fun handle(command: Int, payload: ByteArray, offset: Int, length: Int)

Borrows the body after the first semicolon, excluding the command number and terminator.

The array is read-only and valid only during this call. Copy the specified range to retain it. Offsets are zero-based byte indices; length can be zero. No decoding or UTF-8 validation occurs. The host must validate the body before acting on it.

The complete envelope includes decimal digits and the separator. Its default limit is 4096 bytes. TerminalParsers.create can set a different limit. The command header retains its separate 4096-byte ceiling. Overflow rejects the entire command. Malformed numbers, cancelled strings, and incomplete EOF input produce no callback. BEL and ESC backslash terminate OSC. Ordinary C0 controls and DEL are ignored by the existing string rules. Raw C1 bytes remain payload bytes in the UTF-8 parser.

Parameters

command

nonnegative decimal command number, at most Int.MAX_VALUE.

payload

borrowed parser storage; only the specified range belongs to this command.

offset

first body byte in payload.

length

number of body bytes.