C bindings: Implement _DeepCopy() & some unittests.

mojo/public/c/bindings/struct.h

 // 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_C_BINDINGS_STRUCT_H_
 #define MOJO_PUBLIC_C_BINDINGS_STRUCT_H_
 
 #include <stddef.h>
 #include <stdint.h>
 
@@ skipping 70 matching lines @@
 // |inout_context|: An initialized context that contains the expected location
 //                  of the next pointer and next offset. This is used to
 //                  validate that no two pointers or handles are shared.
 MojomValidationResult MojomStruct_Validate(
     const struct MojomTypeDescriptorStruct* in_type_desc,
     const struct MojomStructHeader* in_struct,
     uint32_t in_struct_size,
     uint32_t in_num_handles,
     struct MojomValidationContext* inout_context);
 
+// Creates a new copy of |in_struct| using |buffer| to allocate space.
+// Recursively creates new copies of any references from |in_struct|, and
+// updates the references to point to the new copies. All handles are moved
+// from |in_struct| to the new copy (the copies in |in_struct| are assigned an
+// invalid handle value). This operation is useful if you want to linearize
+// |in_struct| using the buffer backed by |buffer|. The new copy of the struct
+// is returned, and can then be encoded.
+// |buffer|: A mojom buffer used to allocate space for the new struct.

[viettrungluu, 2016/08/02 20:15:06]

(Same questions about the amount of space required and failures apply here and
elsewhere too.)

+// |in_type_desc|: Describes the pointer and handle fields of the mojom struct.
+// |in_struct|: The unencoded mojom struct to be copied.
+struct MojomStructHeader* MojomStruct_DeepCopy(
+    struct MojomBuffer* buffer,
+    const struct MojomTypeDescriptorStruct* in_type_desc,
+    struct MojomStructHeader* in_struct);
+
 MOJO_END_EXTERN_C
 
 #endif  // MOJO_PUBLIC_C_BINDINGS_STRUCT_H_