Add DART_CHECKVALID

runtime/include/dart_api.h

 // Copyright (c) 2011, 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_
 
 #ifdef __cplusplus
 #define DART_EXTERN_C extern "C"
 #else
@@ skipping 61 matching lines @@
 
 typedef void (*Dart_NativeFunction)(Dart_NativeArguments arguments);
 typedef Dart_NativeFunction (*Dart_NativeEntryResolver)(Dart_Handle name,
                                                         int num_of_arguments);
 typedef Dart_Handle (*Dart_LibraryTagHandler)(Dart_LibraryTag tag,
                                               Dart_Handle library,
                                               Dart_Handle url);
 
 // TODO(iposva): This is a placeholder for the eventual external Dart API.
 
-// Return value handling after a Dart API call.
-DART_EXPORT bool Dart_IsValid(const Dart_Handle& result);
+// Returns true if 'handle' is valid and false if invalid.
+DART_EXPORT bool Dart_IsValid(const Dart_Handle& handle);
 
-DART_EXPORT const char* Dart_GetError(const Dart_Handle& result);
-DART_EXPORT Dart_Handle Dart_Error(const char* value);
+// Internal routine used for reporting invalid handles.
+DART_EXPORT void _Dart_ReportInvalidHandle(const char* file,
+                                           int line,
+                                           const char* handle_string,
+                                           const char* error);
 
+// Aborts the process if 'handle' is invalid.
+#define DART_CHECK_VALID(handle)                                        \
+  if (!Dart_IsValid((handle))) {                                        \
+    _Dart_ReportInvalidHandle(__FILE__, __LINE__,                       \
+                              #handle, Dart_GetError(handle));          \
+  }
+
+// Gets the error message associated with an invalid handle.
+DART_EXPORT const char* Dart_GetError(const Dart_Handle& handle);
+
+// Produces an invalid handle with an associated error message
+DART_EXPORT Dart_Handle Dart_Error(const char* error);
 
 // Initialize the VM with commmand line flags.
 DART_EXPORT bool Dart_Initialize(int argc, char** argv,
                                  Dart_IsolateInitCallback callback);
 
 
 // Isolate handling.
 DART_EXPORT Dart_Isolate Dart_CreateIsolate(const Dart_Snapshot* snapshot,
                                             void* data);
 DART_EXPORT void Dart_ShutdownIsolate();
@@ skipping 265 matching lines @@
 // External pprof support for gathering and dumping symbolic information
 // that can be used for better profile reports for dynamically generated
 // code.
 DART_EXPORT void Dart_InitPprofSupport();
 DART_EXPORT void Dart_GetPprofSymbolInfo(void** buffer, int* buffer_size);
 
 // Check set vm flags.
 DART_EXPORT bool Dart_IsVMFlagSet(const char* flag_name);
 
 #endif  // INCLUDE_DART_API_H_