xref: /third_party/sqlite/src/sqlite3.c

7401   int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
7437 ** pass information into and receive the reply from the [xBestIndex]
7439 ** inputs to xBestIndex and are read-only.  xBestIndex inserts its
7474 ** The [xBestIndex] method must fill aConstraintUsage[] with information
7505 ** The xBestIndex method may optionally populate the idxFlags field with a
7507 ** SQLITE_INDEX_SCAN_UNIQUE. If the xBestIndex method sets this flag, SQLite
7510 ** Additionally, if xBestIndex sets the SQLITE_INDEX_SCAN_UNIQUE flag, then
7540      int iTermOffset;          /* Used internally - xBestIndex should ignore */
9974 ** This function may only be called from within a call to the [xBestIndex]
9980 ** that is the first parameter to the xBestIndex() method. The second argument
9982 ** sqlite3_index_info structure passed to xBestIndex.
10009 ** This API may only be used from within an [xBestIndex|xBestIndex method]
10011 ** interface from outside of xBestIndex() is undefined and probably harmful.
10026 ** the xBestIndex method to set the "orderByConsumed" flag, regardless of
10079 ** CAPI3REF: Identify and handle IN constraints in xBestIndex
10082 ** [xBestIndex|xBestIndex() method] of a [virtual table] implementation.
10088 ** communicated to the xBestIndex method as a
10089 ** [SQLITE_INDEX_CONSTRAINT_EQ] constraint.)^  If xBestIndex wants to use
10121 ** within the same xBestIndex method call.  ^For any given P,N pair,
10123 ** within the same xBestIndex call.  ^If the interface returns true
10164 ** [xBestIndex|xBestIndex method].  ^(If the X parameter is not
10201 ** CAPI3REF: Constraint values in xBestIndex()
10204 ** This API may only be used from within the [xBestIndex|xBestIndex method]
10206 ** from outside of an xBestIndex method are undefined and probably harmful.
10209 ** the [xBestIndex] method of a [virtual table] implementation, with P being
10210 ** a copy of the [sqlite3_index_info] object pointer passed into xBestIndex and
10233 ** and remains valid for the duration of the xBestIndex method call.
10234 ** ^When xBestIndex returns, the sqlite3_value object returned by
98424 ** P4 is either NULL or a string that was generated by the xBestIndex
102935   /* xBestIndex  */ bytecodevtabBestIndex,
137100   pragmaVtabBestIndex,         /* xBestIndex - Determine search strategy */
155024 ** to the xBestIndex method of virtual tables.  Forms of interest include:
156154   ** This information is used by the xBestIndex methods of
156293 **      to the virtual table xBestIndex method.
156294 **   5. The ORDER BY clause, if any, will be made available to the xBestIndex
156298 ** exist only so that they may be passed to the xBestIndex method of the
156574 ** visible to the xBestIndex function, at least not directly.  The
157912 ** and possibly modified by xBestIndex methods.
157930 ** must represent a virtual table. This function invokes the xBestIndex()
157936 ** xBestIndex is not considered an error.  SQLITE_CONSTRAINT indicates that
157950   rc = pVtab->pModule->xBestIndex(pVtab, p);
160205 ** xBestIndex method and adds the returned plan to pBuilder.
160226   sqlite3_index_info *pIdxInfo,   /* Populated object for xBestIndex */
160273   /* Invoke the virtual table xBestIndex() method */
160277       /* If the xBestIndex method returns SQLITE_CONSTRAINT, that means
160303         sqlite3ErrorMsg(pParse,"%s.xBestIndex malfunction",pSrc->pTab->zName);
160364       sqlite3ErrorMsg(pParse,"%s.xBestIndex malfunction",pSrc->pTab->zName);
160380   /* Set the WHERE_ONEROW flag if the xBestIndex() method indicated
160400 ** Return the collating sequence for a constraint passed into xBestIndex.
160402 ** pIdxInfo must be an sqlite3_index_info structure passed into xBestIndex.
160449 ** This interface is callable from within the xBestIndex callback only.
160455   sqlite3_index_info *pIdxInfo,   /* Copy of first argument to xBestIndex */
160497 ** xBestIndex to potentiall use all schemas.  If the statement being
160540 ** mPrereq may be specified as "usable" in all calls to xBestIndex.
160543 ** mUnusable should always be configured as "not-usable" for xBestIndex.
160555   sqlite3_index_info *p;       /* Object to pass to xBestIndex() */
160582   /* First call xBestIndex() with all constraints usable. */
160595   /* If the call to xBestIndex() with all terms enabled produced a plan
160598   ** any further calls to xBestIndex() since they will all return the same
160599   ** result (if the xBestIndex() implementation is sane). */
160607     ** xBestIndex again, this time with IN(...) terms disabled. */
160620     /* Call xBestIndex once for each distinct value of (prereqRight & ~mPrereq)
160645     /* If the calls to xBestIndex() in the above loop did not find a plan
160655     /* If the calls to xBestIndex() have so far failed to find a plan
179654 ** the xBestIndex() method contains the Fts3Cursor.eSearch value described
181245 ** Implementation of the xBestIndex method for FTS3 tables. There
183628   /* xBestIndex    */ fts3BestIndexMethod,
185907 ** xBestIndex - Analyze a WHERE and ORDER BY clause.
186288      fts3auxBestIndexMethod,      /* xBestIndex    */
189658 ** xBestIndex - Analyze a WHERE and ORDER BY clause.
189854      fts3tokBestIndexMethod,      /* xBestIndex    */
200400 /* The xBestIndex method assumes that the JSON and ROOT columns are
200402 ** sure to update the xBestIndex method. */
200833   jsonEachBestIndex,         /* xBestIndex */
200861   jsonEachBestIndex,         /* xBestIndex */
201078 /* The xBestIndex method of this virtual table requires an estimate of
202898 ** Rtree virtual table module xBestIndex method. There are three
204430   rtreeBestIndex,             /* xBestIndex - Determine search strategy */
206811 ** Rtree virtual table module xBestIndex method. There are three
207065 ** for use in xBestIndex.
207092   geopolyBestIndex,           /* xBestIndex - Determine search strategy */
215058     statBestIndex,                /* xBestIndex */
215486     dbpageBestIndex,              /* xBestIndex */
237033 ** xBestIndex() to xFilter().
237315 ** Implementation of the xBestIndex method for FTS5 tables. Within the
238146   ** actually use them. This is ok, as the xBestIndex() method leaves the
239647     /* xBestIndex    */ fts5BestIndexMethod,
243555 ** Bits for the mask used as the idxNum value by xBestIndex/xFilter.
243717 ** Implementation of the xBestIndex method.
244230     /* xBestIndex    */ fts5VocabBestIndexMethod,
244549   stmtBestIndex,             /* xBestIndex */

Indexes created Thu Nov 07 10:32:03 CST 2024