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 |