// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef MOJO_PUBLIC_CPP_BINDINGS_MAP_TRAITS_H_
#define MOJO_PUBLIC_CPP_BINDINGS_MAP_TRAITS_H_

namespace mojo {

// This must be specialized for any type |T| to be serialized/deserialized as
// a mojom map.
//
// Usually you would like to do a partial specialization for a map template.
// Imagine you want to specialize it for CustomMap<>, you need to implement:
//
//   template <typename K, typename V>
//   struct MapTraits<CustomMap<K, V>> {
//     using Key = K;
//     using Value = V;
//
//     // These two methods are optional. Please see comments in struct_traits.h
//     static bool IsNull(const CustomMap<K, V>& input);
//     static void SetToNull(CustomMap<K, V>* output);
//
//     static size_t GetSize(const CustomMap<K, V>& input);
//
//     static CustomConstIterator GetBegin(const CustomMap<K, V>& input);
//     static CustomIterator GetBegin(CustomMap<K, V>& input);
//
//     static void AdvanceIterator(CustomConstIterator& iterator);
//     static void AdvanceIterator(CustomIterator& iterator);
//
//     static const K& GetKey(CustomIterator& iterator);
//     static const K& GetKey(CustomConstIterator& iterator);
//
//     static V& GetValue(CustomIterator& iterator);
//     static const V& GetValue(CustomConstIterator& iterator);
//
//     // Returning false results in deserialization failure and causes the
//     // message pipe receiving it to be disconnected.
//     static bool Insert(CustomMap<K, V>& input,
//                        const K& key,
//                        V&& value);
//     static bool Insert(CustomMap<K, V>& input,
//                        const K& key,
//                        const V& value);
//
//     static void SetToEmpty(CustomMap<K, V>* output);
//   };
//
template <typename T>
struct MapTraits;

}  // namespace mojo

#endif  // MOJO_PUBLIC_CPP_BINDINGS_MAP_TRAITS_H_