blob: db73943f0215ecb1dfb9f50a5d8d8df2fb565387 [file] [log] [blame]
drh38b41492015-06-08 15:08:15 +00001/*
2** 2015-06-08
3**
4** The author disclaims copyright to this source code. In place of
5** a legal notice, here is a blessing:
6**
7** May you do good and not evil.
8** May you find forgiveness for yourself and forgive others.
9** May you share freely, never taking more than you give.
10**
11*************************************************************************
12**
13** This file contains C code to implement the TreeView debugging routines.
14** These routines print a parse tree to standard output for debugging and
15** analysis.
16**
17** The interfaces in this file is only available when compiling
18** with SQLITE_DEBUG.
19*/
20#include "sqliteInt.h"
21#ifdef SQLITE_DEBUG
22
23/*
24** Add a new subitem to the tree. The moreToFollow flag indicates that this
25** is not the last item in the tree.
26*/
drh2a7dcbf2022-04-06 15:41:53 +000027static void sqlite3TreeViewPush(TreeView **pp, u8 moreToFollow){
28 TreeView *p = *pp;
drh38b41492015-06-08 15:08:15 +000029 if( p==0 ){
drh2a7dcbf2022-04-06 15:41:53 +000030 *pp = p = sqlite3_malloc64( sizeof(*p) );
31 if( p==0 ) return;
drh38b41492015-06-08 15:08:15 +000032 memset(p, 0, sizeof(*p));
33 }else{
34 p->iLevel++;
35 }
36 assert( moreToFollow==0 || moreToFollow==1 );
drhe684ac62022-03-08 13:59:46 +000037 if( p->iLevel<(int)sizeof(p->bLine) ) p->bLine[p->iLevel] = moreToFollow;
drh38b41492015-06-08 15:08:15 +000038}
39
40/*
41** Finished with one layer of the tree
42*/
drh2a7dcbf2022-04-06 15:41:53 +000043static void sqlite3TreeViewPop(TreeView **pp){
44 TreeView *p = *pp;
drh38b41492015-06-08 15:08:15 +000045 if( p==0 ) return;
46 p->iLevel--;
drh2a7dcbf2022-04-06 15:41:53 +000047 if( p->iLevel<0 ){
48 sqlite3_free(p);
49 *pp = 0;
50 }
drh38b41492015-06-08 15:08:15 +000051}
52
53/*
54** Generate a single line of output for the tree, with a prefix that contains
55** all the appropriate tree lines
56*/
drh2a7dcbf2022-04-06 15:41:53 +000057void sqlite3TreeViewLine(TreeView *p, const char *zFormat, ...){
drh38b41492015-06-08 15:08:15 +000058 va_list ap;
59 int i;
60 StrAccum acc;
61 char zBuf[500];
62 sqlite3StrAccumInit(&acc, 0, zBuf, sizeof(zBuf), 0);
63 if( p ){
drhe684ac62022-03-08 13:59:46 +000064 for(i=0; i<p->iLevel && i<(int)sizeof(p->bLine)-1; i++){
drh0cdbe1a2018-05-09 13:46:26 +000065 sqlite3_str_append(&acc, p->bLine[i] ? "| " : " ", 4);
drh38b41492015-06-08 15:08:15 +000066 }
drh0cdbe1a2018-05-09 13:46:26 +000067 sqlite3_str_append(&acc, p->bLine[i] ? "|-- " : "'-- ", 4);
drh38b41492015-06-08 15:08:15 +000068 }
drhfbe07532018-04-23 20:04:38 +000069 if( zFormat!=0 ){
70 va_start(ap, zFormat);
drh0cdbe1a2018-05-09 13:46:26 +000071 sqlite3_str_vappendf(&acc, zFormat, ap);
drhfbe07532018-04-23 20:04:38 +000072 va_end(ap);
drh10c0e712019-04-25 18:15:38 +000073 assert( acc.nChar>0 || acc.accError );
drh0cdbe1a2018-05-09 13:46:26 +000074 sqlite3_str_append(&acc, "\n", 1);
drhfbe07532018-04-23 20:04:38 +000075 }
drh38b41492015-06-08 15:08:15 +000076 sqlite3StrAccumFinish(&acc);
77 fprintf(stdout,"%s", zBuf);
78 fflush(stdout);
79}
80
81/*
82** Shorthand for starting a new tree item that consists of a single label
83*/
84static void sqlite3TreeViewItem(TreeView *p, const char *zLabel,u8 moreFollows){
drh2a7dcbf2022-04-06 15:41:53 +000085 sqlite3TreeViewPush(&p, moreFollows);
drh38b41492015-06-08 15:08:15 +000086 sqlite3TreeViewLine(p, "%s", zLabel);
87}
88
drh2476a6f2015-11-07 15:19:59 +000089/*
90** Generate a human-readable description of a WITH clause.
91*/
92void sqlite3TreeViewWith(TreeView *pView, const With *pWith, u8 moreToFollow){
93 int i;
94 if( pWith==0 ) return;
95 if( pWith->nCte==0 ) return;
96 if( pWith->pOuter ){
97 sqlite3TreeViewLine(pView, "WITH (0x%p, pOuter=0x%p)",pWith,pWith->pOuter);
98 }else{
99 sqlite3TreeViewLine(pView, "WITH (0x%p)", pWith);
100 }
101 if( pWith->nCte>0 ){
drh2a7dcbf2022-04-06 15:41:53 +0000102 sqlite3TreeViewPush(&pView, moreToFollow);
drh2476a6f2015-11-07 15:19:59 +0000103 for(i=0; i<pWith->nCte; i++){
104 StrAccum x;
105 char zLine[1000];
106 const struct Cte *pCte = &pWith->a[i];
107 sqlite3StrAccumInit(&x, 0, zLine, sizeof(zLine), 0);
drh0cdbe1a2018-05-09 13:46:26 +0000108 sqlite3_str_appendf(&x, "%s", pCte->zName);
drh2476a6f2015-11-07 15:19:59 +0000109 if( pCte->pCols && pCte->pCols->nExpr>0 ){
110 char cSep = '(';
111 int j;
112 for(j=0; j<pCte->pCols->nExpr; j++){
drh41cee662019-12-12 20:22:34 +0000113 sqlite3_str_appendf(&x, "%c%s", cSep, pCte->pCols->a[j].zEName);
drh2476a6f2015-11-07 15:19:59 +0000114 cSep = ',';
115 }
drh0cdbe1a2018-05-09 13:46:26 +0000116 sqlite3_str_appendf(&x, ")");
drh2476a6f2015-11-07 15:19:59 +0000117 }
drh67f70be2022-04-22 16:15:48 +0000118 if( pCte->eM10d!=M10d_Any ){
119 sqlite3_str_appendf(&x, " %sMATERIALIZED",
120 pCte->eM10d==M10d_No ? "NOT " : "");
121 }
drha79e2a22021-02-21 23:44:14 +0000122 if( pCte->pUse ){
123 sqlite3_str_appendf(&x, " (pUse=0x%p, nUse=%d)", pCte->pUse,
124 pCte->pUse->nUse);
125 }
drh2476a6f2015-11-07 15:19:59 +0000126 sqlite3StrAccumFinish(&x);
127 sqlite3TreeViewItem(pView, zLine, i<pWith->nCte-1);
128 sqlite3TreeViewSelect(pView, pCte->pSelect, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000129 sqlite3TreeViewPop(&pView);
drh2476a6f2015-11-07 15:19:59 +0000130 }
drh2a7dcbf2022-04-06 15:41:53 +0000131 sqlite3TreeViewPop(&pView);
drh2476a6f2015-11-07 15:19:59 +0000132 }
133}
134
drh145d0a32018-11-08 22:53:06 +0000135/*
136** Generate a human-readable description of a SrcList object.
137*/
138void sqlite3TreeViewSrcList(TreeView *pView, const SrcList *pSrc){
139 int i;
drhb60d1fb2022-04-13 18:32:04 +0000140 if( pSrc==0 ) return;
drh145d0a32018-11-08 22:53:06 +0000141 for(i=0; i<pSrc->nSrc; i++){
drh76012942021-02-21 21:04:54 +0000142 const SrcItem *pItem = &pSrc->a[i];
drh145d0a32018-11-08 22:53:06 +0000143 StrAccum x;
144 char zLine[100];
145 sqlite3StrAccumInit(&x, 0, zLine, sizeof(zLine), 0);
drhff374912021-04-12 12:58:55 +0000146 x.printfFlags |= SQLITE_PRINTF_INTERNAL;
drh6610e6a2021-03-19 19:44:56 +0000147 sqlite3_str_appendf(&x, "{%d:*} %!S", pItem->iCursor, pItem);
drh145d0a32018-11-08 22:53:06 +0000148 if( pItem->pTab ){
drhf7f6dbf2020-03-21 22:03:32 +0000149 sqlite3_str_appendf(&x, " tab=%Q nCol=%d ptr=%p used=%llx",
150 pItem->pTab->zName, pItem->pTab->nCol, pItem->pTab, pItem->colUsed);
drh145d0a32018-11-08 22:53:06 +0000151 }
drha76ac882022-04-08 19:20:12 +0000152 if( (pItem->fg.jointype & (JT_LEFT|JT_RIGHT))==(JT_LEFT|JT_RIGHT) ){
153 sqlite3_str_appendf(&x, " FULL-OUTER-JOIN");
154 }else if( pItem->fg.jointype & JT_LEFT ){
drh145d0a32018-11-08 22:53:06 +0000155 sqlite3_str_appendf(&x, " LEFT-JOIN");
drha76ac882022-04-08 19:20:12 +0000156 }else if( pItem->fg.jointype & JT_RIGHT ){
157 sqlite3_str_appendf(&x, " RIGHT-JOIN");
drh9b9f2352021-06-23 11:39:00 +0000158 }else if( pItem->fg.jointype & JT_CROSS ){
159 sqlite3_str_appendf(&x, " CROSS-JOIN");
drh145d0a32018-11-08 22:53:06 +0000160 }
drh8a28ce72022-04-11 00:54:30 +0000161 if( pItem->fg.jointype & JT_LTORJ ){
162 sqlite3_str_appendf(&x, " LTORJ");
163 }
drhb7e51992020-01-08 14:39:57 +0000164 if( pItem->fg.fromDDL ){
165 sqlite3_str_appendf(&x, " DDL");
166 }
drha79e2a22021-02-21 23:44:14 +0000167 if( pItem->fg.isCte ){
168 sqlite3_str_appendf(&x, " CteUse=0x%p", pItem->u2.pCteUse);
169 }
drh145d0a32018-11-08 22:53:06 +0000170 sqlite3StrAccumFinish(&x);
171 sqlite3TreeViewItem(pView, zLine, i<pSrc->nSrc-1);
172 if( pItem->pSelect ){
drh825a6bf2022-04-21 14:08:29 +0000173 assert( pItem->fg.isNestedFrom == IsNestedFrom(pItem->pSelect) );
drh145d0a32018-11-08 22:53:06 +0000174 sqlite3TreeViewSelect(pView, pItem->pSelect, 0);
175 }
176 if( pItem->fg.isTabFunc ){
177 sqlite3TreeViewExprList(pView, pItem->u1.pFuncArg, 0, "func-args:");
178 }
drh2a7dcbf2022-04-06 15:41:53 +0000179 sqlite3TreeViewPop(&pView);
drh145d0a32018-11-08 22:53:06 +0000180 }
181}
drh38b41492015-06-08 15:08:15 +0000182
183/*
drh2e5c5052016-08-27 20:21:51 +0000184** Generate a human-readable description of a Select object.
drh38b41492015-06-08 15:08:15 +0000185*/
186void sqlite3TreeViewSelect(TreeView *pView, const Select *p, u8 moreToFollow){
187 int n = 0;
drh1c4505d2015-08-26 11:34:31 +0000188 int cnt = 0;
drh510b7ff2017-03-13 17:37:13 +0000189 if( p==0 ){
190 sqlite3TreeViewLine(pView, "nil-SELECT");
191 return;
192 }
drh2a7dcbf2022-04-06 15:41:53 +0000193 sqlite3TreeViewPush(&pView, moreToFollow);
drh2476a6f2015-11-07 15:19:59 +0000194 if( p->pWith ){
195 sqlite3TreeViewWith(pView, p->pWith, 1);
196 cnt = 1;
drh2a7dcbf2022-04-06 15:41:53 +0000197 sqlite3TreeViewPush(&pView, 1);
drh2476a6f2015-11-07 15:19:59 +0000198 }
drh1c4505d2015-08-26 11:34:31 +0000199 do{
drh55b4c822019-08-03 16:17:46 +0000200 if( p->selFlags & SF_WhereBegin ){
201 sqlite3TreeViewLine(pView, "sqlite3WhereBegin()");
202 }else{
203 sqlite3TreeViewLine(pView,
204 "SELECT%s%s (%u/%p) selFlags=0x%x nSelectRow=%d",
205 ((p->selFlags & SF_Distinct) ? " DISTINCT" : ""),
206 ((p->selFlags & SF_Aggregate) ? " agg_flag" : ""),
207 p->selId, p, p->selFlags,
208 (int)p->nSelectRow
209 );
210 }
drh2a7dcbf2022-04-06 15:41:53 +0000211 if( cnt++ ) sqlite3TreeViewPop(&pView);
drh1c4505d2015-08-26 11:34:31 +0000212 if( p->pPrior ){
213 n = 1000;
214 }else{
215 n = 0;
216 if( p->pSrc && p->pSrc->nSrc ) n++;
217 if( p->pWhere ) n++;
218 if( p->pGroupBy ) n++;
219 if( p->pHaving ) n++;
220 if( p->pOrderBy ) n++;
221 if( p->pLimit ) n++;
drha1fd4b52018-07-10 06:32:53 +0000222#ifndef SQLITE_OMIT_WINDOWFUNC
223 if( p->pWin ) n++;
224 if( p->pWinDefn ) n++;
225#endif
drh1c4505d2015-08-26 11:34:31 +0000226 }
drh55b4c822019-08-03 16:17:46 +0000227 if( p->pEList ){
228 sqlite3TreeViewExprList(pView, p->pEList, n>0, "result-set");
229 }
230 n--;
drha1fd4b52018-07-10 06:32:53 +0000231#ifndef SQLITE_OMIT_WINDOWFUNC
232 if( p->pWin ){
233 Window *pX;
drh2a7dcbf2022-04-06 15:41:53 +0000234 sqlite3TreeViewPush(&pView, (n--)>0);
drha1fd4b52018-07-10 06:32:53 +0000235 sqlite3TreeViewLine(pView, "window-functions");
236 for(pX=p->pWin; pX; pX=pX->pNextWin){
237 sqlite3TreeViewWinFunc(pView, pX, pX->pNextWin!=0);
238 }
drh2a7dcbf2022-04-06 15:41:53 +0000239 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000240 }
241#endif
drh1c4505d2015-08-26 11:34:31 +0000242 if( p->pSrc && p->pSrc->nSrc ){
drh2a7dcbf2022-04-06 15:41:53 +0000243 sqlite3TreeViewPush(&pView, (n--)>0);
drh1c4505d2015-08-26 11:34:31 +0000244 sqlite3TreeViewLine(pView, "FROM");
drh145d0a32018-11-08 22:53:06 +0000245 sqlite3TreeViewSrcList(pView, p->pSrc);
drh2a7dcbf2022-04-06 15:41:53 +0000246 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000247 }
drh1c4505d2015-08-26 11:34:31 +0000248 if( p->pWhere ){
249 sqlite3TreeViewItem(pView, "WHERE", (n--)>0);
250 sqlite3TreeViewExpr(pView, p->pWhere, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000251 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000252 }
drh1c4505d2015-08-26 11:34:31 +0000253 if( p->pGroupBy ){
254 sqlite3TreeViewExprList(pView, p->pGroupBy, (n--)>0, "GROUPBY");
255 }
256 if( p->pHaving ){
257 sqlite3TreeViewItem(pView, "HAVING", (n--)>0);
258 sqlite3TreeViewExpr(pView, p->pHaving, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000259 sqlite3TreeViewPop(&pView);
drh1c4505d2015-08-26 11:34:31 +0000260 }
drha1fd4b52018-07-10 06:32:53 +0000261#ifndef SQLITE_OMIT_WINDOWFUNC
262 if( p->pWinDefn ){
263 Window *pX;
264 sqlite3TreeViewItem(pView, "WINDOW", (n--)>0);
265 for(pX=p->pWinDefn; pX; pX=pX->pNextWin){
266 sqlite3TreeViewWindow(pView, pX, pX->pNextWin!=0);
267 }
drh2a7dcbf2022-04-06 15:41:53 +0000268 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000269 }
270#endif
drh1c4505d2015-08-26 11:34:31 +0000271 if( p->pOrderBy ){
272 sqlite3TreeViewExprList(pView, p->pOrderBy, (n--)>0, "ORDERBY");
273 }
274 if( p->pLimit ){
275 sqlite3TreeViewItem(pView, "LIMIT", (n--)>0);
drh8c0833f2017-11-14 23:48:23 +0000276 sqlite3TreeViewExpr(pView, p->pLimit->pLeft, p->pLimit->pRight!=0);
277 if( p->pLimit->pRight ){
278 sqlite3TreeViewItem(pView, "OFFSET", (n--)>0);
279 sqlite3TreeViewExpr(pView, p->pLimit->pRight, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000280 sqlite3TreeViewPop(&pView);
drh8c0833f2017-11-14 23:48:23 +0000281 }
drh2a7dcbf2022-04-06 15:41:53 +0000282 sqlite3TreeViewPop(&pView);
drh1c4505d2015-08-26 11:34:31 +0000283 }
284 if( p->pPrior ){
285 const char *zOp = "UNION";
286 switch( p->op ){
287 case TK_ALL: zOp = "UNION ALL"; break;
288 case TK_INTERSECT: zOp = "INTERSECT"; break;
289 case TK_EXCEPT: zOp = "EXCEPT"; break;
290 }
291 sqlite3TreeViewItem(pView, zOp, 1);
292 }
293 p = p->pPrior;
294 }while( p!=0 );
drh2a7dcbf2022-04-06 15:41:53 +0000295 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000296}
297
drha1fd4b52018-07-10 06:32:53 +0000298#ifndef SQLITE_OMIT_WINDOWFUNC
299/*
300** Generate a description of starting or stopping bounds
301*/
302void sqlite3TreeViewBound(
303 TreeView *pView, /* View context */
304 u8 eBound, /* UNBOUNDED, CURRENT, PRECEDING, FOLLOWING */
305 Expr *pExpr, /* Value for PRECEDING or FOLLOWING */
306 u8 moreToFollow /* True if more to follow */
307){
308 switch( eBound ){
309 case TK_UNBOUNDED: {
310 sqlite3TreeViewItem(pView, "UNBOUNDED", moreToFollow);
drh2a7dcbf2022-04-06 15:41:53 +0000311 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000312 break;
313 }
314 case TK_CURRENT: {
315 sqlite3TreeViewItem(pView, "CURRENT", moreToFollow);
drh2a7dcbf2022-04-06 15:41:53 +0000316 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000317 break;
318 }
319 case TK_PRECEDING: {
320 sqlite3TreeViewItem(pView, "PRECEDING", moreToFollow);
321 sqlite3TreeViewExpr(pView, pExpr, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000322 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000323 break;
324 }
325 case TK_FOLLOWING: {
326 sqlite3TreeViewItem(pView, "FOLLOWING", moreToFollow);
327 sqlite3TreeViewExpr(pView, pExpr, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000328 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000329 break;
330 }
331 }
332}
333#endif /* SQLITE_OMIT_WINDOWFUNC */
334
335#ifndef SQLITE_OMIT_WINDOWFUNC
336/*
337** Generate a human-readable explanation for a Window object
338*/
339void sqlite3TreeViewWindow(TreeView *pView, const Window *pWin, u8 more){
drhfc15f4c2019-03-28 13:03:41 +0000340 int nElement = 0;
drh0dc0e9c2019-03-28 13:35:28 +0000341 if( pWin->pFilter ){
342 sqlite3TreeViewItem(pView, "FILTER", 1);
343 sqlite3TreeViewExpr(pView, pWin->pFilter, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000344 sqlite3TreeViewPop(&pView);
drh0dc0e9c2019-03-28 13:35:28 +0000345 }
drh2a7dcbf2022-04-06 15:41:53 +0000346 sqlite3TreeViewPush(&pView, more);
drha1fd4b52018-07-10 06:32:53 +0000347 if( pWin->zName ){
drh6f1644c2019-03-28 13:53:12 +0000348 sqlite3TreeViewLine(pView, "OVER %s (%p)", pWin->zName, pWin);
drha1fd4b52018-07-10 06:32:53 +0000349 }else{
drh6f1644c2019-03-28 13:53:12 +0000350 sqlite3TreeViewLine(pView, "OVER (%p)", pWin);
drha1fd4b52018-07-10 06:32:53 +0000351 }
drhfc15f4c2019-03-28 13:03:41 +0000352 if( pWin->zBase ) nElement++;
353 if( pWin->pOrderBy ) nElement++;
354 if( pWin->eFrmType ) nElement++;
355 if( pWin->eExclude ) nElement++;
drhfc15f4c2019-03-28 13:03:41 +0000356 if( pWin->zBase ){
drh2a7dcbf2022-04-06 15:41:53 +0000357 sqlite3TreeViewPush(&pView, (--nElement)>0);
drhfc15f4c2019-03-28 13:03:41 +0000358 sqlite3TreeViewLine(pView, "window: %s", pWin->zBase);
drh2a7dcbf2022-04-06 15:41:53 +0000359 sqlite3TreeViewPop(&pView);
drhfc15f4c2019-03-28 13:03:41 +0000360 }
drha1fd4b52018-07-10 06:32:53 +0000361 if( pWin->pPartition ){
drhfc15f4c2019-03-28 13:03:41 +0000362 sqlite3TreeViewExprList(pView, pWin->pPartition, nElement>0,"PARTITION-BY");
drha1fd4b52018-07-10 06:32:53 +0000363 }
364 if( pWin->pOrderBy ){
drhfc15f4c2019-03-28 13:03:41 +0000365 sqlite3TreeViewExprList(pView, pWin->pOrderBy, (--nElement)>0, "ORDER-BY");
drha1fd4b52018-07-10 06:32:53 +0000366 }
drhfc15f4c2019-03-28 13:03:41 +0000367 if( pWin->eFrmType ){
drh0dc0e9c2019-03-28 13:35:28 +0000368 char zBuf[30];
drhfc15f4c2019-03-28 13:03:41 +0000369 const char *zFrmType = "ROWS";
370 if( pWin->eFrmType==TK_RANGE ) zFrmType = "RANGE";
371 if( pWin->eFrmType==TK_GROUPS ) zFrmType = "GROUPS";
drh0dc0e9c2019-03-28 13:35:28 +0000372 sqlite3_snprintf(sizeof(zBuf),zBuf,"%s%s",zFrmType,
373 pWin->bImplicitFrame ? " (implied)" : "");
374 sqlite3TreeViewItem(pView, zBuf, (--nElement)>0);
drha1fd4b52018-07-10 06:32:53 +0000375 sqlite3TreeViewBound(pView, pWin->eStart, pWin->pStart, 1);
376 sqlite3TreeViewBound(pView, pWin->eEnd, pWin->pEnd, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000377 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000378 }
drhfc15f4c2019-03-28 13:03:41 +0000379 if( pWin->eExclude ){
380 char zBuf[30];
381 const char *zExclude;
382 switch( pWin->eExclude ){
383 case TK_NO: zExclude = "NO OTHERS"; break;
384 case TK_CURRENT: zExclude = "CURRENT ROW"; break;
385 case TK_GROUP: zExclude = "GROUP"; break;
386 case TK_TIES: zExclude = "TIES"; break;
387 default:
388 sqlite3_snprintf(sizeof(zBuf),zBuf,"invalid(%d)", pWin->eExclude);
389 zExclude = zBuf;
390 break;
391 }
drh2a7dcbf2022-04-06 15:41:53 +0000392 sqlite3TreeViewPush(&pView, 0);
drhfc15f4c2019-03-28 13:03:41 +0000393 sqlite3TreeViewLine(pView, "EXCLUDE %s", zExclude);
drh2a7dcbf2022-04-06 15:41:53 +0000394 sqlite3TreeViewPop(&pView);
drhfc15f4c2019-03-28 13:03:41 +0000395 }
drh2a7dcbf2022-04-06 15:41:53 +0000396 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000397}
398#endif /* SQLITE_OMIT_WINDOWFUNC */
399
400#ifndef SQLITE_OMIT_WINDOWFUNC
401/*
402** Generate a human-readable explanation for a Window Function object
403*/
404void sqlite3TreeViewWinFunc(TreeView *pView, const Window *pWin, u8 more){
drh2a7dcbf2022-04-06 15:41:53 +0000405 sqlite3TreeViewPush(&pView, more);
drha1fd4b52018-07-10 06:32:53 +0000406 sqlite3TreeViewLine(pView, "WINFUNC %s(%d)",
drh105dcaa2022-03-10 16:01:14 +0000407 pWin->pWFunc->zName, pWin->pWFunc->nArg);
drha1fd4b52018-07-10 06:32:53 +0000408 sqlite3TreeViewWindow(pView, pWin, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000409 sqlite3TreeViewPop(&pView);
drha1fd4b52018-07-10 06:32:53 +0000410}
411#endif /* SQLITE_OMIT_WINDOWFUNC */
412
drh38b41492015-06-08 15:08:15 +0000413/*
414** Generate a human-readable explanation of an expression tree.
415*/
416void sqlite3TreeViewExpr(TreeView *pView, const Expr *pExpr, u8 moreToFollow){
417 const char *zBinOp = 0; /* Binary operator */
418 const char *zUniOp = 0; /* Unary operator */
drhe7375bf2020-03-10 19:24:38 +0000419 char zFlgs[200];
drh2a7dcbf2022-04-06 15:41:53 +0000420 sqlite3TreeViewPush(&pView, moreToFollow);
drh38b41492015-06-08 15:08:15 +0000421 if( pExpr==0 ){
422 sqlite3TreeViewLine(pView, "nil");
drh2a7dcbf2022-04-06 15:41:53 +0000423 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000424 return;
425 }
drhe7375bf2020-03-10 19:24:38 +0000426 if( pExpr->flags || pExpr->affExpr || pExpr->vvaFlags ){
drhb7e51992020-01-08 14:39:57 +0000427 StrAccum x;
428 sqlite3StrAccumInit(&x, 0, zFlgs, sizeof(zFlgs), 0);
429 sqlite3_str_appendf(&x, " fg.af=%x.%c",
430 pExpr->flags, pExpr->affExpr ? pExpr->affExpr : 'n');
drhd97cda42017-04-14 14:02:14 +0000431 if( ExprHasProperty(pExpr, EP_FromJoin) ){
drhd1985262022-04-11 11:25:28 +0000432 sqlite3_str_appendf(&x, " iJoin=%d", pExpr->w.iJoin);
drhd97cda42017-04-14 14:02:14 +0000433 }
drhb7e51992020-01-08 14:39:57 +0000434 if( ExprHasProperty(pExpr, EP_FromDDL) ){
435 sqlite3_str_appendf(&x, " DDL");
436 }
drhe7375bf2020-03-10 19:24:38 +0000437 if( ExprHasVVAProperty(pExpr, EP_Immutable) ){
438 sqlite3_str_appendf(&x, " IMMUTABLE");
439 }
drhb7e51992020-01-08 14:39:57 +0000440 sqlite3StrAccumFinish(&x);
drhb3d903e2015-06-18 14:09:13 +0000441 }else{
442 zFlgs[0] = 0;
443 }
drh38b41492015-06-08 15:08:15 +0000444 switch( pExpr->op ){
445 case TK_AGG_COLUMN: {
drhb3d903e2015-06-18 14:09:13 +0000446 sqlite3TreeViewLine(pView, "AGG{%d:%d}%s",
447 pExpr->iTable, pExpr->iColumn, zFlgs);
drh38b41492015-06-08 15:08:15 +0000448 break;
449 }
450 case TK_COLUMN: {
451 if( pExpr->iTable<0 ){
452 /* This only happens when coding check constraints */
drhd4933532019-10-31 12:30:38 +0000453 char zOp2[16];
454 if( pExpr->op2 ){
455 sqlite3_snprintf(sizeof(zOp2),zOp2," op2=0x%02x",pExpr->op2);
456 }else{
457 zOp2[0] = 0;
458 }
459 sqlite3TreeViewLine(pView, "COLUMN(%d)%s%s",
460 pExpr->iColumn, zFlgs, zOp2);
drh38b41492015-06-08 15:08:15 +0000461 }else{
drh477572b2021-10-07 20:46:29 +0000462 assert( ExprUseYTab(pExpr) );
drha513e592019-12-20 20:08:56 +0000463 sqlite3TreeViewLine(pView, "{%d:%d} pTab=%p%s",
464 pExpr->iTable, pExpr->iColumn,
465 pExpr->y.pTab, zFlgs);
drh38b41492015-06-08 15:08:15 +0000466 }
drhefad2e22018-07-27 16:57:11 +0000467 if( ExprHasProperty(pExpr, EP_FixedCol) ){
468 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
469 }
drh38b41492015-06-08 15:08:15 +0000470 break;
471 }
472 case TK_INTEGER: {
473 if( pExpr->flags & EP_IntValue ){
474 sqlite3TreeViewLine(pView, "%d", pExpr->u.iValue);
475 }else{
476 sqlite3TreeViewLine(pView, "%s", pExpr->u.zToken);
477 }
478 break;
479 }
480#ifndef SQLITE_OMIT_FLOATING_POINT
481 case TK_FLOAT: {
drhf9751072021-10-07 13:40:29 +0000482 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000483 sqlite3TreeViewLine(pView,"%s", pExpr->u.zToken);
484 break;
485 }
486#endif
487 case TK_STRING: {
drhf9751072021-10-07 13:40:29 +0000488 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000489 sqlite3TreeViewLine(pView,"%Q", pExpr->u.zToken);
490 break;
491 }
492 case TK_NULL: {
493 sqlite3TreeViewLine(pView,"NULL");
494 break;
495 }
drh34328212018-02-26 19:03:25 +0000496 case TK_TRUEFALSE: {
drh348e0022021-07-22 16:07:01 +0000497 sqlite3TreeViewLine(pView,"%s%s",
498 sqlite3ExprTruthValue(pExpr) ? "TRUE" : "FALSE", zFlgs);
drh34328212018-02-26 19:03:25 +0000499 break;
500 }
drh38b41492015-06-08 15:08:15 +0000501#ifndef SQLITE_OMIT_BLOB_LITERAL
502 case TK_BLOB: {
drhf9751072021-10-07 13:40:29 +0000503 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000504 sqlite3TreeViewLine(pView,"%s", pExpr->u.zToken);
505 break;
506 }
507#endif
508 case TK_VARIABLE: {
drhf9751072021-10-07 13:40:29 +0000509 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000510 sqlite3TreeViewLine(pView,"VARIABLE(%s,%d)",
511 pExpr->u.zToken, pExpr->iColumn);
512 break;
513 }
514 case TK_REGISTER: {
515 sqlite3TreeViewLine(pView,"REGISTER(%d)", pExpr->iTable);
516 break;
517 }
drh38b41492015-06-08 15:08:15 +0000518 case TK_ID: {
drhf9751072021-10-07 13:40:29 +0000519 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000520 sqlite3TreeViewLine(pView,"ID \"%w\"", pExpr->u.zToken);
521 break;
522 }
523#ifndef SQLITE_OMIT_CAST
524 case TK_CAST: {
525 /* Expressions of the form: CAST(pLeft AS token) */
drhf9751072021-10-07 13:40:29 +0000526 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000527 sqlite3TreeViewLine(pView,"CAST %Q", pExpr->u.zToken);
528 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
529 break;
530 }
531#endif /* SQLITE_OMIT_CAST */
532 case TK_LT: zBinOp = "LT"; break;
533 case TK_LE: zBinOp = "LE"; break;
534 case TK_GT: zBinOp = "GT"; break;
535 case TK_GE: zBinOp = "GE"; break;
536 case TK_NE: zBinOp = "NE"; break;
537 case TK_EQ: zBinOp = "EQ"; break;
538 case TK_IS: zBinOp = "IS"; break;
539 case TK_ISNOT: zBinOp = "ISNOT"; break;
540 case TK_AND: zBinOp = "AND"; break;
541 case TK_OR: zBinOp = "OR"; break;
542 case TK_PLUS: zBinOp = "ADD"; break;
543 case TK_STAR: zBinOp = "MUL"; break;
544 case TK_MINUS: zBinOp = "SUB"; break;
545 case TK_REM: zBinOp = "REM"; break;
546 case TK_BITAND: zBinOp = "BITAND"; break;
547 case TK_BITOR: zBinOp = "BITOR"; break;
548 case TK_SLASH: zBinOp = "DIV"; break;
549 case TK_LSHIFT: zBinOp = "LSHIFT"; break;
550 case TK_RSHIFT: zBinOp = "RSHIFT"; break;
551 case TK_CONCAT: zBinOp = "CONCAT"; break;
552 case TK_DOT: zBinOp = "DOT"; break;
drhe7375bf2020-03-10 19:24:38 +0000553 case TK_LIMIT: zBinOp = "LIMIT"; break;
drh38b41492015-06-08 15:08:15 +0000554
555 case TK_UMINUS: zUniOp = "UMINUS"; break;
556 case TK_UPLUS: zUniOp = "UPLUS"; break;
557 case TK_BITNOT: zUniOp = "BITNOT"; break;
558 case TK_NOT: zUniOp = "NOT"; break;
559 case TK_ISNULL: zUniOp = "ISNULL"; break;
560 case TK_NOTNULL: zUniOp = "NOTNULL"; break;
561
drh34328212018-02-26 19:03:25 +0000562 case TK_TRUTH: {
drh43c4ac82018-02-26 21:26:27 +0000563 int x;
564 const char *azOp[] = {
565 "IS-FALSE", "IS-TRUE", "IS-NOT-FALSE", "IS-NOT-TRUE"
566 };
drh34328212018-02-26 19:03:25 +0000567 assert( pExpr->op2==TK_IS || pExpr->op2==TK_ISNOT );
568 assert( pExpr->pRight );
dan6ece3532019-06-12 13:49:32 +0000569 assert( sqlite3ExprSkipCollate(pExpr->pRight)->op==TK_TRUEFALSE );
drh96acafb2018-02-27 14:49:25 +0000570 x = (pExpr->op2==TK_ISNOT)*2 + sqlite3ExprTruthValue(pExpr->pRight);
drh43c4ac82018-02-26 21:26:27 +0000571 zUniOp = azOp[x];
drh34328212018-02-26 19:03:25 +0000572 break;
573 }
574
drh94fa9c42016-02-27 21:16:04 +0000575 case TK_SPAN: {
drhf9751072021-10-07 13:40:29 +0000576 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh94fa9c42016-02-27 21:16:04 +0000577 sqlite3TreeViewLine(pView, "SPAN %Q", pExpr->u.zToken);
578 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
579 break;
580 }
581
drh38b41492015-06-08 15:08:15 +0000582 case TK_COLLATE: {
drhc204d812019-09-10 17:51:27 +0000583 /* COLLATE operators without the EP_Collate flag are intended to
drh018dbb12019-09-28 16:14:55 +0000584 ** emulate collation associated with a table column. These show
585 ** up in the treeview output as "SOFT-COLLATE". Explicit COLLATE
586 ** operators that appear in the original SQL always have the
587 ** EP_Collate bit set and appear in treeview output as just "COLLATE" */
drhf9751072021-10-07 13:40:29 +0000588 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drhc204d812019-09-10 17:51:27 +0000589 sqlite3TreeViewLine(pView, "%sCOLLATE %Q%s",
590 !ExprHasProperty(pExpr, EP_Collate) ? "SOFT-" : "",
591 pExpr->u.zToken, zFlgs);
drh38b41492015-06-08 15:08:15 +0000592 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
593 break;
594 }
595
596 case TK_AGG_FUNCTION:
597 case TK_FUNCTION: {
598 ExprList *pFarg; /* List of function arguments */
drha1fd4b52018-07-10 06:32:53 +0000599 Window *pWin;
drh38b41492015-06-08 15:08:15 +0000600 if( ExprHasProperty(pExpr, EP_TokenOnly) ){
601 pFarg = 0;
drha1fd4b52018-07-10 06:32:53 +0000602 pWin = 0;
drh38b41492015-06-08 15:08:15 +0000603 }else{
drha4eeccd2021-10-07 17:43:30 +0000604 assert( ExprUseXList(pExpr) );
drh38b41492015-06-08 15:08:15 +0000605 pFarg = pExpr->x.pList;
drha1fd4b52018-07-10 06:32:53 +0000606#ifndef SQLITE_OMIT_WINDOWFUNC
drh014fff22020-01-08 22:22:36 +0000607 pWin = ExprHasProperty(pExpr, EP_WinFunc) ? pExpr->y.pWin : 0;
drha1fd4b52018-07-10 06:32:53 +0000608#else
609 pWin = 0;
610#endif
drh38b41492015-06-08 15:08:15 +0000611 }
drhf9751072021-10-07 13:40:29 +0000612 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000613 if( pExpr->op==TK_AGG_FUNCTION ){
drhe26d4282020-06-09 11:59:15 +0000614 sqlite3TreeViewLine(pView, "AGG_FUNCTION%d %Q%s agg=%d[%d]/%p",
drhca74fbf2020-05-24 02:05:04 +0000615 pExpr->op2, pExpr->u.zToken, zFlgs,
drhe26d4282020-06-09 11:59:15 +0000616 pExpr->pAggInfo ? pExpr->pAggInfo->selId : 0,
drhca74fbf2020-05-24 02:05:04 +0000617 pExpr->iAgg, pExpr->pAggInfo);
drhd4933532019-10-31 12:30:38 +0000618 }else if( pExpr->op2!=0 ){
619 const char *zOp2;
620 char zBuf[8];
621 sqlite3_snprintf(sizeof(zBuf),zBuf,"0x%02x",pExpr->op2);
622 zOp2 = zBuf;
623 if( pExpr->op2==NC_IsCheck ) zOp2 = "NC_IsCheck";
624 if( pExpr->op2==NC_IdxExpr ) zOp2 = "NC_IdxExpr";
625 if( pExpr->op2==NC_PartIdx ) zOp2 = "NC_PartIdx";
626 if( pExpr->op2==NC_GenCol ) zOp2 = "NC_GenCol";
627 sqlite3TreeViewLine(pView, "FUNCTION %Q%s op2=%s",
628 pExpr->u.zToken, zFlgs, zOp2);
drh38b41492015-06-08 15:08:15 +0000629 }else{
drh42d2fce2019-08-15 20:04:09 +0000630 sqlite3TreeViewLine(pView, "FUNCTION %Q%s", pExpr->u.zToken, zFlgs);
drh38b41492015-06-08 15:08:15 +0000631 }
632 if( pFarg ){
drha1fd4b52018-07-10 06:32:53 +0000633 sqlite3TreeViewExprList(pView, pFarg, pWin!=0, 0);
drh38b41492015-06-08 15:08:15 +0000634 }
mistachkin14897852018-07-23 18:53:49 +0000635#ifndef SQLITE_OMIT_WINDOWFUNC
drha1fd4b52018-07-10 06:32:53 +0000636 if( pWin ){
637 sqlite3TreeViewWindow(pView, pWin, 0);
638 }
639#endif
drh38b41492015-06-08 15:08:15 +0000640 break;
641 }
642#ifndef SQLITE_OMIT_SUBQUERY
643 case TK_EXISTS: {
drha4eeccd2021-10-07 17:43:30 +0000644 assert( ExprUseXSelect(pExpr) );
drh9f6e14c2017-07-10 13:24:58 +0000645 sqlite3TreeViewLine(pView, "EXISTS-expr flags=0x%x", pExpr->flags);
drh38b41492015-06-08 15:08:15 +0000646 sqlite3TreeViewSelect(pView, pExpr->x.pSelect, 0);
647 break;
648 }
649 case TK_SELECT: {
drha4eeccd2021-10-07 17:43:30 +0000650 assert( ExprUseXSelect(pExpr) );
drha0365c42020-06-05 04:01:50 +0000651 sqlite3TreeViewLine(pView, "subquery-expr flags=0x%x", pExpr->flags);
drh38b41492015-06-08 15:08:15 +0000652 sqlite3TreeViewSelect(pView, pExpr->x.pSelect, 0);
653 break;
654 }
655 case TK_IN: {
drh9f6e14c2017-07-10 13:24:58 +0000656 sqlite3TreeViewLine(pView, "IN flags=0x%x", pExpr->flags);
drh38b41492015-06-08 15:08:15 +0000657 sqlite3TreeViewExpr(pView, pExpr->pLeft, 1);
drha4eeccd2021-10-07 17:43:30 +0000658 if( ExprUseXSelect(pExpr) ){
drh38b41492015-06-08 15:08:15 +0000659 sqlite3TreeViewSelect(pView, pExpr->x.pSelect, 0);
660 }else{
661 sqlite3TreeViewExprList(pView, pExpr->x.pList, 0, 0);
662 }
663 break;
664 }
665#endif /* SQLITE_OMIT_SUBQUERY */
666
667 /*
668 ** x BETWEEN y AND z
669 **
670 ** This is equivalent to
671 **
672 ** x>=y AND x<=z
673 **
674 ** X is stored in pExpr->pLeft.
675 ** Y is stored in pExpr->pList->a[0].pExpr.
676 ** Z is stored in pExpr->pList->a[1].pExpr.
677 */
678 case TK_BETWEEN: {
drha4eeccd2021-10-07 17:43:30 +0000679 const Expr *pX, *pY, *pZ;
680 pX = pExpr->pLeft;
681 assert( ExprUseXList(pExpr) );
682 assert( pExpr->x.pList->nExpr==2 );
683 pY = pExpr->x.pList->a[0].pExpr;
684 pZ = pExpr->x.pList->a[1].pExpr;
drh38b41492015-06-08 15:08:15 +0000685 sqlite3TreeViewLine(pView, "BETWEEN");
686 sqlite3TreeViewExpr(pView, pX, 1);
687 sqlite3TreeViewExpr(pView, pY, 1);
688 sqlite3TreeViewExpr(pView, pZ, 0);
689 break;
690 }
691 case TK_TRIGGER: {
692 /* If the opcode is TK_TRIGGER, then the expression is a reference
693 ** to a column in the new.* or old.* pseudo-tables available to
694 ** trigger programs. In this case Expr.iTable is set to 1 for the
695 ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
696 ** is set to the column of the pseudo-table to read, or to -1 to
697 ** read the rowid field.
698 */
699 sqlite3TreeViewLine(pView, "%s(%d)",
700 pExpr->iTable ? "NEW" : "OLD", pExpr->iColumn);
701 break;
702 }
703 case TK_CASE: {
704 sqlite3TreeViewLine(pView, "CASE");
705 sqlite3TreeViewExpr(pView, pExpr->pLeft, 1);
drha4eeccd2021-10-07 17:43:30 +0000706 assert( ExprUseXList(pExpr) );
drh38b41492015-06-08 15:08:15 +0000707 sqlite3TreeViewExprList(pView, pExpr->x.pList, 0, 0);
708 break;
709 }
710#ifndef SQLITE_OMIT_TRIGGER
711 case TK_RAISE: {
712 const char *zType = "unk";
drh11949042019-08-05 18:01:42 +0000713 switch( pExpr->affExpr ){
drh38b41492015-06-08 15:08:15 +0000714 case OE_Rollback: zType = "rollback"; break;
715 case OE_Abort: zType = "abort"; break;
716 case OE_Fail: zType = "fail"; break;
717 case OE_Ignore: zType = "ignore"; break;
718 }
drhf9751072021-10-07 13:40:29 +0000719 assert( !ExprHasProperty(pExpr, EP_IntValue) );
drh38b41492015-06-08 15:08:15 +0000720 sqlite3TreeViewLine(pView, "RAISE %s(%Q)", zType, pExpr->u.zToken);
721 break;
722 }
723#endif
drhc84a4022016-05-27 12:30:20 +0000724 case TK_MATCH: {
725 sqlite3TreeViewLine(pView, "MATCH {%d:%d}%s",
726 pExpr->iTable, pExpr->iColumn, zFlgs);
727 sqlite3TreeViewExpr(pView, pExpr->pRight, 0);
728 break;
729 }
drhdb97e562016-08-18 17:55:57 +0000730 case TK_VECTOR: {
drh269d3222019-10-23 18:09:39 +0000731 char *z = sqlite3_mprintf("VECTOR%s",zFlgs);
drha4eeccd2021-10-07 17:43:30 +0000732 assert( ExprUseXList(pExpr) );
drh269d3222019-10-23 18:09:39 +0000733 sqlite3TreeViewBareExprList(pView, pExpr->x.pList, z);
734 sqlite3_free(z);
drhdb97e562016-08-18 17:55:57 +0000735 break;
736 }
drh48cb3a72016-08-18 18:09:10 +0000737 case TK_SELECT_COLUMN: {
drhe46292a2021-07-05 02:40:29 +0000738 sqlite3TreeViewLine(pView, "SELECT-COLUMN %d of [0..%d]%s",
739 pExpr->iColumn, pExpr->iTable-1,
740 pExpr->pRight==pExpr->pLeft ? " (SELECT-owner)" : "");
drha4eeccd2021-10-07 17:43:30 +0000741 assert( ExprUseXSelect(pExpr->pLeft) );
drh48cb3a72016-08-18 18:09:10 +0000742 sqlite3TreeViewSelect(pView, pExpr->pLeft->x.pSelect, 0);
743 break;
744 }
drh31d6fd52017-04-14 19:03:10 +0000745 case TK_IF_NULL_ROW: {
746 sqlite3TreeViewLine(pView, "IF-NULL-ROW %d", pExpr->iTable);
747 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
748 break;
749 }
drhbf7f3a02021-05-24 11:35:16 +0000750 case TK_ERROR: {
751 Expr tmp;
752 sqlite3TreeViewLine(pView, "ERROR");
753 tmp = *pExpr;
754 tmp.op = pExpr->op2;
755 sqlite3TreeViewExpr(pView, &tmp, 0);
756 break;
757 }
drh4a4e02b2021-07-04 22:33:08 +0000758 case TK_ROW: {
759 if( pExpr->iColumn<=0 ){
760 sqlite3TreeViewLine(pView, "First FROM table rowid");
761 }else{
762 sqlite3TreeViewLine(pView, "First FROM table column %d",
763 pExpr->iColumn-1);
764 }
765 break;
766 }
drh38b41492015-06-08 15:08:15 +0000767 default: {
768 sqlite3TreeViewLine(pView, "op=%d", pExpr->op);
769 break;
770 }
771 }
772 if( zBinOp ){
drhb3d903e2015-06-18 14:09:13 +0000773 sqlite3TreeViewLine(pView, "%s%s", zBinOp, zFlgs);
drh38b41492015-06-08 15:08:15 +0000774 sqlite3TreeViewExpr(pView, pExpr->pLeft, 1);
775 sqlite3TreeViewExpr(pView, pExpr->pRight, 0);
776 }else if( zUniOp ){
drhb3d903e2015-06-18 14:09:13 +0000777 sqlite3TreeViewLine(pView, "%s%s", zUniOp, zFlgs);
drh11949042019-08-05 18:01:42 +0000778 sqlite3TreeViewExpr(pView, pExpr->pLeft, 0);
drh38b41492015-06-08 15:08:15 +0000779 }
drh2a7dcbf2022-04-06 15:41:53 +0000780 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000781}
782
drhdb97e562016-08-18 17:55:57 +0000783
drh38b41492015-06-08 15:08:15 +0000784/*
785** Generate a human-readable explanation of an expression list.
786*/
drhdb97e562016-08-18 17:55:57 +0000787void sqlite3TreeViewBareExprList(
drh38b41492015-06-08 15:08:15 +0000788 TreeView *pView,
789 const ExprList *pList,
drh38b41492015-06-08 15:08:15 +0000790 const char *zLabel
791){
drh38b41492015-06-08 15:08:15 +0000792 if( zLabel==0 || zLabel[0]==0 ) zLabel = "LIST";
793 if( pList==0 ){
794 sqlite3TreeViewLine(pView, "%s (empty)", zLabel);
795 }else{
drhdb97e562016-08-18 17:55:57 +0000796 int i;
drh38b41492015-06-08 15:08:15 +0000797 sqlite3TreeViewLine(pView, "%s", zLabel);
798 for(i=0; i<pList->nExpr; i++){
drh5579d592015-08-26 14:01:41 +0000799 int j = pList->a[i].u.x.iOrderByCol;
drh41cee662019-12-12 20:22:34 +0000800 char *zName = pList->a[i].zEName;
drhfbe07532018-04-23 20:04:38 +0000801 int moreToFollow = i<pList->nExpr - 1;
drh5a699a02017-12-22 19:53:02 +0000802 if( j || zName ){
drh2a7dcbf2022-04-06 15:41:53 +0000803 sqlite3TreeViewPush(&pView, moreToFollow);
drhfbe07532018-04-23 20:04:38 +0000804 moreToFollow = 0;
805 sqlite3TreeViewLine(pView, 0);
806 if( zName ){
drhd4e9caf2022-04-20 12:14:20 +0000807 switch( pList->a[i].eEName ){
808 default:
809 fprintf(stdout, "AS %s ", zName);
810 break;
811 case ENAME_TAB:
812 fprintf(stdout, "TABLE-ALIAS-NAME(\"%s\") ", zName);
drh815b7822022-04-20 15:07:39 +0000813 if( pList->a[i].bUsed==0 ) fprintf(stdout, "(unused) ");
drhd4e9caf2022-04-20 12:14:20 +0000814 break;
815 case ENAME_SPAN:
816 fprintf(stdout, "SPAN(\"%s\") ", zName);
817 break;
818 }
drhfbe07532018-04-23 20:04:38 +0000819 }
820 if( j ){
821 fprintf(stdout, "iOrderByCol=%d", j);
822 }
823 fprintf(stdout, "\n");
824 fflush(stdout);
drh5a699a02017-12-22 19:53:02 +0000825 }
drhfbe07532018-04-23 20:04:38 +0000826 sqlite3TreeViewExpr(pView, pList->a[i].pExpr, moreToFollow);
drh5a699a02017-12-22 19:53:02 +0000827 if( j || zName ){
drh2a7dcbf2022-04-06 15:41:53 +0000828 sqlite3TreeViewPop(&pView);
drh5a699a02017-12-22 19:53:02 +0000829 }
drh38b41492015-06-08 15:08:15 +0000830 }
831 }
drhdb97e562016-08-18 17:55:57 +0000832}
833void sqlite3TreeViewExprList(
834 TreeView *pView,
835 const ExprList *pList,
836 u8 moreToFollow,
837 const char *zLabel
838){
drh2a7dcbf2022-04-06 15:41:53 +0000839 sqlite3TreeViewPush(&pView, moreToFollow);
drhdb97e562016-08-18 17:55:57 +0000840 sqlite3TreeViewBareExprList(pView, pList, zLabel);
drh2a7dcbf2022-04-06 15:41:53 +0000841 sqlite3TreeViewPop(&pView);
drh38b41492015-06-08 15:08:15 +0000842}
843
drh7d2c1d22022-04-06 00:29:21 +0000844/*
845** Generate a human-readable explanation of an id-list.
846*/
847void sqlite3TreeViewBareIdList(
848 TreeView *pView,
849 const IdList *pList,
850 const char *zLabel
851){
852 if( zLabel==0 || zLabel[0]==0 ) zLabel = "LIST";
853 if( pList==0 ){
854 sqlite3TreeViewLine(pView, "%s (empty)", zLabel);
855 }else{
856 int i;
857 sqlite3TreeViewLine(pView, "%s", zLabel);
858 for(i=0; i<pList->nId; i++){
859 char *zName = pList->a[i].zName;
860 int moreToFollow = i<pList->nId - 1;
861 if( zName==0 ) zName = "(null)";
drh2a7dcbf2022-04-06 15:41:53 +0000862 sqlite3TreeViewPush(&pView, moreToFollow);
drh7d2c1d22022-04-06 00:29:21 +0000863 sqlite3TreeViewLine(pView, 0);
drha99e3252022-04-15 15:47:14 +0000864 if( pList->eU4==EU4_NONE ){
865 fprintf(stdout, "%s\n", zName);
866 }else if( pList->eU4==EU4_IDX ){
867 fprintf(stdout, "%s (%d)\n", zName, pList->a[i].u4.idx);
868 }else{
869 assert( pList->eU4==EU4_EXPR );
870 if( pList->a[i].u4.pExpr==0 ){
871 fprintf(stdout, "%s (pExpr=NULL)\n", zName);
872 }else{
873 fprintf(stdout, "%s\n", zName);
874 sqlite3TreeViewPush(&pView, i<pList->nId-1);
875 sqlite3TreeViewExpr(pView, pList->a[i].u4.pExpr, 0);
876 sqlite3TreeViewPop(&pView);
877 }
878 }
drh2a7dcbf2022-04-06 15:41:53 +0000879 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +0000880 }
881 }
882}
883void sqlite3TreeViewIdList(
884 TreeView *pView,
885 const IdList *pList,
886 u8 moreToFollow,
887 const char *zLabel
888){
drh2a7dcbf2022-04-06 15:41:53 +0000889 sqlite3TreeViewPush(&pView, moreToFollow);
drh7d2c1d22022-04-06 00:29:21 +0000890 sqlite3TreeViewBareIdList(pView, pList, zLabel);
drh2a7dcbf2022-04-06 15:41:53 +0000891 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +0000892}
893
894/*
895** Generate a human-readable explanation of a list of Upsert objects
896*/
897void sqlite3TreeViewUpsert(
898 TreeView *pView,
899 const Upsert *pUpsert,
900 u8 moreToFollow
901){
902 if( pUpsert==0 ) return;
drh2a7dcbf2022-04-06 15:41:53 +0000903 sqlite3TreeViewPush(&pView, moreToFollow);
drh7d2c1d22022-04-06 00:29:21 +0000904 while( pUpsert ){
905 int n;
drh2a7dcbf2022-04-06 15:41:53 +0000906 sqlite3TreeViewPush(&pView, pUpsert->pNextUpsert!=0 || moreToFollow);
drh7d2c1d22022-04-06 00:29:21 +0000907 sqlite3TreeViewLine(pView, "ON CONFLICT DO %s",
908 pUpsert->isDoUpdate ? "UPDATE" : "NOTHING");
909 n = (pUpsert->pUpsertSet!=0) + (pUpsert->pUpsertWhere!=0);
910 sqlite3TreeViewExprList(pView, pUpsert->pUpsertTarget, (n--)>0, "TARGET");
911 sqlite3TreeViewExprList(pView, pUpsert->pUpsertSet, (n--)>0, "SET");
912 if( pUpsert->pUpsertWhere ){
913 sqlite3TreeViewItem(pView, "WHERE", (n--)>0);
914 sqlite3TreeViewExpr(pView, pUpsert->pUpsertWhere, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000915 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +0000916 }
drh2a7dcbf2022-04-06 15:41:53 +0000917 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +0000918 pUpsert = pUpsert->pNextUpsert;
919 }
drh2a7dcbf2022-04-06 15:41:53 +0000920 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +0000921}
922
923/*
924** Generate a human-readable diagram of the data structure that go
drhf8ef2db2022-04-06 10:37:44 +0000925** into generating an DELETE statement.
926*/
927void sqlite3TreeViewDelete(
drhf8ef2db2022-04-06 10:37:44 +0000928 const With *pWith,
929 const SrcList *pTabList,
930 const Expr *pWhere,
931 const ExprList *pOrderBy,
drh2a7dcbf2022-04-06 15:41:53 +0000932 const Expr *pLimit,
933 const Trigger *pTrigger
drhf8ef2db2022-04-06 10:37:44 +0000934){
935 int n = 0;
drh2a7dcbf2022-04-06 15:41:53 +0000936 TreeView *pView = 0;
937 sqlite3TreeViewPush(&pView, 0);
drhf8ef2db2022-04-06 10:37:44 +0000938 sqlite3TreeViewLine(pView, "DELETE");
drhf8ef2db2022-04-06 10:37:44 +0000939 if( pWith ) n++;
940 if( pTabList ) n++;
941 if( pWhere ) n++;
942 if( pOrderBy ) n++;
943 if( pLimit ) n++;
drh2a7dcbf2022-04-06 15:41:53 +0000944 if( pTrigger ) n++;
drhf8ef2db2022-04-06 10:37:44 +0000945 if( pWith ){
drh2a7dcbf2022-04-06 15:41:53 +0000946 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +0000947 sqlite3TreeViewWith(pView, pWith, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000948 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +0000949 }
950 if( pTabList ){
drh2a7dcbf2022-04-06 15:41:53 +0000951 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +0000952 sqlite3TreeViewLine(pView, "FROM");
953 sqlite3TreeViewSrcList(pView, pTabList);
drh2a7dcbf2022-04-06 15:41:53 +0000954 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +0000955 }
956 if( pWhere ){
drh2a7dcbf2022-04-06 15:41:53 +0000957 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +0000958 sqlite3TreeViewLine(pView, "WHERE");
959 sqlite3TreeViewExpr(pView, pWhere, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000960 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +0000961 }
962 if( pOrderBy ){
963 sqlite3TreeViewExprList(pView, pOrderBy, (--n)>0, "ORDER-BY");
964 }
965 if( pLimit ){
drh2a7dcbf2022-04-06 15:41:53 +0000966 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +0000967 sqlite3TreeViewLine(pView, "LIMIT");
968 sqlite3TreeViewExpr(pView, pLimit, 0);
drh2a7dcbf2022-04-06 15:41:53 +0000969 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +0000970 }
drh2a7dcbf2022-04-06 15:41:53 +0000971 if( pTrigger ){
972 sqlite3TreeViewTrigger(pView, pTrigger, (--n)>0, 1);
973 }
974 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +0000975}
976
977/*
978** Generate a human-readable diagram of the data structure that go
drh7d2c1d22022-04-06 00:29:21 +0000979** into generating an INSERT statement.
980*/
981void sqlite3TreeViewInsert(
drh7d2c1d22022-04-06 00:29:21 +0000982 const With *pWith,
983 const SrcList *pTabList,
984 const IdList *pColumnList,
985 const Select *pSelect,
drhc2d0df92022-04-06 18:30:17 +0000986 const ExprList *pExprList,
drh7d2c1d22022-04-06 00:29:21 +0000987 int onError,
drh2a7dcbf2022-04-06 15:41:53 +0000988 const Upsert *pUpsert,
989 const Trigger *pTrigger
drh7d2c1d22022-04-06 00:29:21 +0000990){
drh2a7dcbf2022-04-06 15:41:53 +0000991 TreeView *pView = 0;
drh7d2c1d22022-04-06 00:29:21 +0000992 int n = 0;
993 const char *zLabel = "INSERT";
994 switch( onError ){
995 case OE_Replace: zLabel = "REPLACE"; break;
996 case OE_Ignore: zLabel = "INSERT OR IGNORE"; break;
997 case OE_Rollback: zLabel = "INSERT OR ROLLBACK"; break;
998 case OE_Abort: zLabel = "INSERT OR ABORT"; break;
999 case OE_Fail: zLabel = "INSERT OR FAIL"; break;
1000 }
drh2a7dcbf2022-04-06 15:41:53 +00001001 sqlite3TreeViewPush(&pView, 0);
drh7d2c1d22022-04-06 00:29:21 +00001002 sqlite3TreeViewLine(pView, zLabel);
drh7d2c1d22022-04-06 00:29:21 +00001003 if( pWith ) n++;
1004 if( pTabList ) n++;
1005 if( pColumnList ) n++;
1006 if( pSelect ) n++;
drhc2d0df92022-04-06 18:30:17 +00001007 if( pExprList ) n++;
drh7d2c1d22022-04-06 00:29:21 +00001008 if( pUpsert ) n++;
drh2a7dcbf2022-04-06 15:41:53 +00001009 if( pTrigger ) n++;
drh7d2c1d22022-04-06 00:29:21 +00001010 if( pWith ){
drh2a7dcbf2022-04-06 15:41:53 +00001011 sqlite3TreeViewPush(&pView, (--n)>0);
drh7d2c1d22022-04-06 00:29:21 +00001012 sqlite3TreeViewWith(pView, pWith, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001013 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +00001014 }
1015 if( pTabList ){
drh2a7dcbf2022-04-06 15:41:53 +00001016 sqlite3TreeViewPush(&pView, (--n)>0);
drh7d2c1d22022-04-06 00:29:21 +00001017 sqlite3TreeViewLine(pView, "INTO");
1018 sqlite3TreeViewSrcList(pView, pTabList);
drh2a7dcbf2022-04-06 15:41:53 +00001019 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +00001020 }
1021 if( pColumnList ){
1022 sqlite3TreeViewIdList(pView, pColumnList, (--n)>0, "COLUMNS");
1023 }
1024 if( pSelect ){
drh2a7dcbf2022-04-06 15:41:53 +00001025 sqlite3TreeViewPush(&pView, (--n)>0);
drh7d2c1d22022-04-06 00:29:21 +00001026 sqlite3TreeViewLine(pView, "DATA-SOURCE");
1027 sqlite3TreeViewSelect(pView, pSelect, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001028 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +00001029 }
drhc2d0df92022-04-06 18:30:17 +00001030 if( pExprList ){
1031 sqlite3TreeViewExprList(pView, pExprList, (--n)>0, "VALUES");
1032 }
drh7d2c1d22022-04-06 00:29:21 +00001033 if( pUpsert ){
drh2a7dcbf2022-04-06 15:41:53 +00001034 sqlite3TreeViewPush(&pView, (--n)>0);
drh7d2c1d22022-04-06 00:29:21 +00001035 sqlite3TreeViewLine(pView, "UPSERT");
1036 sqlite3TreeViewUpsert(pView, pUpsert, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001037 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +00001038 }
drh2a7dcbf2022-04-06 15:41:53 +00001039 if( pTrigger ){
1040 sqlite3TreeViewTrigger(pView, pTrigger, (--n)>0, 1);
1041 }
1042 sqlite3TreeViewPop(&pView);
drh7d2c1d22022-04-06 00:29:21 +00001043}
1044
drhf8ef2db2022-04-06 10:37:44 +00001045/*
1046** Generate a human-readable diagram of the data structure that go
1047** into generating an UPDATE statement.
1048*/
1049void sqlite3TreeViewUpdate(
drhf8ef2db2022-04-06 10:37:44 +00001050 const With *pWith,
1051 const SrcList *pTabList,
1052 const ExprList *pChanges,
1053 const Expr *pWhere,
1054 int onError,
1055 const ExprList *pOrderBy,
1056 const Expr *pLimit,
drh2a7dcbf2022-04-06 15:41:53 +00001057 const Upsert *pUpsert,
1058 const Trigger *pTrigger
drhf8ef2db2022-04-06 10:37:44 +00001059){
1060 int n = 0;
drh2a7dcbf2022-04-06 15:41:53 +00001061 TreeView *pView = 0;
drhf8ef2db2022-04-06 10:37:44 +00001062 const char *zLabel = "UPDATE";
1063 switch( onError ){
1064 case OE_Replace: zLabel = "UPDATE OR REPLACE"; break;
1065 case OE_Ignore: zLabel = "UPDATE OR IGNORE"; break;
1066 case OE_Rollback: zLabel = "UPDATE OR ROLLBACK"; break;
1067 case OE_Abort: zLabel = "UPDATE OR ABORT"; break;
1068 case OE_Fail: zLabel = "UPDATE OR FAIL"; break;
1069 }
drh2a7dcbf2022-04-06 15:41:53 +00001070 sqlite3TreeViewPush(&pView, 0);
drhf8ef2db2022-04-06 10:37:44 +00001071 sqlite3TreeViewLine(pView, zLabel);
drhf8ef2db2022-04-06 10:37:44 +00001072 if( pWith ) n++;
1073 if( pTabList ) n++;
1074 if( pChanges ) n++;
1075 if( pWhere ) n++;
1076 if( pOrderBy ) n++;
1077 if( pLimit ) n++;
1078 if( pUpsert ) n++;
drh2a7dcbf2022-04-06 15:41:53 +00001079 if( pTrigger ) n++;
drhf8ef2db2022-04-06 10:37:44 +00001080 if( pWith ){
drh2a7dcbf2022-04-06 15:41:53 +00001081 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +00001082 sqlite3TreeViewWith(pView, pWith, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001083 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001084 }
1085 if( pTabList ){
drh2a7dcbf2022-04-06 15:41:53 +00001086 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +00001087 sqlite3TreeViewLine(pView, "FROM");
1088 sqlite3TreeViewSrcList(pView, pTabList);
drh2a7dcbf2022-04-06 15:41:53 +00001089 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001090 }
1091 if( pChanges ){
1092 sqlite3TreeViewExprList(pView, pChanges, (--n)>0, "SET");
1093 }
1094 if( pWhere ){
drh2a7dcbf2022-04-06 15:41:53 +00001095 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +00001096 sqlite3TreeViewLine(pView, "WHERE");
1097 sqlite3TreeViewExpr(pView, pWhere, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001098 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001099 }
1100 if( pOrderBy ){
1101 sqlite3TreeViewExprList(pView, pOrderBy, (--n)>0, "ORDER-BY");
1102 }
1103 if( pLimit ){
drh2a7dcbf2022-04-06 15:41:53 +00001104 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +00001105 sqlite3TreeViewLine(pView, "LIMIT");
1106 sqlite3TreeViewExpr(pView, pLimit, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001107 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001108 }
1109 if( pUpsert ){
drh2a7dcbf2022-04-06 15:41:53 +00001110 sqlite3TreeViewPush(&pView, (--n)>0);
drhf8ef2db2022-04-06 10:37:44 +00001111 sqlite3TreeViewLine(pView, "UPSERT");
1112 sqlite3TreeViewUpsert(pView, pUpsert, 0);
drh2a7dcbf2022-04-06 15:41:53 +00001113 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001114 }
drh2a7dcbf2022-04-06 15:41:53 +00001115 if( pTrigger ){
1116 sqlite3TreeViewTrigger(pView, pTrigger, (--n)>0, 1);
1117 }
1118 sqlite3TreeViewPop(&pView);
drhf8ef2db2022-04-06 10:37:44 +00001119}
1120
drh2a7dcbf2022-04-06 15:41:53 +00001121#ifndef SQLITE_OMIT_TRIGGER
1122/*
1123** Show a human-readable graph of a TriggerStep
1124*/
1125void sqlite3TreeViewTriggerStep(
1126 TreeView *pView,
1127 const TriggerStep *pStep,
1128 u8 moreToFollow,
1129 u8 showFullList
1130){
1131 int cnt = 0;
1132 if( pStep==0 ) return;
1133 sqlite3TreeViewPush(&pView,
1134 moreToFollow || (showFullList && pStep->pNext!=0));
1135 do{
1136 if( cnt++ && pStep->pNext==0 ){
1137 sqlite3TreeViewPop(&pView);
1138 sqlite3TreeViewPush(&pView, 0);
1139 }
1140 sqlite3TreeViewLine(pView, "%s", pStep->zSpan ? pStep->zSpan : "RETURNING");
1141 }while( showFullList && (pStep = pStep->pNext)!=0 );
1142 sqlite3TreeViewPop(&pView);
1143}
1144
1145/*
1146** Show a human-readable graph of a Trigger
1147*/
1148void sqlite3TreeViewTrigger(
1149 TreeView *pView,
1150 const Trigger *pTrigger,
1151 u8 moreToFollow,
1152 u8 showFullList
1153){
1154 int cnt = 0;
1155 if( pTrigger==0 ) return;
1156 sqlite3TreeViewPush(&pView,
1157 moreToFollow || (showFullList && pTrigger->pNext!=0));
1158 do{
1159 if( cnt++ && pTrigger->pNext==0 ){
1160 sqlite3TreeViewPop(&pView);
1161 sqlite3TreeViewPush(&pView, 0);
1162 }
1163 sqlite3TreeViewLine(pView, "TRIGGER %s", pTrigger->zName);
1164 sqlite3TreeViewPush(&pView, 0);
1165 sqlite3TreeViewTriggerStep(pView, pTrigger->step_list, 0, 1);
1166 sqlite3TreeViewPop(&pView);
1167 }while( showFullList && (pTrigger = pTrigger->pNext)!=0 );
1168 sqlite3TreeViewPop(&pView);
1169}
1170#endif /* SQLITE_OMIT_TRIGGER */
1171
1172
drh8f1eb6f2022-04-06 12:25:04 +00001173/*
1174** These simplified versions of the tree-view routines omit unnecessary
1175** parameters. These variants are intended to be used from a symbolic
1176** debugger, such as "gdb", during interactive debugging sessions.
1177**
1178** This routines are given external linkage so that they will always be
1179** accessible to the debugging, and to avoid warnings about unused
1180** functions. But these routines only exist in debugging builds, so they
1181** do not contaminate the interface.
1182*/
1183void sqlite3ShowExpr(const Expr *p){ sqlite3TreeViewExpr(0,p,0); }
1184void sqlite3ShowExprList(const ExprList *p){ sqlite3TreeViewExprList(0,p,0,0);}
1185void sqlite3ShowIdList(const IdList *p){ sqlite3TreeViewIdList(0,p,0,0); }
1186void sqlite3ShowSrcList(const SrcList *p){ sqlite3TreeViewSrcList(0,p); }
1187void sqlite3ShowSelect(const Select *p){ sqlite3TreeViewSelect(0,p,0); }
1188void sqlite3ShowWith(const With *p){ sqlite3TreeViewWith(0,p,0); }
1189void sqlite3ShowUpsert(const Upsert *p){ sqlite3TreeViewUpsert(0,p,0); }
drh2a7dcbf2022-04-06 15:41:53 +00001190#ifndef SQLITE_OMIT_TRIGGER
1191void sqlite3ShowTriggerStep(const TriggerStep *p){
1192 sqlite3TreeViewTriggerStep(0,p,0,0);
1193}
1194void sqlite3ShowTriggerStepList(const TriggerStep *p){
1195 sqlite3TreeViewTriggerStep(0,p,0,1);
1196}
1197void sqlite3ShowTrigger(const Trigger *p){ sqlite3TreeViewTrigger(0,p,0,0); }
1198void sqlite3ShowTriggerList(const Trigger *p){ sqlite3TreeViewTrigger(0,p,0,1);}
1199#endif
drh8f1eb6f2022-04-06 12:25:04 +00001200#ifndef SQLITE_OMIT_WINDOWFUNC
1201void sqlite3ShowWindow(const Window *p){ sqlite3TreeViewWindow(0,p,0); }
1202void sqlite3ShowWinFunc(const Window *p){ sqlite3TreeViewWinFunc(0,p,0); }
1203#endif
1204
drh38b41492015-06-08 15:08:15 +00001205#endif /* SQLITE_DEBUG */