]> granicus.if.org Git - postgresql/commit
Rationalize the APIs of array element/slice access functions.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 16 Feb 2015 17:23:58 +0000 (12:23 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 16 Feb 2015 17:23:58 +0000 (12:23 -0500)
commite983c4d1aa42d613542cf222e222b034918374b1
treeafa2bbb56ffd7bad49b99e3bcb4d9feeb412f6ce
parentcef30974dec2c052170b80eff1fe4b9bb285e903
Rationalize the APIs of array element/slice access functions.

The four functions array_ref, array_set, array_get_slice, array_set_slice
have traditionally declared their array inputs and results as being of type
"ArrayType *".  This is a lie, and has been since Berkeley days, because
they actually also support "fixed-length array" types such as "name" and
"point"; not to mention that the inputs could be toasted.  These values
should be declared Datum instead to avoid confusion.  The current coding
already risks possible misoptimization by compilers, and it'll get worse
when "expanded" array representations become a valid alternative.

However, there's a fair amount of code using array_ref and array_set with
arrays that *are* known to be ArrayType structures, and there might be more
such places in third-party code.  Rather than cluttering those call sites
with PointerGetDatum/DatumGetArrayTypeP cruft, what I did was to rename the
existing functions to array_get_element/array_set_element, fix their
signatures, then reincarnate array_ref/array_set as backwards compatibility
wrappers.

array_get_slice/array_set_slice have no such constituency in the core code,
and probably not in third-party code either, so I just changed their APIs.
src/backend/executor/execQual.c
src/backend/rewrite/rewriteHandler.c
src/backend/utils/adt/arrayfuncs.c
src/include/utils/array.h
src/pl/plpgsql/src/pl_exec.c