mirror of
https://github.com/ddidderr/wuffs.git
synced 2026-11-17 16:32:11 +01:00
SPDX is an ISO standard for describing licenses in a computer readable format, which is useful when applying license compliance tools and the like to source code. In addition to ensuring that the Wuffs C distribution is properly annotated to the benefit of projects using Wuffs and SPDX-supporting tools, add it everywhere else where there's a license in this repo for consistency, too.
99 lines
3.8 KiB
C++
99 lines
3.8 KiB
C++
// Copyright 2020 The Wuffs Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0 OR MIT
|
|
|
|
// ---------------- Auxiliary - CBOR
|
|
|
|
namespace wuffs_aux {
|
|
|
|
struct DecodeCborResult {
|
|
DecodeCborResult(std::string&& error_message0, uint64_t cursor_position0);
|
|
|
|
std::string error_message;
|
|
uint64_t cursor_position;
|
|
};
|
|
|
|
class DecodeCborCallbacks {
|
|
public:
|
|
virtual ~DecodeCborCallbacks();
|
|
|
|
// AppendXxx are called for leaf nodes: literals, numbers, strings, etc.
|
|
|
|
virtual std::string AppendNull() = 0;
|
|
virtual std::string AppendUndefined() = 0;
|
|
virtual std::string AppendBool(bool val) = 0;
|
|
virtual std::string AppendF64(double val) = 0;
|
|
virtual std::string AppendI64(int64_t val) = 0;
|
|
virtual std::string AppendU64(uint64_t val) = 0;
|
|
virtual std::string AppendByteString(std::string&& val) = 0;
|
|
virtual std::string AppendTextString(std::string&& val) = 0;
|
|
virtual std::string AppendMinus1MinusX(uint64_t val) = 0;
|
|
virtual std::string AppendCborSimpleValue(uint8_t val) = 0;
|
|
virtual std::string AppendCborTag(uint64_t val) = 0;
|
|
|
|
// Push and Pop are called for container nodes: CBOR arrays (lists) and CBOR
|
|
// maps (dictionaries).
|
|
//
|
|
// The flags bits combine exactly one of:
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__FROM_NONE
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__FROM_LIST
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__FROM_DICT
|
|
// and exactly one of:
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__TO_NONE
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__TO_LIST
|
|
// - WUFFS_BASE__TOKEN__VBD__STRUCTURE__TO_DICT
|
|
|
|
virtual std::string Push(uint32_t flags) = 0;
|
|
virtual std::string Pop(uint32_t flags) = 0;
|
|
|
|
// Done is always the last Callback method called by DecodeCbor, whether or
|
|
// not parsing the input as CBOR encountered an error. Even when successful,
|
|
// trailing data may remain in input and buffer.
|
|
//
|
|
// Do not keep a reference to buffer or buffer.data.ptr after Done returns,
|
|
// as DecodeCbor may then de-allocate the backing array.
|
|
//
|
|
// The default Done implementation is a no-op.
|
|
virtual void //
|
|
Done(DecodeCborResult& result, sync_io::Input& input, IOBuffer& buffer);
|
|
};
|
|
|
|
// The FooArgBar types add structure to Foo's optional arguments. They wrap
|
|
// inner representations for several reasons:
|
|
// - It provides a home for the DefaultValue static method, for Foo callers
|
|
// that want to override some but not all optional arguments.
|
|
// - It provides the "Bar" name at Foo call sites, which can help self-
|
|
// document Foo calls with many arguemnts.
|
|
// - It provides some type safety against accidentally transposing or omitting
|
|
// adjacent fundamentally-numeric-typed optional arguments.
|
|
|
|
// DecodeCborArgQuirks wraps an optional argument to DecodeCbor.
|
|
struct DecodeCborArgQuirks {
|
|
explicit DecodeCborArgQuirks(wuffs_base__slice_u32 repr0);
|
|
explicit DecodeCborArgQuirks(uint32_t* ptr, size_t len);
|
|
|
|
// DefaultValue returns an empty slice.
|
|
static DecodeCborArgQuirks DefaultValue();
|
|
|
|
wuffs_base__slice_u32 repr;
|
|
};
|
|
|
|
// DecodeCbor calls callbacks based on the CBOR-formatted data in input.
|
|
//
|
|
// On success, the returned error_message is empty and cursor_position counts
|
|
// the number of bytes consumed. On failure, error_message is non-empty and
|
|
// cursor_position is the location of the error. That error may be a content
|
|
// error (invalid CBOR) or an input error (e.g. network failure).
|
|
DecodeCborResult //
|
|
DecodeCbor(DecodeCborCallbacks& callbacks,
|
|
sync_io::Input& input,
|
|
DecodeCborArgQuirks quirks = DecodeCborArgQuirks::DefaultValue());
|
|
|
|
} // namespace wuffs_aux
|