Support for embedded Dart scripts

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 2591 matching lines @@
 
 /**
  * Loads the root script for the current isolate.
  *
  * TODO(turnidge): Document.
  */
 DART_EXPORT Dart_Handle Dart_LoadScript(Dart_Handle url,
                                         Dart_Handle source);
 
 /**
+ * Loads the root script for the current isolate. The script can be
+ * embedded in another file, for example in an html file.
+ *
+ * TODO(turnidge): Document.
+ *
+ * \line_offset is the number of text lines before the
+ *   first line of the Dart script in the containing file.
+ *
+ * \col_offset is the number of characters before the first character
+ *   in the first line of the Dart script.
+ */
+DART_EXPORT Dart_Handle Dart_LoadEmbeddedScript(
+                                        Dart_Handle url,
+                                        Dart_Handle source,
+                                        intptr_t line_offset,
+                                        intptr_t col_offset);
+
+/**
  * Loads the root script for current isolate from a snapshot.
  *
  * \param buffer A buffer which contains a snapshot of the script.
  *
  * \return If no error occurs, the Library object corresponding to the root
  *   script is returned. Otherwise an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_LoadScriptFromSnapshot(const uint8_t* buffer);
 
 /**
@@ skipping 167 matching lines @@
  *
  * \param object An object.
  * \param peer A value to store in the peer field.
  *
  * \return Returns an error if 'object' is a subtype of Null, num, or
  *   bool.
  */
 DART_EXPORT Dart_Handle Dart_SetPeer(Dart_Handle object, void* peer);
 
 #endif  // INCLUDE_DART_API_H_