duktape/src-input/duk_jmpbuf.h

/*
 *  Wrapper for jmp_buf.
 *
 *  This is used because jmp_buf is an array type for backward compatibility.
 *  Wrapping jmp_buf in a struct makes pointer references, sizeof, etc,
 *  behave more intuitively.
 *
 *  http://en.wikipedia.org/wiki/Setjmp.h#Member_types
 */

#ifndef DUK_JMPBUF_H_INCLUDED
#define DUK_JMPBUF_H_INCLUDED

#if defined(DUK_USE_CPP_EXCEPTIONS)
struct duk_jmpbuf {
	duk_small_int_t dummy;  /* unused */
};
#else
struct duk_jmpbuf {
	DUK_JMPBUF_TYPE jb;
};
#endif

#endif  /* DUK_JMPBUF_H_INCLUDED */
various small headers 12 years ago			`/*`
			`* Wrapper for jmp_buf.`
			`*`
			`* This is used because jmp_buf is an array type for backward compatibility.`
			`* Wrapping jmp_buf in a struct makes pointer references, sizeof, etc,`
			`* behave more intuitively.`
			`*`
			`* http://en.wikipedia.org/wiki/Setjmp.h#Member_types`
			`*/`

fix include guard names, don't use leading underscores as they are reserved 12 years ago			`#ifndef DUK_JMPBUF_H_INCLUDED`
			`#define DUK_JMPBUF_H_INCLUDED`
various small headers 12 years ago
C++ exception and setjmp() reworks 9 years ago			`#if defined(DUK_USE_CPP_EXCEPTIONS)`
various small headers 12 years ago			`struct duk_jmpbuf {`
C++ exception and setjmp() reworks 9 years ago			`duk_small_int_t dummy; /* unused */`
			`};`
Add alt setjmp/longjmp providers, OSX auto _setjmp 10 years ago			`#else`
C++ exception and setjmp() reworks 9 years ago			`struct duk_jmpbuf {`
			`DUK_JMPBUF_TYPE jb;`
various small headers 12 years ago			`};`
Add support for C++ exception long ctrl transfers * Define duk_internal_exception, a plain exception class, wihch is used as the value thrown for Duktape internal long control transfers. The value intentionally does not inherit from std::exception so that it'd be as unlikely as possible that user code would catch the internal exception type; only a "catch (...)" would catch it. * Replace DUK_SETJMP() if clauses with "try", and SETJMP() error handling blocks with "catch (duk_internal_exception &exc)" blocks. * Also add clauses for "catch (std::exception &exc)" and "catch (...)" to catch C++ exceptions thrown by user code which are propagated to Duktape try-catch blocks. Such exceptions are converted to API errors. For now it's not supported for user code to propagate a C++ exception "through" Duktape, as that would require some semantics changes to (native) protected calls. Catching and converting such exceptions to API errors makes the user code error apparent and easier to fix. 9 years ago			`#endif`
various small headers 12 years ago
fix include guard names, don't use leading underscores as they are reserved 12 years ago			`#endif /* DUK_JMPBUF_H_INCLUDED */`