Struct LobTextDecoder 

pub struct LobTextDecoder { /* private fields */ }

Stateful, incremental decoder for streamed CLOB/NCLOB text.

decode_lob_text decodes a whole LOB buffer in one shot. A lazy LOB reader instead pulls the LOB in chunks, and a chunk boundary can fall in the middle of a multi-byte codepoint — an incomplete UTF-8 sequence, or (for the UTF-16 / AL16UTF16 form the server uses for multi-byte CLOBs) an odd trailing byte or a high surrogate whose low half is in the next chunk. Feeding those chunks to this decoder yields exactly the same String as decoding the whole buffer at once: the incomplete tail is carried across push calls and stitched to the next chunk, and finish reports a truncated stream.

This is a new untrusted-decode surface (LOB bytes come off the wire), so its boundary handling is validated offline against decode_lob_text at every split point and is a fuzz target.

Implementations

impl LobTextDecoder

pub fn new(use_utf16: bool, little_endian: bool) -> Self

Build a decoder for the given character-set form and encoding direction.

pub fn from_lob(csfrm: u8, locator: Option<&[u8]>) -> Self

Build a decoder for a LOB from its csfrm and locator flags, matching the same UTF-16/endianness decision decode_lob_text makes.

pub fn push(&mut self, bytes: &[u8]) -> Result<String>

Decode as much of bytes (prefixed by any carried tail) as forms complete codepoints, returning the newly decoded text. Any incomplete trailing sequence is retained for the next call.

pub fn finish(self) -> Result<()>

Assert the stream ended on a codepoint boundary. Errors if a partial unit or a dangling high surrogate remains (a truncated LOB stream).

Trait Implementations

impl Clone for LobTextDecoder

fn clone(&self) -> LobTextDecoder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LobTextDecoder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.