Add Dart_GetStickyError

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 1160 matching lines @@
  * Called when the embedder has paused the current isolate on exit and when
  * the embedder has resumed the isolate.
  *
  * \param paused Is the isolate paused on exit?
  */
 DART_EXPORT void Dart_SetPausedOnExit(bool paused);
 
 
 /**
  * Called when the embedder has caught a top level unhandled exception error
- * in the current isolate. Also marks the isolate as paused at exit.
+ * in the current isolate.
  *
- * NOTE: It is illegal to call this twice on the same isolate.
+ * NOTE: It is illegal to call this twice on the same isolate without first
+ * clearing the sticky error to null.
  *
  * \param error The unhandled exception error.
  */
 DART_EXPORT void Dart_SetStickyError(Dart_Handle error);
 
 
 /**
  * Does the current isolate have a sticky error?
  */
 DART_EXPORT bool Dart_HasStickyError();
 
 
 /**
+ * Gets the sticky error for the current isolate.
+ *
+ * \return A handle to the sticky error object or null.
+ */
+DART_EXPORT Dart_Handle Dart_GetStickyError();

[siva, 2016/09/22 19:43:54]

Do we need both Dart_HasStickyError and Dart_GetStickyError?
Can't we infer from a non null return on Dart_GetStickyError that the isolate
has a sticky error?

+
+
+/**
  * Handles the next pending message for the current isolate.
  *
  * May generate an unhandled exception error.
  *
  * \return A valid handle if no error occurs during the operation.
  */
 DART_EXPORT Dart_Handle Dart_HandleMessage();
 
 /**
  * Handles all pending messages for the current isolate.
@@ skipping 1972 matching lines @@
 /**
  *  Returns whether the VM was initialized with a precompiled snapshot. Only
  *  valid after Dart_Initialize.
  *  DEPRECATED. This is currently used to disable Platform.executable and
  *  Platform.resolvedExecutable under precompilation to prevent process
  *  spawning tests from becoming fork-bombs.
  */
 DART_EXPORT bool Dart_IsRunningPrecompiledCode();
 
 #endif  /* INCLUDE_DART_API_H_ */  /* NOLINT */