aboutsummaryrefslogtreecommitdiff
path: root/src/expr.c
diff options
context:
space:
mode:
authordrh <drh@noemail.net>2017-09-15 15:38:01 +0000
committerdrh <drh@noemail.net>2017-09-15 15:38:01 +0000
commit3df6c3b1c5fad0204902846b27c4b5ccffeda57f (patch)
tree305c7ce1f9339723f592aba5e3163268b620c751 /src/expr.c
parenta19543fe703823a434d5d0702db9e45075958be1 (diff)
downloadsqlite-3df6c3b1c5fad0204902846b27c4b5ccffeda57f.tar.gz
sqlite-3df6c3b1c5fad0204902846b27c4b5ccffeda57f.zip
Improved the header-comment documentation on sqlite3ExprCodeExprList().
No changes to code. FossilOrigin-Name: 5dc3ecb5f67968545fb35ceed61ad625e069c4e744c5c3ebaea65e2fee347a5f
Diffstat (limited to 'src/expr.c')
-rw-r--r--src/expr.c6
1 files changed, 5 insertions, 1 deletions
diff --git a/src/expr.c b/src/expr.c
index 38c799c6b..405103f21 100644
--- a/src/expr.c
+++ b/src/expr.c
@@ -4252,7 +4252,9 @@ void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
** Generate code that pushes the value of every element of the given
** expression list into a sequence of registers beginning at target.
**
-** Return the number of elements evaluated.
+** Return the number of elements evaluated. The number returned will
+** usually be pList->nExpr but might be reduced if SQLITE_ECEL_OMITREF
+** is defined.
**
** The SQLITE_ECEL_DUP flag prevents the arguments from being
** filled using OP_SCopy. OP_Copy must be used instead.
@@ -4263,6 +4265,8 @@ void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
** The SQLITE_ECEL_REF flag means that expressions in the list with
** ExprList.a[].u.x.iOrderByCol>0 have already been evaluated and stored
** in registers at srcReg, and so the value can be copied from there.
+** If SQLITE_ECEL_OMITREF is also set, then the values with u.x.iOrderByCol>0
+** are simply omitted rather than being copied from srcReg.
*/
int sqlite3ExprCodeExprList(
Parse *pParse, /* Parsing context */