/usr/include/dballe/db/querybuf.h is in libdballe-dev 7.7-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 93 94 95 96 97 98 99 100 101 102 103 104 105 | /*
* db/querybuf - Buffer used to build SQL queries
*
* Copyright (C) 2005--2013 ARPA-SIM <urpsim@smr.arpa.emr.it>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* Author: Enrico Zini <enrico@enricozini.com>
*/
#ifndef DBA_DB_QUERYBUF_H
#define DBA_DB_QUERYBUF_H
/** @file
* @ingroup db
* Implementation of an efficient string buffer for composing database queries
*/
#include <wreport/varinfo.h>
#include <string>
#include <set>
namespace dballe {
/// 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);
/**
* 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 str
* The string to append
*/
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);
};
} // namespace dballe
#endif
|