| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 2 * Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 3 * for details. All rights reserved. Use of this source code is governed by a | 3 * for details. All rights reserved. Use of this source code is governed by a |
| 4 * BSD-style license that can be found in the LICENSE file. | 4 * BSD-style license that can be found in the LICENSE file. |
| 5 */ | 5 */ |
| 6 | 6 |
| 7 #ifndef RUNTIME_INCLUDE_DART_API_H_ | 7 #ifndef RUNTIME_INCLUDE_DART_API_H_ |
| 8 #define RUNTIME_INCLUDE_DART_API_H_ | 8 #define RUNTIME_INCLUDE_DART_API_H_ |
| 9 | 9 |
| 10 /** \mainpage Dart Embedding API Reference | 10 /** \mainpage Dart Embedding API Reference |
| (...skipping 114 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 125 * | 125 * |
| 126 * An unhandled exception error provides access to an exception and | 126 * An unhandled exception error provides access to an exception and |
| 127 * stacktrace via the functions Dart_ErrorGetException and | 127 * stacktrace via the functions Dart_ErrorGetException and |
| 128 * Dart_ErrorGetStackTrace. | 128 * Dart_ErrorGetStackTrace. |
| 129 * | 129 * |
| 130 * - Compilation error handles are produced when, during the execution | 130 * - Compilation error handles are produced when, during the execution |
| 131 * of Dart code, a compile-time error occurs. As above, this can | 131 * of Dart code, a compile-time error occurs. As above, this can |
| 132 * occur in any function which triggers the execution of Dart code. | 132 * occur in any function which triggers the execution of Dart code. |
| 133 * | 133 * |
| 134 * - Fatal error handles are produced when the system wants to shut | 134 * - Fatal error handles are produced when the system wants to shut |
| 135 * down the current isolate. Sometimes a fatal error may be a | 135 * down the current isolate. |
| 136 * restart request (see Dart_IsRestartRequest). If the embedder does | |
| 137 * not support restarting the VM, then this should be treated as a | |
| 138 * normal fatal error. | |
| 139 * | 136 * |
| 140 * --- Propagating errors --- | 137 * --- Propagating errors --- |
| 141 * | 138 * |
| 142 * When an error handle is returned from the top level invocation of | 139 * When an error handle is returned from the top level invocation of |
| 143 * Dart code in a program, the embedder must handle the error as they | 140 * Dart code in a program, the embedder must handle the error as they |
| 144 * see fit. Often, the embedder will print the error message produced | 141 * see fit. Often, the embedder will print the error message produced |
| 145 * by Dart_Error and exit the program. | 142 * by Dart_Error and exit the program. |
| 146 * | 143 * |
| 147 * When an error is returned while in the body of a native function, | 144 * When an error is returned while in the body of a native function, |
| 148 * it can be propagated up the call stack by calling | 145 * it can be propagated up the call stack by calling |
| (...skipping 156 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 305 * Is this a fatal error handle? | 302 * Is this a fatal error handle? |
| 306 * | 303 * |
| 307 * Fatal error handles are produced when the system wants to shut down | 304 * Fatal error handles are produced when the system wants to shut down |
| 308 * the current isolate. | 305 * the current isolate. |
| 309 * | 306 * |
| 310 * Requires there to be a current isolate. | 307 * Requires there to be a current isolate. |
| 311 */ | 308 */ |
| 312 DART_EXPORT bool Dart_IsFatalError(Dart_Handle handle); | 309 DART_EXPORT bool Dart_IsFatalError(Dart_Handle handle); |
| 313 | 310 |
| 314 /** | 311 /** |
| 315 * Is this error a request to restart the VM? | |
| 316 * | |
| 317 * If an embedder chooses to support restarting the VM from tools | |
| 318 * (such as a debugger), then this function is used to distinguish | |
| 319 * restart requests from other fatal errors. | |
| 320 * | |
| 321 * Requires there to be a current isolate. | |
| 322 */ | |
| 323 DART_EXPORT bool Dart_IsVMRestartRequest(Dart_Handle handle); | |
| 324 | |
| 325 /** | |
| 326 * Gets the error message from an error handle. | 312 * Gets the error message from an error handle. |
| 327 * | 313 * |
| 328 * Requires there to be a current isolate. | 314 * Requires there to be a current isolate. |
| 329 * | 315 * |
| 330 * \return A C string containing an error message if the handle is | 316 * \return A C string containing an error message if the handle is |
| 331 * error. An empty C string ("") if the handle is valid. This C | 317 * error. An empty C string ("") if the handle is valid. This C |
| 332 * String is scope allocated and is only valid until the next call | 318 * String is scope allocated and is only valid until the next call |
| 333 * to Dart_ExitScope. | 319 * to Dart_ExitScope. |
| 334 */ | 320 */ |
| 335 DART_EXPORT const char* Dart_GetError(Dart_Handle handle); | 321 DART_EXPORT const char* Dart_GetError(Dart_Handle handle); |
| (...skipping 3007 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 3343 */ | 3329 */ |
| 3344 DART_EXPORT bool Dart_IsPrecompiledRuntime(); | 3330 DART_EXPORT bool Dart_IsPrecompiledRuntime(); |
| 3345 | 3331 |
| 3346 | 3332 |
| 3347 /** | 3333 /** |
| 3348 * Print a native stack trace. Used for crash handling. | 3334 * Print a native stack trace. Used for crash handling. |
| 3349 */ | 3335 */ |
| 3350 DART_EXPORT void Dart_DumpNativeStackTrace(void* context); | 3336 DART_EXPORT void Dart_DumpNativeStackTrace(void* context); |
| 3351 | 3337 |
| 3352 #endif /* INCLUDE_DART_API_H_ */ /* NOLINT */ | 3338 #endif /* INCLUDE_DART_API_H_ */ /* NOLINT */ |
| OLD | NEW |