NAME

CBOR::Free::SequenceDecoder

SYNOPSIS

my $decoder = CBOR::Free::SequenceDecoder->new();

if ( my $got_sr = $decoder->give( $some_cbor ) ) {

    # Do something with your decoded CBOR.
}

while (my $got_sr = $decoder->get()) {
    # Do something with your decoded CBOR.
}

DESCRIPTION

This module implements a parser for CBOR Sequences (RFC 8742).

METHODS

This module implements the following methods in common with CBOR::Free::Decoder:

• new()

• preserve_references()

• naive_utf8()

• string_decode_cbor()

• string_decode_never()

• string_decode_always()

• set_tag_handlers()

Additionally, the following exist:

$got_sr = CLASS->give( $CBOR );

Adds some bytes ($CBOR) to the decoder’s internal CBOR buffer. Returns either:

• a scalar reference to the (parsed) first CBOR document in the internal buffer

• undef, if there is no such document

Note that if your decoded CBOR document’s root element is already a reference (e.g., an array or hash reference), then the return value is a reference to that reference. So, for example, if you expect all documents in your stream to be array references, you could do:

if ( my $got_sr = $decoder->give( $some_cbor ) ) {
    my @decoded_array = @{ $$got_sr };

    # …
}

$got_sr = CLASS->get();

Like give() but doesn’t append onto the internal CBOR buffer.