Usage Notes | OPRIOR | Teradata Vantage - Usage Notes - Teradata Vantage - Analytics Database

SQL Data Types and Literals

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-11-06
dita:mapPath
uds1628112204571.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
exs1472253032394
lifecycle
latest
Product Category
Teradata Vantageā„¢

OPRIOR takes an array expression as an argument and returns the subscript of the element prior to the element specified by integer_value or array_bound, if that element is currently populated. If you specify an element subscript that is less than or equal to the value of OFIRST for the array, a NULL is returned. Also, if integer_value or array_bound is NULL, an error is returned.

If array_expr is a one-dimensional ARRAY type, OPRIOR returns an unsigned INTEGER value. If array_expr is a multidimensional ARRAY type, OPRIOR returns a new instance of the predefined ARRAY type ArrayVec, containing the subscript information. If the array is empty (all elements of the array are in an uninitialized state), then OPRIOR returns NULL.

If array_expr is NULL, an error is returned.

The OPRIOR method with one INTEGER argument is compatible with the Oracle PRIOR method for one-dimensional ARRAY types.