Support [handles] in validation test input format and add handle-related tests.

mojo/public/cpp/bindings/tests/validation_test_input_parser.h

 // Copyright 2014 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_TESTS_VALIDATION_TEST_INPUT_PARSER_H_
 #define MOJO_PUBLIC_CPP_BINDINGS_TESTS_VALIDATION_TEST_INPUT_PARSER_H_
 
 #include <stdint.h>
 
 #include <string>
@@ skipping 42 matching lines @@
 // anchr item with the same ID. A dist8 and anchr pair can be used to easily
 // represent an encoded pointer. A dist4 and anchr pair can be used to easily
 // calculate struct/array size.
 // Value Format: The value is an ID: [0-9a-zA-Z_]+
 //
 // Type: anchr
 // Description: Mark an anchor location. It doesn’t translate into any actual
 // data.
 // Value Format: The value is an ID of the same format as that of dist4/8.
 //
+// Type: handles
+// Description: The number of handles that are associated with the message. This
+// special item is not part of the message data. If specified, it should be the
+// first item.
+// Value Format: The same format as u1/2/4/8.
+//
 // EXAMPLE:
 //
 // Suppose you have the following Mojo types defined:
 //   struct Bar {
 //     int32 a;
 //     bool b;
 //     bool c;
 //   };
 //   struct Foo {
 //     Bar x;
@@ skipping 19 matching lines @@
 //
 //   [anchr]bar_ptr
 //   [dist4]bar   // num_bytes
 //   [u4]3        // num_fields
 //   [s4]-1       // a
 //   [b]00000010  // b and c
 //   0 0 0        // padding
 //   [anchr]bar
 
 // Parses validation test input.
-// On success, |parsed_input| stores the parsing result and |error_message| is
-// cleared; on failure, |error_message| is set to a message describing the error
-// and |parsed_input| is cleared.
+// On success, |data| and |num_handles| store the parsing result,
+// |error_message| is cleared; on failure, |error_message| is set to a message
+// describing the error, |data| is cleared and |num_handles| set to 0.
 // Note: For now, this method only works on little-endian platforms.
 bool ParseValidationTestInput(const std::string& input,
-                              std::vector<uint8_t>* parsed_input,
+                              std::vector<uint8_t>* data,
+                              size_t* num_handles,
                               std::string* error_message);
 
 }  // namespace test
 }  // namespace mojo
 
 #endif  // MOJO_PUBLIC_CPP_BINDINGS_TESTS_VALIDATION_TEST_INPUT_PARSER_H_