| 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 INCLUDE_DART_API_H_ | 7 #ifndef INCLUDE_DART_API_H_ |
| 8 #define INCLUDE_DART_API_H_ | 8 #define INCLUDE_DART_API_H_ |
| 9 | 9 |
| 10 /** \mainpage Dart Embedding API Reference | 10 /** \mainpage Dart Embedding API Reference |
| (...skipping 284 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 295 * | 295 * |
| 296 * \param exception An instance of a Dart object to be thrown. | 296 * \param exception An instance of a Dart object to be thrown. |
| 297 */ | 297 */ |
| 298 DART_EXPORT Dart_Handle Dart_NewUnhandledExceptionError(Dart_Handle exception); | 298 DART_EXPORT Dart_Handle Dart_NewUnhandledExceptionError(Dart_Handle exception); |
| 299 | 299 |
| 300 /** | 300 /** |
| 301 * Propagates an error. | 301 * Propagates an error. |
| 302 * | 302 * |
| 303 * If the provided handle is an unhandled exception error, this | 303 * If the provided handle is an unhandled exception error, this |
| 304 * function will cause the unhandled exception to be rethrown. This | 304 * function will cause the unhandled exception to be rethrown. This |
| 305 * will proceeed in the standard way, walking up Dart frames until an | 305 * will proceed in the standard way, walking up Dart frames until an |
| 306 * appropriate 'catch' block is found, executing 'finally' blocks, | 306 * appropriate 'catch' block is found, executing 'finally' blocks, |
| 307 * etc. | 307 * etc. |
| 308 * | 308 * |
| 309 * If the error is not an unhandled exception error, we will unwind | 309 * If the error is not an unhandled exception error, we will unwind |
| 310 * the stack to the next C frame. Intervening Dart frames will be | 310 * the stack to the next C frame. Intervening Dart frames will be |
| 311 * discarded; specifically, 'finally' blocks will not execute. This | 311 * discarded; specifically, 'finally' blocks will not execute. This |
| 312 * is the standard way that compilation errors (and the like) are | 312 * is the standard way that compilation errors (and the like) are |
| 313 * handled by the Dart runtime. | 313 * handled by the Dart runtime. |
| 314 * | 314 * |
| 315 * In either case, when an error is propagated any current scopes | 315 * In either case, when an error is propagated any current scopes |
| 316 * created by Dart_EnterScope will be exited. | 316 * created by Dart_EnterScope will be exited. |
| 317 * | 317 * |
| 318 * See the additonal discussion under "Propagating Errors" at the | 318 * See the additional discussion under "Propagating Errors" at the |
| 319 * beginning of this file. | 319 * beginning of this file. |
| 320 * | 320 * |
| 321 * \param An error handle (See Dart_IsError) | 321 * \param An error handle (See Dart_IsError) |
| 322 * | 322 * |
| 323 * \return On success, this function does not return. On failure, an | 323 * \return On success, this function does not return. On failure, an |
| 324 * error handle is returned. | 324 * error handle is returned. |
| 325 */ | 325 */ |
| 326 DART_EXPORT Dart_Handle Dart_PropagateError(Dart_Handle handle); | 326 DART_EXPORT Dart_Handle Dart_PropagateError(Dart_Handle handle); |
| 327 /* TODO(turnidge): Should this really return an error handle? */ | 327 /* TODO(turnidge): Should this really return an error handle? */ |
| 328 /* Consider just terminating. */ | 328 /* Consider just terminating. */ |
| (...skipping 1612 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1941 */ | 1941 */ |
| 1942 | 1942 |
| 1943 /* | 1943 /* |
| 1944 * TODO(turnidge): Remove these functions from the api and replace all | 1944 * TODO(turnidge): Remove these functions from the api and replace all |
| 1945 * uses with Dart_NewUnhandledExceptionError. */ | 1945 * uses with Dart_NewUnhandledExceptionError. */ |
| 1946 | 1946 |
| 1947 /** | 1947 /** |
| 1948 * Throws an exception. | 1948 * Throws an exception. |
| 1949 * | 1949 * |
| 1950 * This function causes a Dart language exception to be thrown. This | 1950 * This function causes a Dart language exception to be thrown. This |
| 1951 * will proceeed in the standard way, walking up Dart frames until an | 1951 * will proceed in the standard way, walking up Dart frames until an |
| 1952 * appropriate 'catch' block is found, executing 'finally' blocks, | 1952 * appropriate 'catch' block is found, executing 'finally' blocks, |
| 1953 * etc. | 1953 * etc. |
| 1954 * | 1954 * |
| 1955 * If successful, this function does not return. Note that this means | 1955 * If successful, this function does not return. Note that this means |
| 1956 * that the destructors of any stack-allocated C++ objects will not be | 1956 * that the destructors of any stack-allocated C++ objects will not be |
| 1957 * called. If there are no Dart frames on the stack, an error occurs. | 1957 * called. If there are no Dart frames on the stack, an error occurs. |
| 1958 * | 1958 * |
| 1959 * \return An error handle if the exception was not thrown. | 1959 * \return An error handle if the exception was not thrown. |
| 1960 * Otherwise the function does not return. | 1960 * Otherwise the function does not return. |
| 1961 */ | 1961 */ |
| (...skipping 425 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2387 * | 2387 * |
| 2388 * \param object An object. | 2388 * \param object An object. |
| 2389 * \param peer A value to store in the peer field. | 2389 * \param peer A value to store in the peer field. |
| 2390 * | 2390 * |
| 2391 * \return Returns an error if 'object' is a subtype of Null, num, or | 2391 * \return Returns an error if 'object' is a subtype of Null, num, or |
| 2392 * bool. | 2392 * bool. |
| 2393 */ | 2393 */ |
| 2394 DART_EXPORT Dart_Handle Dart_SetPeer(Dart_Handle object, void* peer); | 2394 DART_EXPORT Dart_Handle Dart_SetPeer(Dart_Handle object, void* peer); |
| 2395 | 2395 |
| 2396 #endif /* INCLUDE_DART_API_H_ */ /* NOLINT */ | 2396 #endif /* INCLUDE_DART_API_H_ */ /* NOLINT */ |
| OLD | NEW |