// Copyright 2024 The Wuffs Authors. // // Licensed under the Apache License, Version 2.0 or the MIT license // , 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 // -------- // Quirks are discussed in (/doc/note/quirks.md). // // The base38 encoding of "xz.." is 0x1D_42C0. Left shifting by 10 gives // 0x750B_0000. pri const QUIRKS_BASE : base.u32 = 0x750B_0000 // -------- // When this quirk is set, a positive value means to allow one or more Streams // (which can have trailing Stream Padding). Zero means exactly one Stream (and // decoding stops at the end of that Stream; no Stream Padding is consumed). // // The XZ spec (section 2. Overall Structure of .xz File) says: // // While a typical file contains only one Stream and no Stream Padding, a // decoder handling standalone .xz files SHOULD support files that have more // than one Stream or Stream Padding. // // In contrast to standalone .xz files, when the .xz file format is used as // an internal part of some other file format or communication protocol, it // usually is expected that the decoder stops after the first Stream, and // doesn't look for Stream Padding or possibly other Streams. // // For Wuffs, the quirk value is zero by default, which means to decode the // XZ-as-part-of-something-else format, not the XZ-standalone format. Like most // of Wuffs' other std/foobar quirks, decoding a more lenient variant of the // foobar format is opt-in, not opt-out. pub const QUIRK_DECODE_STANDALONE_CONCATENATED_STREAMS : base.u32 = 0x750B_0000 | 0x00