Add Dart_ListGetRange

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
@@ skipping 1823 matching lines @@
  * \param list A List.
  * \param index A valid index into the List.
  *
  * \return The Object in the List at the specified index if no error
  *   occurs. Otherwise returns an error handle.
  */
 DART_EXPORT Dart_Handle Dart_ListGetAt(Dart_Handle list,
                                        intptr_t index);
 
 /**
+* Gets a range of Objects from a List.
+*
+* If any of the requested index values are out of bounds, an error occurs.
+*
+* May generate an unhandled exception error.
+*
+* \param list A List.
+* \param offset The offset of the first item to get.
+* \param length The number of items to get.
+* \param result A pointer to fill with the objects.
+*
+* \return Success if no error occurs during the operation.
+*/
+DART_EXPORT Dart_Handle Dart_ListGetRange(Dart_Handle list,
+                                          intptr_t offset,
+                                          intptr_t length,
+                                          Dart_Handle* result);
+
+/**
  * Sets the Object at some index of a List.
  *
  * If the index is out of bounds, an error occurs.
  *
  * May generate an unhandled exception error.
  *
  * \param array A List.
  * \param index A valid index into the List.
  * \param value The Object to put in the List.
  *
@@ skipping 979 matching lines @@
 
 /**
  * Returns the port that script load requests should be sent on.
  *
  * \return Returns the port for load requests or ILLEGAL_PORT if the service
  * isolate failed to startup or does not support load requests.
  */
 DART_EXPORT Dart_Port Dart_ServiceWaitForLoadPort();
 
 #endif  /* INCLUDE_DART_API_H_ */  /* NOLINT */