/usr/include/dballe/sql/querybuf.h is in libdballe-dev 7.21-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 | /** @file
* Buffer used to build SQL queries
*/
#ifndef DBA_SQL_QUERYBUF_H
#define DBA_SQL_QUERYBUF_H
#include <wreport/varinfo.h>
#include <string>
#include <set>
namespace dballe {
namespace sql {
/// String buffer for composing database queries
struct Querybuf : public std::string
{
bool list_first;
char list_sep[10];
/**
* @param reserve
* Initial preallocated size for the buffer. If this is chosen
* wisely, there is no need to reallocate space while composing the
* query.
*/
Querybuf(size_t reserve = 512);
~Querybuf();
/// Reset the querybuf to contain the empty string
void clear();
/**
* Begin a list of items separated by the given separator. Items are added
* using append_list().
*
* @param sep
* The separator to add between every list item
*/
void start_list(const char* sep);
/**
* Notify the start of a new list item
*/
void start_list_item();
/**
* Append an integer value
*/
void append_int(int val);
/**
* Append a formatted string to the querybuf
*
* @param fmt
* The string to append, which will be formatted in printf style
*/
void appendf(const char* fmt, ...) __attribute__((format(printf, 2, 3)));
/**
* Append a string to the querybuf, as part of a list.
*
* This function will prepend str with the current list separator, unless it is
* the first item added to the list.
*
* @param str
* The string to append
*/
void append_list(const char* str);
/**
* Append a formatted string to the querybuf, as part of a list.
*
* This function will prepend str with the current list separator, unless it is
* the first item added to the list.
*
* @param fmt printf-style format string.
*/
void append_listf(const char* fmt, ...) __attribute__((format(printf, 2, 3)));
/**
* Append a comma-separated list of integer varcodes parsed from a
* varlist=B12101,B12013 query parameter
*/
void append_varlist(const std::string& varlist);
/// Append a comma-separated list of integer varcodes
void append_varlist(const std::set<wreport::Varcode>& varlist);
};
}
}
#endif
|