swift-mirror/stdlib/public/core/Codable.swift.gyb

//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2017 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//

//===----------------------------------------------------------------------===//
// Codable
//===----------------------------------------------------------------------===//

/// Conformance to `Encodable` indicates that a type can encode itself to an
/// external representation.
public protocol Encodable {
  /// Encodes `self` into the given encoder.
  ///
  /// If `self` fails to encode anything, `encoder` will encode an empty keyed
  /// container in its place.
  ///
  /// - Parameter encoder: The encoder to write data to.
  /// - Throws: An error if any values are invalid for `encoder`'s format.
  func encode(to encoder: Encoder) throws
}

/// Conformance to `Decodable` indicates that a type can decode itself from an
/// external representation.
public protocol Decodable {
  /// Initializes `self` by decoding from `decoder`.
  ///
  /// - Parameter decoder: The decoder to read data from.
  /// - Throws: An error if reading from the decoder fails, or if read data is
  ///   corrupted or otherwise invalid.
  init(from decoder: Decoder) throws
}

/// Conformance to `Codable` indicates that a type can convert itself into and
/// out of an external representation.
public typealias Codable = Encodable & Decodable

//===----------------------------------------------------------------------===//
// CodingKey
//===----------------------------------------------------------------------===//

/// Conformance to `CodingKey` indicates that a type can be used as a key for
/// encoding and decoding.
public protocol CodingKey {
  /// The string to use in a named collection (e.g. a string-keyed dictionary).
  var stringValue: String { get }
  
  /// Initializes `self` from a string.
  ///
  /// - Parameter stringValue: The string value of the desired key.
  /// - Returns: An instance of `Self` from the given string, or `nil` if the
  ///   given string does not correspond to any instance of `Self`.
  init?(stringValue: String)
  
  /// The int to use in an indexed collection (e.g. an int-keyed dictionary).
  var intValue: Int? { get }
  
  /// Initializes `self` from an integer.
  ///
  /// - Parameter intValue: The integer value of the desired key.
  /// - Returns: An instance of `Self` from the given integer, or `nil` if the
  ///   given integer does not correspond to any instance of `Self`.
  init?(intValue: Int)
}

//===----------------------------------------------------------------------===//
// Encoder & Decoder
//===----------------------------------------------------------------------===//

/// An `Encoder` is a type which can encode values into a native format for
/// external representation.
public protocol Encoder {
  /// The path of coding keys taken to get to this point in encoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// Any contextual information set by the user for encoding.
  var userInfo: [CodingUserInfoKey : Any] { get }
  
  /// Returns an encoding container appropriate for holding multiple values
  /// keyed by the given key type.
  ///
  /// - Parameter type: The key type to use for the container.
  /// - Returns: A new keyed encoding container.
  /// - Precondition: May not be called after a prior `self.unkeyedContainer()`
  ///   call.
  /// - Precondition: May not be called after a value has been encoded through
  ///   a previous `self.singleValueContainer()` call.
  func container<Key>(keyedBy type: Key.Type) -> KeyedEncodingContainer<Key>
  
  /// Returns an encoding container appropriate for holding multiple unkeyed
  /// values.
  ///
  /// - Returns: A new empty unkeyed container.
  /// - Precondition: May not be called after a prior
  ///   `self.container(keyedBy:)` call.
  /// - Precondition: May not be called after a value has been encoded through
  ///   a previous `self.singleValueContainer()` call.
  func unkeyedContainer() -> UnkeyedEncodingContainer
  
  /// Returns an encoding container appropriate for holding a single primitive
  /// value.
  ///
  /// - Returns: A new empty single value container.
  /// - Precondition: May not be called after a prior
  ///   `self.container(keyedBy:)` call.
  /// - Precondition: May not be called after a prior `self.unkeyedContainer()`
  ///   call.
  /// - Precondition: May not be called after a value has been encoded through
  ///   a previous `self.singleValueContainer()` call.
  func singleValueContainer() -> SingleValueEncodingContainer
}

/// A `Decoder` is a type which can decode values from a native format into
/// in-memory representations.
public protocol Decoder {
  /// The path of coding keys taken to get to this point in decoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// Any contextual information set by the user for decoding.
  var userInfo: [CodingUserInfoKey : Any] { get }
  
  /// Returns the data stored in `self` as represented in a container keyed by
  /// the given key type.
  ///
  /// - Parameter type: The key type to use for the container.
  /// - Returns: A keyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not a keyed container.
  func container<Key>(keyedBy type: Key.Type) throws
    -> KeyedDecodingContainer<Key>
  
  /// Returns the data stored in `self` as represented in a container
  /// appropriate for holding values with no keys.
  ///
  /// - Returns: An unkeyed container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not an unkeyed container.
  func unkeyedContainer() throws -> UnkeyedDecodingContainer
  
  /// Returns the data stored in `self` as represented in a container
  /// appropriate for holding a single primitive value.
  ///
  /// - Returns: A single value container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not a single value container.
  func singleValueContainer() throws -> SingleValueDecodingContainer
}

//===----------------------------------------------------------------------===//
// Keyed Encoding Containers
//===----------------------------------------------------------------------===//

/// Conformance to `KeyedEncodingContainerProtocol` indicates that a type
/// provides a view into an `Encoder`'s storage and is used to hold the
/// encoded properties of an `Encodable` type in a keyed manner.
///
/// Encoders should provide types conforming to
/// `KeyedEncodingContainerProtocol` for their format.
public protocol KeyedEncodingContainerProtocol {
  associatedtype Key : CodingKey
  
  /// The path of coding keys taken to get to this point in encoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode<T : Encodable>(_ value: T?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Bool?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int8?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int16?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int32?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int64?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt8?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt16?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt32?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt64?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Float?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Double?, forKey key: Key) throws
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: String?, forKey key: Key) throws
  
  /// Encodes the given object weakly for the given key.
  ///
  /// For `Encoder`s that implement this functionality, this will only encode
  /// the given object and associate it with the given key if it is encoded
  /// unconditionally elsewhere in the payload (either previously or in the
  /// future).
  ///
  /// For formats which don't support this feature, the default implementation
  /// encodes the given object unconditionally.
  ///
  /// - Parameters:
  ///   - object: The object to encode.
  ///   - key: The key to associate the object with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encodeWeak<T : AnyObject & Encodable>(
    _ object: T?, forKey key: Key
  ) throws
  
  /// Stores a keyed encoding container for the given key and returns it.
  ///
  /// - Parameters:
  ///   - keyType: The key type to use for the container.
  ///   - key: The key to encode the container for.
  /// - Returns: A new keyed encoding container.
  mutating func nestedContainer<NestedKey>(
    keyedBy keyType: NestedKey.Type, forKey key: Key
  ) -> KeyedEncodingContainer<NestedKey>
  
  /// Stores an unkeyed encoding container for the given key and returns it.
  ///
  /// - Parameter key: The key to encode the container for.
  /// - Returns: A new unkeyed encoding container.
  mutating func nestedUnkeyedContainer(forKey key: Key)
    -> UnkeyedEncodingContainer
  
  /// Stores a new nested container for the default `super` key and returns a
  /// new `Encoder` instance for encoding `super` into that container.
  ///
  /// Equivalent to calling `superEncoder(forKey:)` with
  /// `Key(stringValue: "super", intValue: 0)`.
  ///
  /// - Returns: A new `Encoder` to pass to `super.encode(to:)`.
  mutating func superEncoder() -> Encoder
  
  /// Stores a new nested container for the given key and returns a new
  /// `Encoder` instance for encoding `super` into that container.
  ///
  /// - Parameter key: The key to encode `super` for.
  /// - Returns: A new `Encoder` to pass to `super.encode(to:)`.
  mutating func superEncoder(forKey key: Key) -> Encoder
}

// An implementation of _KeyedEncodingContainerBase and 
// _KeyedEncodingContainerBox are given at the bottom of this file.

/// `KeyedEncodingContainer` is a type-erased box for
/// `KeyedEncodingContainerProtocol` types, similar to `AnyCollection` and
/// `AnyHashable`. This is the type which consumers of the API interact with
/// directly.
public struct KeyedEncodingContainer<K : CodingKey> {
  public typealias Key = K
  
  /// The container for the concrete encoder. The type is _*Base so that it's
  /// generic on the key type.
  @_versioned
  internal var _box: _KeyedEncodingContainerBase<Key>
  
  /// Initializes `self` with the given container.
  ///
  /// - Parameter container: The container to hold.
  public init<Container : KeyedEncodingContainerProtocol>(
    _ container: Container
  ) where Container.Key == Key {
    _box = _KeyedEncodingContainerBox(container)
  }
  
  /// The path of coding keys taken to get to this point in encoding. A `nil`
  /// value indicates an unkeyed container.
  public var codingPath: [CodingKey?] {
    return _box.codingPath
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Bool?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Int?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Int8?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Int16?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Int32?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Int64?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: UInt?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: UInt8?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: UInt16?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: UInt32?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: UInt64?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Float?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: Double?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode(_ value: String?, forKey key: Key) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given value for the given key.
  ///
  /// - Parameters:
  ///   - value: The value to encode.
  ///   - key: The key to associate the value with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encode<T : Encodable>(
    _ value: T?, forKey key: Key
  ) throws {
    try _box.encode(value, forKey: key)
  }
  
  /// Encodes the given object weakly for the given key.
  ///
  /// For `Encoder`s that implement this functionality, this will only encode
  /// the given object and associate it with the given key if it is encoded
  /// unconditionally elsewhere in the payload (either previously or in the
  /// future).
  ///
  /// - Parameters:
  ///   - object: The object to encode.
  ///   - key: The key to associate the object with.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  public mutating func encodeWeak<T : AnyObject & Encodable>(
    _ object: T?, forKey key: Key
  ) throws {
    try _box.encodeWeak(object, forKey: key)
  }
  
  /// Stores a keyed encoding container for the given key and returns it.
  ///
  /// - Parameters:
  ///   - keyType: The key type to use for the container.
  ///   - key: The key to encode the container for.
  /// - Returns: A new keyed encoding container.
  public mutating func nestedContainer<NestedKey>(
    keyedBy keyType: NestedKey.Type, forKey key: Key
  ) -> KeyedEncodingContainer<NestedKey> {
    return _box.nestedContainer(keyedBy: NestedKey.self, forKey: key)
  }
  
  /// Stores an unkeyed encoding container for the given key and returns it.
  ///
  /// - Parameter key: The key to encode the container for.
  /// - Returns: A new unkeyed encoding container.
  public mutating func nestedUnkeyedContainer(forKey key: Key)
    -> UnkeyedEncodingContainer {
    return _box.nestedUnkeyedContainer(forKey: key)
  }
  
  /// Stores a new nested container for the default `super` key and returns a
  /// new `Encoder` instance for encoding `super` into that container.
  ///
  /// Equivalent to calling `superEncoder(forKey:)` with
  /// `Key(stringValue: "super", intValue: 0)`.
  ///
  /// - Returns: A new `Encoder` to pass to `super.encode(to:)`.
  public mutating func superEncoder() -> Encoder {
    return _box.superEncoder()
  }
  
  /// Stores a new nested container for the given key and returns a new
  /// `Encoder` instance for encoding `super` into that container.
  ///
  /// - Parameter key: The key to encode `super` for.
  /// - Returns: A new `Encoder` to pass to `super.encode(to:)`.
  public mutating func superEncoder(forKey key: Key) -> Encoder {
    return _box.superEncoder(forKey: key)
  }
}

/// Conformance to `KeyedDecodingContainerProtocol` indicates that a type
/// provides a view into a `Decoder`'s storage and is used to hold the encoded
/// properties of a `Decodable` type in a keyed manner.
///
/// Decoders should provide types conforming to `UnkeyedDecodingContainer` for
/// their format.
public protocol KeyedDecodingContainerProtocol {
  associatedtype Key : CodingKey
  
  /// The path of coding keys taken to get to this point in decoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// All the keys the `Decoder` has for this container.
  ///
  /// Different keyed containers from the same `Decoder` may return different
  /// keys here; it is possible to encode with multiple key types which are
  /// not convertible to one another. This should report all keys present
  /// which are convertible to the requested type.
  var allKeys: [Key] { get }
  
  /// Returns whether the `Decoder` contains a value associated with the given
  /// key.
  ///
  /// The value associated with the given key may be a null value as
  /// appropriate for the data format.
  ///
  /// - Parameter key: The key to search for.
  /// - Returns: Whether the `Decoder` has an entry for the given key.
  func contains(_ key: Key) -> Bool
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Bool.Type, forKey key: Key) throws -> Bool
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Int.Type, forKey key: Key) throws -> Int
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Int8.Type, forKey key: Key) throws -> Int8
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Int16.Type, forKey key: Key) throws -> Int16
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Int32.Type, forKey key: Key) throws -> Int32
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Int64.Type, forKey key: Key) throws -> Int64
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: UInt.Type, forKey key: Key) throws -> UInt
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: UInt8.Type, forKey key: Key) throws -> UInt8
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: UInt16.Type, forKey key: Key) throws -> UInt16
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: UInt32.Type, forKey key: Key) throws -> UInt32
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: UInt64.Type, forKey key: Key) throws -> UInt64
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Float.Type, forKey key: Key) throws -> Float
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: Double.Type, forKey key: Key) throws -> Double
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode(_ type: String.Type, forKey key: Key) throws -> String
  
  /// Decodes a value of the given type for the given key.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func decode<T : Decodable>(_ type: T.Type, forKey key: Key) throws -> T
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Bool.Type, forKey key: Key) throws -> Bool?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Int.Type, forKey key: Key) throws -> Int?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Int8.Type, forKey key: Key) throws -> Int8?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Int16.Type, forKey key: Key) throws -> Int16?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Int32.Type, forKey key: Key) throws -> Int32?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Int64.Type, forKey key: Key) throws -> Int64?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: UInt.Type, forKey key: Key) throws -> UInt?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: UInt8.Type, forKey key: Key) throws -> UInt8?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: UInt16.Type, forKey key: Key) throws -> UInt16?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: UInt32.Type, forKey key: Key) throws -> UInt32?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: UInt64.Type, forKey key: Key) throws -> UInt64?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Float.Type, forKey key: Key) throws -> Float?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: Double.Type, forKey key: Key) throws -> Double?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent(_ type: String.Type, forKey key: Key) throws -> String?
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  func decodeIfPresent<T : Decodable>(_ type: T.Type, forKey key: Key) throws -> T?
  
  /// Returns the data stored for the given key as represented in a container
  /// keyed by the given key type.
  ///
  /// - Parameters:
  ///   - type: The key type to use for the container.
  ///   - key: The key that the nested container is associated with.
  /// - Returns: A keyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not a keyed container.
  func nestedContainer<NestedKey>(
    keyedBy type: NestedKey.Type, forKey key: Key
  ) throws -> KeyedDecodingContainer<NestedKey>
  
  /// Returns the data stored for the given key as represented in an unkeyed
  /// container.
  ///
  /// - Parameter key: The key that the nested container is associated with.
  /// - Returns: An unkeyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not an unkeyed container.
  func nestedUnkeyedContainer(forKey key: Key) throws
    -> UnkeyedDecodingContainer
  
  /// Returns a `Decoder` instance for decoding `super` from the container
  /// associated with the default `super` key.
  ///
  /// Equivalent to calling `superDecoder(forKey:)` with
  /// `Key(stringValue: "super", intValue: 0)`.
  ///
  /// - Returns: A new `Decoder` to pass to `super.init(from:)`.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the default `super` key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the default `super` key.
  func superDecoder() throws -> Decoder
  
  /// Returns a `Decoder` instance for decoding `super` from the container
  /// associated with the given key.
  ///
  /// - Parameter key: The key to decode `super` for.
  /// - Returns: A new `Decoder` to pass to `super.init(from:)`.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  func superDecoder(forKey key: Key) throws -> Decoder
}

// An implementation of _KeyedDecodingContainerBase and _KeyedDecodingContainerBox are given at the bottom of this file.
/// `KeyedDecodingContainer` is a type-erased box for
/// `KeyedDecodingContainerProtocol` types, similar to `AnyCollection` and
/// `AnyHashable`. This is the type which consumers of the API interact with
/// directly.
public struct KeyedDecodingContainer<K : CodingKey> :
  KeyedDecodingContainerProtocol {

  public typealias Key = K
  
  /// The container for the concrete decoder. The type is _*Base so that it's
  /// generic on the key type.
  @_versioned
  internal var _box: _KeyedDecodingContainerBase<Key>
  
  /// Initializes `self` with the given container.
  ///
  /// - Parameter container: The container to hold.
  public init<Container : KeyedDecodingContainerProtocol>(
    _ container: Container
  ) where Container.Key == Key {
    _box = _KeyedDecodingContainerBox(container)
  }
  
  /// The path of coding keys taken to get to this point in decoding. A `nil`
  /// value indicates an unkeyed container.
  public var codingPath: [CodingKey?] {
    return _box.codingPath
  }
  
  /// All the keys the `Decoder` has for this container.
  ///
  /// Different keyed containers from the same `Decoder` may return different
  /// keys here; it is possible to encode with multiple key types which are
  /// not convertible to one another. This should report all keys present
  /// which are convertible to the requested type.
  public var allKeys: [Key] {
    return _box.allKeys
  }
  
  /// Returns whether the `Decoder` contains a value associated with the given
  /// key.
  ///
  /// The value associated with the given key may be a null value as
  /// appropriate for the data format.
  ///
  /// - Parameter key: The key to search for.
  /// - Returns: Whether the `Decoder` has an entry for the given key.
  public func contains(_ key: Key) -> Bool {
    return _box.contains(key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Bool.Type, forKey key: Key) throws
    -> Bool? {
    return try _box.decodeIfPresent(Bool.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Int.Type, forKey key: Key) throws
    -> Int? {
    return try _box.decodeIfPresent(Int.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Int8.Type, forKey key: Key) throws
    -> Int8? {
    return try _box.decodeIfPresent(Int8.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Int16.Type, forKey key: Key) throws
    -> Int16? {
    return try _box.decodeIfPresent(Int16.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Int32.Type, forKey key: Key) throws
    -> Int32? {
    return try _box.decodeIfPresent(Int32.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Int64.Type, forKey key: Key) throws
    -> Int64? {
    return try _box.decodeIfPresent(Int64.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: UInt.Type, forKey key: Key) throws
    -> UInt? {
    return try _box.decodeIfPresent(UInt.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: UInt8.Type, forKey key: Key) throws
    -> UInt8? {
    return try _box.decodeIfPresent(UInt8.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: UInt16.Type, forKey key: Key) throws
    -> UInt16? {
    return try _box.decodeIfPresent(UInt16.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: UInt32.Type, forKey key: Key) throws
    -> UInt32? {
    return try _box.decodeIfPresent(UInt32.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: UInt64.Type, forKey key: Key) throws
    -> UInt64? {
    return try _box.decodeIfPresent(UInt64.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Float.Type, forKey key: Key) throws
    -> Float? {
    return try _box.decodeIfPresent(Float.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: Double.Type, forKey key: Key) throws
    -> Double? {
    return try _box.decodeIfPresent(Double.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent(_ type: String.Type, forKey key: Key) throws
    -> String? {
    return try _box.decodeIfPresent(String.self, forKey: key)
  }
  
  /// Decodes a value of the given type for the given key, if present.
  ///
  /// This method returns `nil` if the container does not have a value
  /// associated with `key`, or if the value is null. The difference between
  /// these states can be distinguished with a `contains(_:)` call.
  ///
  /// - Parameters:
  ///   - type: The type of value to decode.
  ///   - key: The key that the decoded value is associated with.
  /// - Returns: A decoded value of the requested type, or `nil` if the
  ///   `Decoder` does not have an entry associated with the given key, or if
  ///   the value is a null value.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  public func decodeIfPresent<T : Decodable>(
    _ type: T.Type, forKey key: Key
  ) throws -> T? {
    return try _box.decodeIfPresent(T.self, forKey: key)
  }
  
  /// Returns the data stored for the given key as represented in a container
  /// keyed by the given key type.
  ///
  /// - Parameters:
  ///   - type: The key type to use for the container.
  ///   - key: The key that the nested container is associated with.
  /// - Returns: A keyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not a keyed container.
  public func nestedContainer<NestedKey>(
    keyedBy type: NestedKey.Type, forKey key: Key
  ) throws -> KeyedDecodingContainer<NestedKey> {
    return try _box.nestedContainer(keyedBy: NestedKey.self, forKey: key)
  }
  
  /// Returns the data stored for the given key as represented in an unkeyed
  /// container.
  ///
  /// - Parameter key: The key that the nested container is associated with.
  /// - Returns: An unkeyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not an unkeyed container.
  public func nestedUnkeyedContainer(forKey key: Key) throws
    -> UnkeyedDecodingContainer {
    return try _box.nestedUnkeyedContainer(forKey: key)
  }
  
  /// Returns a `Decoder` instance for decoding `super` from the container
  /// associated with the default `super` key.
  ///
  /// Equivalent to calling `superDecoder(forKey:)` with
  /// `Key(stringValue: "super", intValue: 0)`.
  ///
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the default `super` key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the default `super` key.
  public func superDecoder() throws -> Decoder {
    return try _box.superDecoder()
  }
  
  /// Returns a `Decoder` instance for decoding `super` from the container
  /// associated with the given key.
  ///
  /// - Parameter key: The key to decode `super` for.
  /// - Returns: A new `Decoder` to pass to `super.init(from:)`.
  /// - Throws: `DecodingError.keyNotFound` if `self` does not have an entry
  ///   for the given key.
  /// - Throws: `DecodingError.valueNotFound` if `self` has a null entry for
  ///   the given key.
  public func superDecoder(forKey key: Key) throws -> Decoder {
    return try _box.superDecoder(forKey: key)
  }
}

//===----------------------------------------------------------------------===//
// Unkeyed Encoding Containers
//===----------------------------------------------------------------------===//

/// Conformance to `UnkeyedEncodingContainer` indicates that a type provides a
/// view into an `Encoder`'s storage and is used to hold the encoded
/// properties of an `Encodable` type sequentially, without keys.
///
/// Encoders should provide types conforming to `UnkeyedEncodingContainer` for
/// their format.
public protocol UnkeyedEncodingContainer {
  /// The path of coding keys taken to get to this point in encoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode<T : Encodable>(_ value: T?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Bool?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int8?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int16?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int32?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Int64?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt8?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt16?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt32?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: UInt64?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Float?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: Double?) throws
  
  /// Encodes the given value.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encode(_ value: String?) throws
  
  /// Encodes the given object weakly.
  ///
  /// For `Encoder`s that implement this functionality, this will only encode
  /// the given object if it is encoded unconditionally elsewhere in the
  /// payload (either previously or in the future).
  ///
  /// For formats which don't support this feature, the default implementation
  /// encodes the given object unconditionally.
  ///
  /// - Parameter object: The object to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  mutating func encodeWeak<T : AnyObject & Encodable>(_ object: T?) throws
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Bool
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int8
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int16
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int32
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int64
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt8
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt16
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt32
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt64
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Float
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Double
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == String
  
  /// Encodes the elements of the given sequence.
  ///
  /// - Parameter sequence: The sequences whose contents to encode.
  /// - Throws: An error if any of the contained values throws an error.
  mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element : Encodable
  
  /// Encodes a nested container keyed by the given type and returns it.
  ///
  /// - Parameter keyType: The key type to use for the container.
  /// - Returns: A new keyed encoding container.
  mutating func nestedContainer<NestedKey>(keyedBy keyType: NestedKey.Type)
    -> KeyedEncodingContainer<NestedKey>
  
  /// Encodes an unkeyed encoding container and returns it.
  ///
  /// - Returns: A new unkeyed encoding container.
  mutating func nestedUnkeyedContainer() -> UnkeyedEncodingContainer
  
  /// Encodes a nested container and returns an `Encoder` instance for encoding
  /// `super` into that container.
  ///
  /// - Returns: A new `Encoder` to pass to `super.encode(to:)`.
  mutating func superEncoder() -> Encoder
}

/// Conformance to `UnkeyedDecodingContainer` indicates that a type provides a
/// view into a `Decoder`'s storage and is used to hold the encoded properties
/// of a `Decodable` type sequentially, without keys.
///
/// Decoders should provide types conforming to `UnkeyedDecodingContainer` for
/// their format.
public protocol UnkeyedDecodingContainer {
  /// The path of coding keys taken to get to this point in decoding. A `nil`
  /// value indicates an unkeyed container.
  var codingPath: [CodingKey?] { get }
  
  /// Returns the number of elements (if known) contained within this
  /// container.
  var count: Int? { get }
  
  /// Returns whether there are no more elements left to be decoded in the
  /// container.
  var isAtEnd: Bool { get }
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Bool.Type) throws -> Bool
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Int.Type) throws -> Int
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Int8.Type) throws -> Int8
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Int16.Type) throws -> Int16
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Int32.Type) throws -> Int32
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Int64.Type) throws -> Int64
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: UInt.Type) throws -> UInt
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: UInt8.Type) throws -> UInt8
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: UInt16.Type) throws -> UInt16
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: UInt32.Type) throws -> UInt32
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: UInt64.Type) throws -> UInt64
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Float.Type) throws -> Float
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: Double.Type) throws -> Double
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode(_ type: String.Type) throws -> String
  
  /// Decodes a value of the given type.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A value of the requested type, if present for the given key
  ///   and convertible to the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func decode<T : Decodable>(_ type: T.Type) throws -> T
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Bool.Type) throws -> Bool?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Int.Type) throws -> Int?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Int8.Type) throws -> Int8?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Int16.Type) throws -> Int16?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Int32.Type) throws -> Int32?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Int64.Type) throws -> Int64?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: UInt.Type) throws -> UInt?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: UInt8.Type) throws -> UInt8?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: UInt16.Type) throws -> UInt16?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: UInt32.Type) throws -> UInt32?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: UInt64.Type) throws -> UInt64?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Float.Type) throws -> Float?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: Double.Type) throws -> Double?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent(_ type: String.Type) throws -> String?
  
  /// Decodes a value of the given type, if present.
  ///
  /// This method returns `nil` if the container has no elements left to
  /// decode, or if the value is null. The difference between these states can
  /// be distinguished by checking `isAtEnd`.
  ///
  /// - Parameter type: The type of value to decode.
  /// - Returns: A decoded value of the requested type, or `nil` if the value
  ///   is a null value, or if there are no more elements to decode.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   is not convertible to the requested type.
  mutating func decodeIfPresent<T : Decodable>(_ type: T.Type) throws -> T?
  
  /// Decodes a nested container keyed by the given type.
  ///
  /// - Parameter type: The key type to use for the container.
  /// - Returns: A keyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not a keyed container.
  mutating func nestedContainer<NestedKey>(keyedBy type: NestedKey.Type) throws
    -> KeyedDecodingContainer<NestedKey>
  
  /// Decodes an unkeyed nested container.
  ///
  /// - Returns: An unkeyed decoding container view into `self`.
  /// - Throws: `DecodingError.typeMismatch` if the encountered stored value is
  ///   not an unkeyed container.
  mutating func nestedUnkeyedContainer() throws -> UnkeyedDecodingContainer
  
  /// Decodes a nested container and returns a `Decoder` instance for decoding
  /// `super` from that container.
  ///
  /// - Returns: A new `Decoder` to pass to `super.init(from:)`.
  /// - Throws: `DecodingError.valueNotFound` if the encountered encoded value
  ///   is null, or of there are no more values to decode.
  mutating func superDecoder() throws -> Decoder
}

//===----------------------------------------------------------------------===//
// Single Value Encoding Containers
//===----------------------------------------------------------------------===//

/// A `SingleValueEncodingContainer` is a container which can support the
/// storage and direct encoding of a single non-keyed value.
public protocol SingleValueEncodingContainer {
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Bool) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Int) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Int8) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Int16) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Int32) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Int64) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: UInt) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: UInt8) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: UInt16) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: UInt32) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: UInt64) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Float) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: Double) throws
  
  /// Encodes a single value of the given type.
  ///
  /// - Parameter value: The value to encode.
  /// - Throws: `EncodingError.invalidValue` if the given value is invalid in
  ///   the current context for this format.
  /// - Precondition: May not be called after a previous `self.encode(_:)`
  ///   call.
  mutating func encode(_ value: String) throws
}

/// A `SingleValueDecodingContainer` is a container which can support the
/// storage and direct decoding of a single non-keyed value.
public protocol SingleValueDecodingContainer {
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Bool.Type) throws -> Bool
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Int.Type) throws -> Int
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Int8.Type) throws -> Int8
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Int16.Type) throws -> Int16
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Int32.Type) throws -> Int32
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Int64.Type) throws -> Int64
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: UInt.Type) throws -> UInt
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: UInt8.Type) throws -> UInt8
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: UInt16.Type) throws -> UInt16
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: UInt32.Type) throws -> UInt32
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: UInt64.Type) throws -> UInt64
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Float.Type) throws -> Float
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: Double.Type) throws -> Double
  
  /// Decodes a single value of the given type.
  ///
  /// - Parameter type: The type to decode as.
  /// - Returns: A value of the requested type.
  /// - Throws: `DecodingError.typeMismatch` if the encountered encoded value
  ///   cannot be converted to the requested type.
  func decode(_ type: String.Type) throws -> String
}

//===----------------------------------------------------------------------===//
// User Info
//===----------------------------------------------------------------------===//

/// Represents a user-defined key for providing context for encoding and
/// decoding.
public struct CodingUserInfoKey : RawRepresentable, Equatable, Hashable {
  public typealias RawValue = String
  
  /// The key's string value.
  public let rawValue: String
  
  /// Initializes `self` with the given raw value.
  ///
  /// - Parameter rawValue: The value of the key.
  public init?(rawValue: String) {
    self.rawValue = rawValue
  }
  
  /// Returns whether the given keys are equal.
  ///
  /// - Parameters:
  ///   - lhs: The key to compare against.
  ///   - rhs: The key to compare with.
  public static func ==(_ lhs: CodingUserInfoKey, _ rhs: CodingUserInfoKey)
    -> Bool {
    return lhs.rawValue == rhs.rawValue
  }
  
  /// The key's hash value.
  public var hashValue: Int {
    return self.rawValue.hashValue
  }
}

//===----------------------------------------------------------------------===//
// Errors
//===----------------------------------------------------------------------===//

/// An `EncodingError` indicates that something has gone wrong during encoding
/// of a value.
public enum EncodingError : Error {
  /// The context in which the error occurred.
  public struct Context {
    /// The path of `CodingKey`s taken to get to the point of the failing
    /// encode call.
    public let codingPath: [CodingKey?]
    
    /// A description of what went wrong, for debugging purposes.
    public let debugDescription: String
    
    /// Initializes `self` with the given path of `CodingKey`s and a
    /// description of what went wrong.
    ///
    /// - Parameter codingPath: The path of `CodingKey`s taken to get to the
    ///   point of the failing encode call.
    /// - Parameter debugDescription: A description of what went wrong, for
    ///   debugging purposes.
    public init(codingPath: [CodingKey?], debugDescription: String) {
      self.codingPath = codingPath
      self.debugDescription = debugDescription
    }
  }
  
  /// `.invalidValue` indicates that an `Encoder` or its containers could not
  /// encode the given value.
  ///
  /// Contains the attempted value, along with context for debugging.
  case invalidValue(Any, Context)
}

/// A `DecodingError` indicates that something has gone wrong during decoding
/// of a value.
public enum DecodingError : Error {
  /// The context in which the error occurred.
  public struct Context {
    /// The path of `CodingKey`s taken to get to the point of the failing
    /// decode call.
    public let codingPath: [CodingKey?]
    
    /// A description of what went wrong, for debugging purposes.
    public let debugDescription: String
    
    /// Initializes `self` with the given path of `CodingKey`s and a
    /// description of what went wrong.
    ///
    /// - Parameter codingPath: The path of `CodingKey`s taken to get to the
    ///   point of the failing decode call.
    /// - Parameter debugDescription: A description of what went wrong, for
    ///   debugging purposes.
    public init(codingPath: [CodingKey?], debugDescription: String) {
      self.codingPath = codingPath
      self.debugDescription = debugDescription
    }
  }
  
  /// `.typeMismatch` indicates that a value of the given type could not be
  /// decoded because it did not match the type of what was found in the
  /// encoded payload.
  ///
  /// Contains the attempted type, along with context for debugging.
  case typeMismatch(Any.Type, Context)
  
  /// `.valueNotFound` indicates that a non-optional value of the given type
  /// was expected, but a null value was found.
  ///
  /// Contains the attempted type, along with context for debugging.
  case valueNotFound(Any.Type, Context)
  
  /// `.keyNotFound` indicates that a `KeyedDecodingContainer` was asked for an
  /// entry for the given key, but did not contain one.
  ///
  /// Contains the attempted key, along with context for debugging.
  case keyNotFound(CodingKey, Context)
  
  /// `.dataCorrupted` indicates that the data is corrupted or otherwise
  /// invalid.
  ///
  /// Contains context for debugging.
  case dataCorrupted(Context)
}

//===----------------------------------------------------------------------===//
// Keyed Encoding Container Implementations
//===----------------------------------------------------------------------===//

@_fixed_layout
@_versioned
internal class _KeyedEncodingContainerBase<Key : CodingKey> {
  // These must all be given a concrete implementation in _*Box.
  @_inlineable
  @_versioned
  internal var codingPath: [CodingKey?] {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Bool?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Int?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Int8?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Int16?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Int32?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Int64?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: UInt?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: UInt8?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: UInt16?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: UInt32?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: UInt64?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Float?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: Double?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode(_ value: String?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encode<T : Encodable>(_ value: T?, forKey key: Key) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func encodeWeak<T : AnyObject & Encodable>(
    _ object: T?, forKey key: Key
  ) throws {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func nestedContainer<NestedKey>(
    keyedBy keyType: NestedKey.Type, forKey key: Key
  ) -> KeyedEncodingContainer<NestedKey> {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func nestedUnkeyedContainer(forKey key: Key)
    -> UnkeyedEncodingContainer {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func superEncoder() -> Encoder {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func superEncoder(forKey key: Key) -> Encoder {
    fatalError("_KeyedEncodingContainerBase cannot be used directly.")
  }
}

@_fixed_layout
@_versioned
internal final class _KeyedEncodingContainerBox<
  Concrete : KeyedEncodingContainerProtocol
> : _KeyedEncodingContainerBase<Concrete.Key> {
  typealias Key = Concrete.Key
  
  @_versioned
  internal var concrete: Concrete
  
  @_inlineable
  @_versioned
  internal init(_ container: Concrete) {
    concrete = container
  }
  
  @_inlineable
  @_versioned
  override internal var codingPath: [CodingKey?] {
    return concrete.codingPath
  }
  
  @_inlineable
  @_versioned
  override internal func encode<T : Encodable>(
    _ value: T?, forKey key: Key
  ) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Bool?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Int?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Int8?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Int16?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Int32?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Int64?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: UInt?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: UInt8?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: UInt16?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: UInt32?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: UInt64?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Float?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: Double?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encode(_ value: String?, forKey key: Key) throws {
    try concrete.encode(value, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func encodeWeak<T : AnyObject & Encodable>(
    _ object: T?, forKey key: Key
  ) throws {
    try concrete.encodeWeak(object, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func nestedContainer<NestedKey>(
    keyedBy keyType: NestedKey.Type, forKey key: Key
  ) -> KeyedEncodingContainer<NestedKey> {
    return concrete.nestedContainer(keyedBy: NestedKey.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func nestedUnkeyedContainer(forKey key: Key)
    -> UnkeyedEncodingContainer {
    return concrete.nestedUnkeyedContainer(forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func superEncoder() -> Encoder {
    return concrete.superEncoder()
  }
  
  @_inlineable
  @_versioned
  override internal func superEncoder(forKey key: Key) -> Encoder {
    return concrete.superEncoder(forKey: key)
  }
}

@_fixed_layout
@_versioned
internal class _KeyedDecodingContainerBase<Key : CodingKey> {
  @_inlineable
  @_versioned
  internal var codingPath: [CodingKey?] {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal var allKeys: [Key] {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func contains(_ key: Key) -> Bool {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Bool.Type, forKey key: Key) throws
    -> Bool? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Int.Type, forKey key: Key) throws
    -> Int? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Int8.Type, forKey key: Key) throws
    -> Int8? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Int16.Type, forKey key: Key) throws
    -> Int16? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Int32.Type, forKey key: Key) throws
    -> Int32? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Int64.Type, forKey key: Key) throws
    -> Int64? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: UInt.Type, forKey key: Key) throws
    -> UInt? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: UInt8.Type, forKey key: Key) throws
    -> UInt8? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: UInt16.Type, forKey key: Key) throws
    -> UInt16? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: UInt32.Type, forKey key: Key) throws
    -> UInt32? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: UInt64.Type, forKey key: Key) throws
    -> UInt64? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Float.Type, forKey key: Key) throws
    -> Float? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: Double.Type, forKey key: Key) throws
    -> Double? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent(_ type: String.Type, forKey key: Key) throws
    -> String? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func decodeIfPresent<T : Decodable>(
    _ type: T.Type, forKey key: Key
  ) throws -> T? {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func nestedContainer<NestedKey>(
    keyedBy type: NestedKey.Type, forKey key: Key
  ) throws -> KeyedDecodingContainer<NestedKey> {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func nestedUnkeyedContainer(forKey key: Key) throws
    -> UnkeyedDecodingContainer {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func superDecoder() throws -> Decoder {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
  
  @_inlineable
  @_versioned
  internal func superDecoder(forKey key: Key) throws -> Decoder {
    fatalError("_KeyedDecodingContainerBase cannot be used directly.")
  }
}

@_fixed_layout
@_versioned
internal final class _KeyedDecodingContainerBox<
  Concrete : KeyedDecodingContainerProtocol
> : _KeyedDecodingContainerBase<Concrete.Key> {
  typealias Key = Concrete.Key
  
  @_versioned
  internal var concrete: Concrete
  
  @_inlineable
  @_versioned
  internal init(_ container: Concrete) {
    concrete = container
  }
  
  @_inlineable
  @_versioned
  override var codingPath: [CodingKey?] {
    return concrete.codingPath
  }
  
  @_inlineable
  @_versioned
  override var allKeys: [Key] {
    return concrete.allKeys
  }
  
  @_inlineable
  @_versioned
  override internal func contains(_ key: Key) -> Bool {
    return concrete.contains(key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Bool.Type, forKey key: Key
  ) throws -> Bool? {
    return try concrete.decodeIfPresent(Bool.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Int.Type, forKey key: Key
  ) throws -> Int? {
    return try concrete.decodeIfPresent(Int.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Int8.Type, forKey key: Key
  ) throws -> Int8? {
    return try concrete.decodeIfPresent(Int8.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Int16.Type, forKey key: Key
  ) throws -> Int16? {
    return try concrete.decodeIfPresent(Int16.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Int32.Type, forKey key: Key
  ) throws -> Int32? {
    return try concrete.decodeIfPresent(Int32.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Int64.Type, forKey key: Key
  ) throws -> Int64? {
    return try concrete.decodeIfPresent(Int64.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: UInt.Type, forKey key: Key
  ) throws -> UInt? {
    return try concrete.decodeIfPresent(UInt.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: UInt8.Type, forKey key: Key
  ) throws -> UInt8? {
    return try concrete.decodeIfPresent(UInt8.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: UInt16.Type, forKey key: Key
  ) throws -> UInt16? {
    return try concrete.decodeIfPresent(UInt16.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: UInt32.Type, forKey key: Key
  ) throws -> UInt32? {
    return try concrete.decodeIfPresent(UInt32.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: UInt64.Type, forKey key: Key
  ) throws -> UInt64? {
    return try concrete.decodeIfPresent(UInt64.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Float.Type, forKey key: Key
  ) throws -> Float? {
    return try concrete.decodeIfPresent(Float.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: Double.Type, forKey key: Key
  ) throws -> Double? {
    return try concrete.decodeIfPresent(Double.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent(
    _ type: String.Type, forKey key: Key
  ) throws -> String? {
    return try concrete.decodeIfPresent(String.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func decodeIfPresent<T : Decodable>(
  	_ type: T.Type, forKey key: Key
  ) throws -> T? {
    return try concrete.decodeIfPresent(T.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func nestedContainer<NestedKey>(
  	keyedBy type: NestedKey.Type, forKey key: Key
  ) throws -> KeyedDecodingContainer<NestedKey> {
    return try concrete.nestedContainer(keyedBy: NestedKey.self, forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func nestedUnkeyedContainer(forKey key: Key) throws 
  	-> UnkeyedDecodingContainer {
    return try concrete.nestedUnkeyedContainer(forKey: key)
  }
  
  @_inlineable
  @_versioned
  override internal func superDecoder() throws -> Decoder {
    return try concrete.superDecoder()
  }
  
  @_inlineable
  @_versioned
  override internal func superDecoder(forKey key: Key) throws -> Decoder {
    return try concrete.superDecoder(forKey: key)
  }
}

//===----------------------------------------------------------------------===//
// Primitive and RawRepresentable Extensions
//===----------------------------------------------------------------------===//

extension Bool : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Bool.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Int : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Int.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Int8 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Int8.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Int16 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Int16.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Int32 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Int32.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Int64 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Int64.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension UInt : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(UInt.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension UInt8 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(UInt8.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension UInt16 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(UInt16.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension UInt32 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(UInt32.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension UInt64 : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(UInt64.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Float : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Float.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension Double : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(Double.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

extension String : Codable {
  public init(from decoder: Decoder) throws {
    self = try decoder.singleValueContainer().decode(String.self)
  }
  
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self)
  }
}

public extension RawRepresentable where RawValue == Bool, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Bool, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Int, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Int, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Int8, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Int8, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Int16, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Int16, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Int32, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Int32, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Int64, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Int64, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == UInt, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == UInt, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == UInt8, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == UInt8, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == UInt16, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == UInt16, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == UInt32, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == UInt32, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == UInt64, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == UInt64, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Float, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Float, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == Double, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == Double, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

public extension RawRepresentable where RawValue == String, Self : Encodable {
  public func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(self.rawValue)
  }
}

public extension RawRepresentable where RawValue == String, Self : Decodable {
  public init(from decoder: Decoder) throws {
    let decoded = try decoder.singleValueContainer().decode(RawValue.self)
    guard let value = Self(rawValue: decoded) else {
      throw DecodingError.dataCorrupted(
        DecodingError.Context(codingPath: decoder.codingPath, 
          debugDescription: "Cannot initialize \(Self.self) from invalid \(RawValue.self) value \(decoded)"))
    }
    
    self = value
  }
}

//===----------------------------------------------------------------------===//
// Collection Extensions
//===----------------------------------------------------------------------===//

// FIXME: Uncomment when conditional conformance is available.
extension Array : Codable /* where Element : Codable */ {
  public init(from decoder: Decoder) throws {
    guard Element.self is Decodable.Type else {
      preconditionFailure("Array<\(Element.self)> does not conform to Decodable because \(Element.self) does not conform to Decodable.")
    }
    
    self.init()
    
    let metaType = (Element.self as! Decodable.Type)
    var container = try decoder.unkeyedContainer()
    while !container.isAtEnd {
      // superDecoder fetches the next element as a container and wraps a Decoder around 
      // it. This is normally appropriate for decoding super, but this is really what we 
      // want to do.
      let subdecoder = try container.superDecoder()
      let element = try metaType.init(from: subdecoder)
      self.append(element as! Element)
    }
  }
  
  public func encode(to encoder: Encoder) throws {
    guard Element.self is Encodable.Type else {
      preconditionFailure("Array<\(Element.self)> does not conform to Encodable because \(Element.self) does not conform to Encodable.")
    }
    
    var container = encoder.unkeyedContainer()
    for element in self {
      // superEncoder appends an empty element and wraps an Encoder around it.
      // This is normally appropriate for encoding super, but this is really what we want 
      // to do.
      let subencoder = container.superEncoder()
      try (element as! Encodable).encode(to: subencoder)
    }
  }
}

//===----------------------------------------------------------------------===//
// Convenience Default Implementations
//===----------------------------------------------------------------------===//

// Default implementation for encodeWeak(_:forKey:) in terms of encode(_:forKey:)
public extension KeyedEncodingContainerProtocol {
  public mutating func encodeWeak<T : AnyObject & Encodable>(
  	_ object: T?, forKey key: Key
  ) throws {
    try encode(object, forKey: key)
  }
}

// Default implementations for decode(_:forKey:) in terms of decodeIfPresent(_:forKey:)
public extension KeyedDecodingContainerProtocol {
  public func decode(_ type: Bool.Type, forKey key: Key) throws -> Bool {
    if let value = try decodeIfPresent(Bool.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Int.Type, forKey key: Key) throws -> Int {
    if let value = try decodeIfPresent(Int.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Int8.Type, forKey key: Key) throws -> Int8 {
    if let value = try decodeIfPresent(Int8.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Int16.Type, forKey key: Key) throws -> Int16 {
    if let value = try decodeIfPresent(Int16.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Int32.Type, forKey key: Key) throws -> Int32 {
    if let value = try decodeIfPresent(Int32.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Int64.Type, forKey key: Key) throws -> Int64 {
    if let value = try decodeIfPresent(Int64.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: UInt.Type, forKey key: Key) throws -> UInt {
    if let value = try decodeIfPresent(UInt.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: UInt8.Type, forKey key: Key) throws -> UInt8 {
    if let value = try decodeIfPresent(UInt8.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: UInt16.Type, forKey key: Key) throws -> UInt16 {
    if let value = try decodeIfPresent(UInt16.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: UInt32.Type, forKey key: Key) throws -> UInt32 {
    if let value = try decodeIfPresent(UInt32.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: UInt64.Type, forKey key: Key) throws -> UInt64 {
    if let value = try decodeIfPresent(UInt64.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Float.Type, forKey key: Key) throws -> Float {
    if let value = try decodeIfPresent(Float.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: Double.Type, forKey key: Key) throws -> Double {
    if let value = try decodeIfPresent(Double.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode(_ type: String.Type, forKey key: Key) throws -> String {
    if let value = try decodeIfPresent(String.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
  
  public func decode<T : Decodable>(_ type: T.Type, forKey key: Key) throws -> T {
    if let value = try decodeIfPresent(T.self, forKey: key) {
      return value
    } else if contains(key) {
      var path = codingPath
      path.append(key)
      throw DecodingError.valueNotFound(type, DecodingError.Context(codingPath: path,
        debugDescription: "Found null value when expecting non-optional type \(type) for coding key \"\(key)\""))
    } else {
      var path = codingPath
      path.append(key)
      throw DecodingError.keyNotFound(key, DecodingError.Context(codingPath: path,
        debugDescription: "Key not found when expecting non-optional type \(type) for coding key \"\(key)\""))
    }
  }
}

// Default implementation of encodeWeak(_:) in terms of encode(_:), and 
// encode(contentsOf:) in terms of encode(_:) loop.

public extension UnkeyedEncodingContainer {
  public mutating func encodeWeak<T : AnyObject & Encodable>(_ object: T?) throws {
    try encode(object)
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Bool {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int8 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int16 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int32 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Int64 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt8 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt16 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt32 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == UInt64 {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Float {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == Double {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element == String {
    for element in sequence {
      try encode(element)
    }
  }
  
  public mutating func encode<T : Sequence>(contentsOf sequence: T) throws
    where T.Iterator.Element : Encodable {
    for element in sequence {
      try encode(element)
    }
  }
}

// Default implementations for decode(_:) in terms of decodeIfPresent(_:)
public extension UnkeyedDecodingContainer {
  mutating func decode(_ type: Bool.Type) throws -> Bool {
    if let value = try decodeIfPresent(Bool.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
      	codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Int.Type) throws -> Int {
    if let value = try decodeIfPresent(Int.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Int8.Type) throws -> Int8 {
    if let value = try decodeIfPresent(Int8.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Int16.Type) throws -> Int16 {
    if let value = try decodeIfPresent(Int16.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Int32.Type) throws -> Int32 {
    if let value = try decodeIfPresent(Int32.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Int64.Type) throws -> Int64 {
    if let value = try decodeIfPresent(Int64.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: UInt.Type) throws -> UInt {
    if let value = try decodeIfPresent(UInt.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: UInt8.Type) throws -> UInt8 {
    if let value = try decodeIfPresent(UInt8.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: UInt16.Type) throws -> UInt16 {
    if let value = try decodeIfPresent(UInt16.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: UInt32.Type) throws -> UInt32 {
    if let value = try decodeIfPresent(UInt32.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: UInt64.Type) throws -> UInt64 {
    if let value = try decodeIfPresent(UInt64.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Float.Type) throws -> Float {
    if let value = try decodeIfPresent(Float.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: Double.Type) throws -> Double {
    if let value = try decodeIfPresent(Double.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode(_ type: String.Type) throws -> String {
    if let value = try decodeIfPresent(String.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
  
  mutating func decode<T : Decodable>(_ type: T.Type) throws -> T {
    if let value = try decodeIfPresent(T.self) {
      return value
    } else if !isAtEnd {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "Found null value when expecting non-optional type \(type)"))
    } else {
      throw DecodingError.valueNotFound(type, DecodingError.Context(
        codingPath: codingPath, debugDescription: "No remaining elements when expecting non-optional type \(type)"))
    }
  }
}