HackBase/python-cx_Oracle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify documentation on variables.

Browse Source
This commit is contained in:
Anthony Tuininga 2018-05-16 14:09:33 -06:00
parent 4ec7685f95
commit 62f11ac570
1 changed files with 19 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/src/variable.rst
View File

@ -25,7 +25,18 @@ Variable Objects
.. method:: Variable.getvalue([pos=0]) .. method:: Variable.getvalue([pos=0])
Return the value at the given position in the variable. Return the value at the given position in the variable. For variables
created using the method :func:`Cursor.arrayvar()` the value returned will
be a list of each of the values in the PL/SQL index-by table. For variables
bound to DML returning statements where the attribute
`cx_Oracle.__future__.dml_ret_array_val` is set to the value True, the
value returned will also be a list corresponding to the returned data for
the given execution of the statement (as identified by the pos parameter).
For variables bound to DML returning statements and the attribute
`cx_Oracle.__future__.dml_ret_array_val` is not set or is set to the value
False, the value returned depends on the number of rows returned by the
first execution of the statement. If pos is a valid index into that array
then the value at that index will be returned; otherwise, None is returned.
.. attribute:: Variable.inconverter .. attribute:: Variable.inconverter
@ -73,6 +84,11 @@ Variable Objects
.. attribute:: Variable.values .. attribute:: Variable.values
This read-only attribute returns a copy of the value of all actual This read-only attribute returns a copy of the value of all actual
positions in the variable as a list. The number of items in the list will positions in the variable as a list. For variables bound to DML returning
correspond to the value of the :attr:`~Variable.actualElements` attribute. statements where the attribute `cx_Oracle.__future__.dml_ret_array_val` is
not set or set to the value False, this will be the returned data for the
first execution of the statement. In all other cases the elements returned
will be the equivalent of calling :meth:`~Variable.getvalue()` for each
valid position and the length will correspond to the value of the
:attr:`~Variable.actualElements` attribute.