From 1d803550e7059729cf2734fc6190993e8b8404bf Mon Sep 17 00:00:00 2001 From: Even Rouault Date: Tue, 15 Dec 2020 01:12:58 +0100 Subject: proj_trans_array(): make it transform all coordinates even when an error occurs --- docs/source/development/reference/functions.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'docs/source/development/reference/functions.rst') diff --git a/docs/source/development/reference/functions.rst b/docs/source/development/reference/functions.rst index 5b559d55..08b3e669 100644 --- a/docs/source/development/reference/functions.rst +++ b/docs/source/development/reference/functions.rst @@ -368,13 +368,22 @@ Coordinate transformation Batch transform an array of :c:type:`PJ_COORD`. + Performs transformation on all points, even if errors occur on some points + (new to 8.0. Previous versions would exit early in case of failure on a given point) + + Individual points that fail to transform will have their components set to + ``HUGE_VAL`` + :param P: Transformation object :type P: :c:type:`PJ` * :param `direction`: Transformation direction. :type `direction`: PJ_DIRECTION :param n: Number of coordinates in :c:data:`coord` :type n: `size_t` - :returns: `int` 0 if all observations are transformed without error, otherwise returns error number + :returns: `int` 0 if all observations are transformed without error, otherwise returns error number. + This error number will be a precise error number if all coordinates that fail to transform + for the same reason, or a generic error code if they fail for different + reasons. Error reporting -- cgit v1.2.3