diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/index.rst | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/manual/index.rst b/manual/index.rst index ba2fe1dc..fcbdea4c 100644 --- a/manual/index.rst +++ b/manual/index.rst @@ -3632,14 +3632,16 @@ For a detailed list of changes, please see the file - C API Enhancements - - Overhaul error handling for the object handle functions - C API. See comments in the "Object handling" section of - :file:`include/qpdf/qpdf-c.h` for details. - In particular, exceptions thrown by the underlying C++ code - when calling object accessors are caught and converted into - errors. The errors can be trapped by registering an error - handler with ``qpdf_register_oh_error_handler`` or will be - written to stderr if no handler is registered. + - Overhaul error handling for the object handle functions C API. + Some rare error conditions that would previously have caused a + crash are now trapped and reported, and the functions that + generate them return fallback values. See comments in the + ``ERROR HANDLING`` section of :file:`include/qpdf/qpdf-c.h` for + details. In particular, exceptions thrown by the underlying C++ + code when calling object accessors are caught and converted into + errors. The errors can be checked by call ``qpdf_has_error``. + Use ``qpdf_silence_errors`` to prevent the error from being + written to stderr. - Add ``qpdf_get_last_string_length`` to the C API to get the length of the last string that was returned. This is needed to |