2
** The "printf" code that follows dates from the 1980's. It is in
3
** the public domain. The original comments are included here for
4
** completeness. They are very out-of-date but might be useful as
5
** an historical reference. Most of the "enhancements" have been backed
6
** out so that the functionality is now the same as standard printf().
8
**************************************************************************
10
** The following modules is an enhanced replacement for the "printf" subroutines
11
** found in the standard C library. The following enhancements are
14
** + Additional functions. The standard set of "printf" functions
15
** includes printf, fprintf, sprintf, vprintf, vfprintf, and
16
** vsprintf. This module adds the following:
18
** * snprintf -- Works like sprintf, but has an extra argument
19
** which is the size of the buffer written to.
21
** * mprintf -- Similar to sprintf. Writes output to memory
22
** obtained from malloc.
24
** * xprintf -- Calls a function to dispose of output.
26
** * nprintf -- No output, but returns the number of characters
27
** that would have been output by printf.
29
** * A v- version (ex: vsnprintf) of every function is also
32
** + A few extensions to the formatting notation are supported:
34
** * The "=" flag (similar to "-") causes the output to be
35
** be centered in the appropriately sized field.
37
** * The %b field outputs an integer in binary notation.
39
** * The %c field now accepts a precision. The character output
40
** is repeated by the number of times the precision specifies.
42
** * The %' field works like %c, but takes as its character the
43
** next character of the format string, instead of the next
44
** argument. For example, printf("%.78'-") prints 78 minus
45
** signs, the same as printf("%.78c",'-').
47
** + When compiled using GCC on a SPARC, this version of printf is
48
** faster than the library printf for SUN OS 4.1.
50
** + All functions are fully reentrant.
53
#include "sqliteInt.h"
56
** Conversion types fall into various categories as defined by the
57
** following enumeration.
59
#define etRADIX 1 /* Integer types. %d, %x, %o, and so forth */
60
#define etFLOAT 2 /* Floating point. %f */
61
#define etEXP 3 /* Exponentional notation. %e and %E */
62
#define etGENERIC 4 /* Floating or exponential, depending on exponent. %g */
63
#define etSIZE 5 /* Return number of characters processed so far. %n */
64
#define etSTRING 6 /* Strings. %s */
65
#define etDYNSTRING 7 /* Dynamically allocated strings. %z */
66
#define etPERCENT 8 /* Percent symbol. %% */
67
#define etCHARX 9 /* Characters. %c */
68
#define etERROR 10 /* Used to indicate no such conversion type */
69
/* The rest are extensions, not normally found in printf() */
70
#define etCHARLIT 11 /* Literal characters. %' */
71
#define etSQLESCAPE 12 /* Strings with '\'' doubled. %q */
72
#define etSQLESCAPE2 13 /* Strings with '\'' doubled and enclosed in '',
73
NULL pointers replaced by SQL NULL. %Q */
74
#define etTOKEN 14 /* a pointer to a Token structure */
75
#define etSRCLIST 15 /* a pointer to a SrcList */
79
** An "etByte" is an 8-bit unsigned value.
81
typedef unsigned char etByte;
84
** Each builtin conversion character (ex: the 'd' in "%d") is described
85
** by an instance of the following structure
87
typedef struct et_info { /* Information about each format field */
88
char fmttype; /* The format field code letter */
89
etByte base; /* The base for radix conversion */
90
etByte flags; /* One or more of FLAG_ constants below */
91
etByte type; /* Conversion paradigm */
92
char *charset; /* The character set for conversion */
93
char *prefix; /* Prefix on non-zero values in alt format */
97
** Allowed values for et_info.flags
99
#define FLAG_SIGNED 1 /* True if the value to convert is signed */
100
#define FLAG_INTERN 2 /* True if for internal use only */
104
** The following table is searched linearly, so it is good to put the
105
** most frequently used conversion types first.
107
static et_info fmtinfo[] = {
108
{ 'd', 10, 1, etRADIX, "0123456789", 0 },
109
{ 's', 0, 0, etSTRING, 0, 0 },
110
{ 'z', 0, 2, etDYNSTRING, 0, 0 },
111
{ 'q', 0, 0, etSQLESCAPE, 0, 0 },
112
{ 'Q', 0, 0, etSQLESCAPE2, 0, 0 },
113
{ 'c', 0, 0, etCHARX, 0, 0 },
114
{ 'o', 8, 0, etRADIX, "01234567", "0" },
115
{ 'u', 10, 0, etRADIX, "0123456789", 0 },
116
{ 'x', 16, 0, etRADIX, "0123456789abcdef", "x0" },
117
{ 'X', 16, 0, etRADIX, "0123456789ABCDEF", "X0" },
118
{ 'f', 0, 1, etFLOAT, 0, 0 },
119
{ 'e', 0, 1, etEXP, "e", 0 },
120
{ 'E', 0, 1, etEXP, "E", 0 },
121
{ 'g', 0, 1, etGENERIC, "e", 0 },
122
{ 'G', 0, 1, etGENERIC, "E", 0 },
123
{ 'i', 10, 1, etRADIX, "0123456789", 0 },
124
{ 'n', 0, 0, etSIZE, 0, 0 },
125
{ '%', 0, 0, etPERCENT, 0, 0 },
126
{ 'p', 10, 0, etRADIX, "0123456789", 0 },
127
{ 'T', 0, 2, etTOKEN, 0, 0 },
128
{ 'S', 0, 2, etSRCLIST, 0, 0 },
130
#define etNINFO (sizeof(fmtinfo)/sizeof(fmtinfo[0]))
133
** If NOFLOATINGPOINT is defined, then none of the floating point
134
** conversions will work.
136
#ifndef etNOFLOATINGPOINT
138
** "*val" is a double such that 0.1 <= *val < 10.0
139
** Return the ascii code for the leading digit of *val, then
140
** multiply "*val" by 10.0 to renormalize.
143
** input: *val = 3.14159
144
** output: *val = 1.4159 function return = '3'
146
** The counter *cnt is incremented each time. After counter exceeds
147
** 16 (the number of significant digits in a 64-bit float) '0' is
150
static int et_getdigit(LONGDOUBLE_TYPE *val, int *cnt){
153
if( (*cnt)++ >= 16 ) return '0';
157
*val = (*val - d)*10.0;
162
#define etBUFSIZE 1000 /* Size of the output buffer */
165
** The root program. All variations call this core.
168
** func This is a pointer to a function taking three arguments
169
** 1. A pointer to anything. Same as the "arg" parameter.
170
** 2. A pointer to the list of characters to be output
171
** (Note, this list is NOT null terminated.)
172
** 3. An integer number of characters to be output.
173
** (Note: This number might be zero.)
175
** arg This is the pointer to anything which will be passed as the
176
** first argument to "func". Use it for whatever you like.
178
** fmt This is the format string, as in the usual print.
180
** ap This is a pointer to a list of arguments. Same as in
184
** The return value is the total number of characters sent to
185
** the function "func". Returns -1 on a error.
187
** Note that the order in which automatic variables are declared below
188
** seems to make a big difference in determining how fast this beast
192
void (*func)(void*,const char*,int), /* Consumer of text */
193
void *arg, /* First argument to the consumer */
194
int useExtended, /* Allow extended %-conversions */
195
const char *fmt, /* Format string */
196
va_list ap /* arguments */
198
int c; /* Next character in the format string */
199
char *bufpt; /* Pointer to the conversion buffer */
200
int precision; /* Precision of the current field */
201
int length; /* Length of the field */
202
int idx; /* A general purpose loop counter */
203
int count; /* Total number of characters output */
204
int width; /* Width of the current field */
205
etByte flag_leftjustify; /* True if "-" flag is present */
206
etByte flag_plussign; /* True if "+" flag is present */
207
etByte flag_blanksign; /* True if " " flag is present */
208
etByte flag_alternateform; /* True if "#" flag is present */
209
etByte flag_zeropad; /* True if field width constant starts with zero */
210
etByte flag_long; /* True if "l" flag is present */
211
unsigned long longvalue; /* Value for integer types */
212
LONGDOUBLE_TYPE realvalue; /* Value for real types */
213
et_info *infop; /* Pointer to the appropriate info structure */
214
char buf[etBUFSIZE]; /* Conversion buffer */
215
char prefix; /* Prefix character. "+" or "-" or " " or '\0'. */
216
etByte errorflag = 0; /* True if an error is encountered */
217
etByte xtype; /* Conversion paradigm */
218
char *zExtra; /* Extra memory used for etTCLESCAPE conversions */
219
static char spaces[] = " ";
220
#define etSPACESIZE (sizeof(spaces)-1)
221
#ifndef etNOFLOATINGPOINT
222
int exp; /* exponent of real numbers */
223
double rounder; /* Used for rounding floating point values */
224
etByte flag_dp; /* True if decimal point should be shown */
225
etByte flag_rtz; /* True if trailing zeros should be removed */
226
etByte flag_exp; /* True to force display of the exponent */
227
int nsd; /* Number of significant digits returned */
232
for(; (c=(*fmt))!=0; ++fmt){
237
while( (c=(*++fmt))!='%' && c!=0 ) amt++;
238
(*func)(arg,bufpt,amt);
242
if( (c=(*++fmt))==0 ){
248
/* Find out what flags are present */
249
flag_leftjustify = flag_plussign = flag_blanksign =
250
flag_alternateform = flag_zeropad = 0;
253
case '-': flag_leftjustify = 1; c = 0; break;
254
case '+': flag_plussign = 1; c = 0; break;
255
case ' ': flag_blanksign = 1; c = 0; break;
256
case '#': flag_alternateform = 1; c = 0; break;
257
case '0': flag_zeropad = 1; c = 0; break;
260
}while( c==0 && (c=(*++fmt))!=0 );
261
/* Get the field width */
264
width = va_arg(ap,int);
266
flag_leftjustify = 1;
271
while( c>='0' && c<='9' ){
272
width = width*10 + c - '0';
276
if( width > etBUFSIZE-10 ){
277
width = etBUFSIZE-10;
279
/* Get the precision */
284
precision = va_arg(ap,int);
285
if( precision<0 ) precision = -precision;
288
while( c>='0' && c<='9' ){
289
precision = precision*10 + c - '0';
293
/* Limit the precision to prevent overflowing buf[] during conversion */
294
if( precision>etBUFSIZE-40 ) precision = etBUFSIZE-40;
298
/* Get the conversion type modifier */
305
/* Fetch the info entry for the field */
308
for(idx=0; idx<etNINFO; idx++){
309
if( c==fmtinfo[idx].fmttype ){
310
infop = &fmtinfo[idx];
311
if( useExtended || (infop->flags & FLAG_INTERN)==0 ){
320
** At this point, variables are initialized as follows:
322
** flag_alternateform TRUE if a '#' is present.
323
** flag_plussign TRUE if a '+' is present.
324
** flag_leftjustify TRUE if a '-' is present or if the
325
** field width was negative.
326
** flag_zeropad TRUE if the width began with 0.
327
** flag_long TRUE if the letter 'l' (ell) prefixed
328
** the conversion character.
329
** flag_blanksign TRUE if a ' ' is present.
330
** width The specified field width. This is
331
** always non-negative. Zero is the default.
332
** precision The specified precision. The default
334
** xtype The class of the conversion.
335
** infop Pointer to the appropriate info struct.
339
if( flag_long ) longvalue = va_arg(ap,long);
340
else longvalue = va_arg(ap,int);
342
/* For the format %#x, the value zero is printed "0" not "0x0".
343
** I think this is stupid. */
344
if( longvalue==0 ) flag_alternateform = 0;
346
/* More sensible: turn off the prefix for octal (to prevent "00"),
347
** but leave the prefix for hex. */
348
if( longvalue==0 && infop->base==8 ) flag_alternateform = 0;
350
if( infop->flags & FLAG_SIGNED ){
351
if( *(long*)&longvalue<0 ){
352
longvalue = -*(long*)&longvalue;
354
}else if( flag_plussign ) prefix = '+';
355
else if( flag_blanksign ) prefix = ' ';
358
if( flag_zeropad && precision<width-(prefix!=0) ){
359
precision = width-(prefix!=0);
361
bufpt = &buf[etBUFSIZE-1];
363
register char *cset; /* Use registers for speed */
365
cset = infop->charset;
367
do{ /* Convert to ascii */
368
*(--bufpt) = cset[longvalue%base];
369
longvalue = longvalue/base;
370
}while( longvalue>0 );
372
length = &buf[etBUFSIZE-1]-bufpt;
373
for(idx=precision-length; idx>0; idx--){
374
*(--bufpt) = '0'; /* Zero pad */
376
if( prefix ) *(--bufpt) = prefix; /* Add sign */
377
if( flag_alternateform && infop->prefix ){ /* Add "0" or "0x" */
380
if( *bufpt!=pre[0] ){
381
for(pre=infop->prefix; (x=(*pre))!=0; pre++) *(--bufpt) = x;
384
length = &buf[etBUFSIZE-1]-bufpt;
389
realvalue = va_arg(ap,double);
390
#ifndef etNOFLOATINGPOINT
391
if( precision<0 ) precision = 6; /* Set default precision */
392
if( precision>etBUFSIZE-10 ) precision = etBUFSIZE-10;
394
realvalue = -realvalue;
397
if( flag_plussign ) prefix = '+';
398
else if( flag_blanksign ) prefix = ' ';
401
if( infop->type==etGENERIC && precision>0 ) precision--;
404
/* Rounding works like BSD when the constant 0.4999 is used. Wierd! */
405
for(idx=precision, rounder=0.4999; idx>0; idx--, rounder*=0.1);
407
/* It makes more sense to use 0.5 */
408
for(idx=precision, rounder=0.5; idx>0; idx--, rounder*=0.1);
410
if( infop->type==etFLOAT ) realvalue += rounder;
411
/* Normalize realvalue to within 10.0 > realvalue >= 1.0 */
414
while( realvalue>=1e8 && exp<=350 ){ realvalue *= 1e-8; exp+=8; }
415
while( realvalue>=10.0 && exp<=350 ){ realvalue *= 0.1; exp++; }
416
while( realvalue<1e-8 && exp>=-350 ){ realvalue *= 1e8; exp-=8; }
417
while( realvalue<1.0 && exp>=-350 ){ realvalue *= 10.0; exp--; }
418
if( exp>350 || exp<-350 ){
426
** If the field type is etGENERIC, then convert to either etEXP
427
** or etFLOAT, as appropriate.
429
flag_exp = xtype==etEXP;
430
if( xtype!=etFLOAT ){
431
realvalue += rounder;
432
if( realvalue>=10.0 ){ realvalue *= 0.1; exp++; }
434
if( xtype==etGENERIC ){
435
flag_rtz = !flag_alternateform;
436
if( exp<-4 || exp>precision ){
439
precision = precision - exp;
446
** The "exp+precision" test causes output to be of type etEXP if
447
** the precision is too large to fit in buf[].
450
if( xtype==etFLOAT && exp+precision<etBUFSIZE-30 ){
451
flag_dp = (precision>0 || flag_alternateform);
452
if( prefix ) *(bufpt++) = prefix; /* Sign */
453
if( exp<0 ) *(bufpt++) = '0'; /* Digits before "." */
454
else for(; exp>=0; exp--) *(bufpt++) = et_getdigit(&realvalue,&nsd);
455
if( flag_dp ) *(bufpt++) = '.'; /* The decimal point */
456
for(exp++; exp<0 && precision>0; precision--, exp++){
459
while( (precision--)>0 ) *(bufpt++) = et_getdigit(&realvalue,&nsd);
460
*(bufpt--) = 0; /* Null terminate */
461
if( flag_rtz && flag_dp ){ /* Remove trailing zeros and "." */
462
while( bufpt>=buf && *bufpt=='0' ) *(bufpt--) = 0;
463
if( bufpt>=buf && *bufpt=='.' ) *(bufpt--) = 0;
465
bufpt++; /* point to next free slot */
466
}else{ /* etEXP or etGENERIC */
467
flag_dp = (precision>0 || flag_alternateform);
468
if( prefix ) *(bufpt++) = prefix; /* Sign */
469
*(bufpt++) = et_getdigit(&realvalue,&nsd); /* First digit */
470
if( flag_dp ) *(bufpt++) = '.'; /* Decimal point */
471
while( (precision--)>0 ) *(bufpt++) = et_getdigit(&realvalue,&nsd);
472
bufpt--; /* point to last digit */
473
if( flag_rtz && flag_dp ){ /* Remove tail zeros */
474
while( bufpt>=buf && *bufpt=='0' ) *(bufpt--) = 0;
475
if( bufpt>=buf && *bufpt=='.' ) *(bufpt--) = 0;
477
bufpt++; /* point to next free slot */
478
if( exp || flag_exp ){
479
*(bufpt++) = infop->charset[0];
480
if( exp<0 ){ *(bufpt++) = '-'; exp = -exp; } /* sign of exp */
481
else { *(bufpt++) = '+'; }
483
*(bufpt++) = (exp/100)+'0'; /* 100's digit */
486
*(bufpt++) = exp/10+'0'; /* 10's digit */
487
*(bufpt++) = exp%10+'0'; /* 1's digit */
490
/* The converted number is in buf[] and zero terminated. Output it.
491
** Note that the number is in the usual order, not reversed as with
492
** integer conversions. */
496
/* Special case: Add leading zeros if the flag_zeropad flag is
497
** set and we are not left justified */
498
if( flag_zeropad && !flag_leftjustify && length < width){
500
int nPad = width - length;
501
for(i=width; i>=nPad; i--){
502
bufpt[i] = bufpt[i-nPad];
505
while( nPad-- ) bufpt[i++] = '0';
511
*(va_arg(ap,int*)) = count;
521
c = buf[0] = (xtype==etCHARX ? va_arg(ap,int) : *++fmt);
523
for(idx=1; idx<precision; idx++) buf[idx] = c;
532
bufpt = va_arg(ap,char*);
535
}else if( xtype==etDYNSTRING ){
538
length = strlen(bufpt);
539
if( precision>=0 && precision<length ) length = precision;
544
int i, j, n, c, isnull;
545
char *arg = va_arg(ap,char*);
547
if( isnull ) arg = (xtype==etSQLESCAPE2 ? "NULL" : "(NULL)");
548
for(i=n=0; (c=arg[i])!=0; i++){
551
n += i + 1 + ((!isnull && xtype==etSQLESCAPE2) ? 2 : 0);
553
bufpt = zExtra = sqliteMalloc( n );
554
if( bufpt==0 ) return -1;
559
if( !isnull && xtype==etSQLESCAPE2 ) bufpt[j++] = '\'';
560
for(i=0; (c=arg[i])!=0; i++){
562
if( c=='\'' ) bufpt[j++] = c;
564
if( !isnull && xtype==etSQLESCAPE2 ) bufpt[j++] = '\'';
567
if( precision>=0 && precision<length ) length = precision;
571
Token *pToken = va_arg(ap, Token*);
572
(*func)(arg, pToken->z, pToken->n);
577
SrcList *pSrc = va_arg(ap, SrcList*);
578
int k = va_arg(ap, int);
579
struct SrcList_item *pItem = &pSrc->a[k];
580
assert( k>=0 && k<pSrc->nSrc );
581
if( pItem->zDatabase && pItem->zDatabase[0] ){
582
(*func)(arg, pItem->zDatabase, strlen(pItem->zDatabase));
583
(*func)(arg, ".", 1);
585
(*func)(arg, pItem->zName, strlen(pItem->zName));
594
(*func)(arg,"%",idx);
598
}/* End switch over the format type */
600
** The text of the conversion is pointed to by "bufpt" and is
601
** "length" characters long. The field width is "width". Do
604
if( !flag_leftjustify ){
606
nspace = width-length;
609
while( nspace>=etSPACESIZE ){
610
(*func)(arg,spaces,etSPACESIZE);
611
nspace -= etSPACESIZE;
613
if( nspace>0 ) (*func)(arg,spaces,nspace);
617
(*func)(arg,bufpt,length);
620
if( flag_leftjustify ){
622
nspace = width-length;
625
while( nspace>=etSPACESIZE ){
626
(*func)(arg,spaces,etSPACESIZE);
627
nspace -= etSPACESIZE;
629
if( nspace>0 ) (*func)(arg,spaces,nspace);
635
}/* End for loop over the format string */
636
return errorflag ? -1 : count;
637
} /* End of function */
640
/* This structure is used to store state information about the
641
** write to memory that is currently in progress.
644
char *zBase; /* A base allocation */
645
char *zText; /* The string collected so far */
646
int nChar; /* Length of the string so far */
647
int nTotal; /* Output size if unconstrained */
648
int nAlloc; /* Amount of space allocated in zText */
649
void *(*xRealloc)(void*,int); /* Function used to realloc memory */
653
** This function implements the callback from vxprintf.
655
** This routine add nNewChar characters of text in zNewText to
656
** the sgMprintf structure pointed to by "arg".
658
static void mout(void *arg, const char *zNewText, int nNewChar){
659
struct sgMprintf *pM = (struct sgMprintf*)arg;
660
pM->nTotal += nNewChar;
661
if( pM->nChar + nNewChar + 1 > pM->nAlloc ){
662
if( pM->xRealloc==0 ){
663
nNewChar = pM->nAlloc - pM->nChar - 1;
665
pM->nAlloc = pM->nChar + nNewChar*2 + 1;
666
if( pM->zText==pM->zBase ){
667
pM->zText = pM->xRealloc(0, pM->nAlloc);
668
if( pM->zText && pM->nChar ){
669
memcpy(pM->zText, pM->zBase, pM->nChar);
672
pM->zText = pM->xRealloc(pM->zText, pM->nAlloc);
676
if( pM->zText && nNewChar>0 ){
677
memcpy(&pM->zText[pM->nChar], zNewText, nNewChar);
678
pM->nChar += nNewChar;
679
pM->zText[pM->nChar] = 0;
684
** This routine is a wrapper around xprintf() that invokes mout() as
687
static char *base_vprintf(
688
void *(*xRealloc)(void*,int), /* Routine to realloc memory. May be NULL */
689
int useInternal, /* Use internal %-conversions if true */
690
char *zInitBuf, /* Initially write here, before mallocing */
691
int nInitBuf, /* Size of zInitBuf[] */
692
const char *zFormat, /* format string */
693
va_list ap /* arguments */
696
sM.zBase = sM.zText = zInitBuf;
697
sM.nChar = sM.nTotal = 0;
698
sM.nAlloc = nInitBuf;
699
sM.xRealloc = xRealloc;
700
vxprintf(mout, &sM, useInternal, zFormat, ap);
702
if( sM.zText==sM.zBase ){
703
sM.zText = xRealloc(0, sM.nChar+1);
704
memcpy(sM.zText, sM.zBase, sM.nChar+1);
705
}else if( sM.nAlloc>sM.nChar+10 ){
706
sM.zText = xRealloc(sM.zText, sM.nChar+1);
713
** Realloc that is a real function, not a macro.
715
static void *printf_realloc(void *old, int size){
716
return sqliteRealloc(old,size);
720
** Print into memory obtained from sqliteMalloc(). Use the internal
721
** %-conversion extensions.
723
char *sqliteVMPrintf(const char *zFormat, va_list ap){
725
return base_vprintf(printf_realloc, 1, zBase, sizeof(zBase), zFormat, ap);
729
** Print into memory obtained from sqliteMalloc(). Use the internal
730
** %-conversion extensions.
732
char *sqliteMPrintf(const char *zFormat, ...){
736
va_start(ap, zFormat);
737
z = base_vprintf(printf_realloc, 1, zBase, sizeof(zBase), zFormat, ap);
743
** Print into memory obtained from malloc(). Do not use the internal
744
** %-conversion extensions. This routine is for use by external users.
746
char *sqlite_mprintf(const char *zFormat, ...){
751
va_start(ap,zFormat);
752
z = base_vprintf((void*(*)(void*,int))realloc, 0,
753
zBuf, sizeof(zBuf), zFormat, ap);
758
/* This is the varargs version of sqlite_mprintf.
760
char *sqlite_vmprintf(const char *zFormat, va_list ap){
762
return base_vprintf((void*(*)(void*,int))realloc, 0,
763
zBuf, sizeof(zBuf), zFormat, ap);
767
** sqlite_snprintf() works like snprintf() except that it ignores the
768
** current locale settings. This is important for SQLite because we
769
** are not able to use a "," as the decimal point in place of "." as
770
** specified by some locales.
772
char *sqlite_snprintf(int n, char *zBuf, const char *zFormat, ...){
776
va_start(ap,zFormat);
777
z = base_vprintf(0, 0, zBuf, n, zFormat, ap);
783
** The following four routines implement the varargs versions of the
784
** sqlite_exec() and sqlite_get_table() interfaces. See the sqlite.h
785
** header files for a more detailed description of how these interfaces
788
** These routines are all just simple wrappers.
790
int sqlite_exec_printf(
791
sqlite *db, /* An open database */
792
const char *sqlFormat, /* printf-style format string for the SQL */
793
sqlite_callback xCallback, /* Callback function */
794
void *pArg, /* 1st argument to callback function */
795
char **errmsg, /* Error msg written here */
796
... /* Arguments to the format string. */
801
va_start(ap, errmsg);
802
rc = sqlite_exec_vprintf(db, sqlFormat, xCallback, pArg, errmsg, ap);
806
int sqlite_exec_vprintf(
807
sqlite *db, /* An open database */
808
const char *sqlFormat, /* printf-style format string for the SQL */
809
sqlite_callback xCallback, /* Callback function */
810
void *pArg, /* 1st argument to callback function */
811
char **errmsg, /* Error msg written here */
812
va_list ap /* Arguments to the format string. */
817
zSql = sqlite_vmprintf(sqlFormat, ap);
818
rc = sqlite_exec(db, zSql, xCallback, pArg, errmsg);
822
int sqlite_get_table_printf(
823
sqlite *db, /* An open database */
824
const char *sqlFormat, /* printf-style format string for the SQL */
825
char ***resultp, /* Result written to a char *[] that this points to */
826
int *nrow, /* Number of result rows written here */
827
int *ncol, /* Number of result columns written here */
828
char **errmsg, /* Error msg written here */
829
... /* Arguments to the format string */
834
va_start(ap, errmsg);
835
rc = sqlite_get_table_vprintf(db, sqlFormat, resultp, nrow, ncol, errmsg, ap);
839
int sqlite_get_table_vprintf(
840
sqlite *db, /* An open database */
841
const char *sqlFormat, /* printf-style format string for the SQL */
842
char ***resultp, /* Result written to a char *[] that this points to */
843
int *nrow, /* Number of result rows written here */
844
int *ncolumn, /* Number of result columns written here */
845
char **errmsg, /* Error msg written here */
846
va_list ap /* Arguments to the format string */
851
zSql = sqlite_vmprintf(sqlFormat, ap);
852
rc = sqlite_get_table(db, zSql, resultp, nrow, ncolumn, errmsg);