Added API Dart_PostCMessage for posting a Dart_CMessage structure

runtime/include/dart_api.h

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef INCLUDE_DART_API_H_
 #define INCLUDE_DART_API_H_
 
 /** \mainpage Dart Embedding API Reference
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 481 matching lines @@
 DART_EXPORT Dart_Port Dart_GetMainPortId();
 
 /**
  * Does the current isolate have live ReceivePorts?
  *
  * A ReceivePort is live when it has not been closed.
  */
 DART_EXPORT bool Dart_HasLivePorts();
 
 /**
- * Posts a message for some isolate. The message is built from a raw
- * array.
- *
- * \param port The destination port.
- * \param length The length of the data array.
- * \param data A data array to be sent in the message.
- *
- * \return True if the message was posted.
- */
-DART_EXPORT bool Dart_PostIntArray(Dart_Port port_id,
-                                   intptr_t length,
-                                   intptr_t* data);
-// TODO(turnidge): Should this be intptr_t or some fixed length type?
-// TODO(turnidge): Reverse length/data for consistency.
-
-/**
  * Posts a message for some isolate. The message is a serialized
  * object.
  *
  * Requires there to be a current isolate.
  *
  * \param port The destination port.
  * \param object An object from the current isolate.
  *
  * \return True if the message was posted.
  */
@@ skipping 903 matching lines @@
     double as_double;
     char* as_string;
     struct {
       int length;
       Dart_CObject** values;
     } as_array;
   } value;
 };
 
 /**
- * A Dart_CMessage is used for receiving and sending messages from
- * native code not running in an isolate. A message contains an object
- * graph represented as Dart_CObject structures rooted as the provided
- * root.
+ * Posts a message on some port. The message will contain the
+ * Dart_CObject object graph rooted in the provided Dart_CObject.
  *
- * For information on the lifetime of this data, when provided in
- * callbacks, see the documentation for the individual callbacks.
+ * While the message is being sent the state of the graph of
+ * Dart_CObject structures rooted in message should not be accessed,

[siva, 2012/02/06 18:55:12]

rooted in 'message' or rooted in 'root', we could change the parameter name to
'message' if you want.

+ * as the message generation will make temporaly modification to the

[siva, 2012/02/06 18:55:12]

'temporary modifications to the'

+ * data. When the message has been sent the graph will be fully
+ * restored.
+ *
+ * \param port_id The destination port.
+ * \param message The message to send.
+ *
+ * \return True if the message was posted.
  */
-struct Dart_CMessage {
-  Dart_CObject* root;
-};
-
+DART_EXPORT bool Dart_PostCObject(Dart_Port port_id, Dart_CObject* root);
 
 #endif  // INCLUDE_DART_API_H_