14#if !defined(PQXX_HEADER_PRE)
15# error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
20#include "pqxx/internal/concat.hxx"
21#include "pqxx/internal/statement_parameters.hxx"
22#include "pqxx/types.hxx"
32class PQXX_LIBEXPORT params
38 template<
typename... Args>
constexpr params(Args &&...args)
40 reserve(
sizeof...(args));
41 append_pack(std::forward<Args>(args)...);
51 void reserve(std::size_t n) &;
55 [[nodiscard]]
auto size() const noexcept {
return m_params.size(); }
79 void append(std::string
const &) &;
82 void append(std::string &&) &;
88 void append(bytes_view) &;
94 void append(bytes
const &) &;
96#if defined(PQXX_HAVE_CONCEPTS)
101 template<binary DATA>
void append(DATA
const &data) &
103 append(bytes_view{std::data(data), std::size(data)});
108 void append(bytes &&) &;
114 void append(binarystring
const &value) &;
117 template<
typename IT,
typename ACCESSOR>
118 void append(pqxx::internal::dynamic_params<IT, ACCESSOR>
const &value) &
120 for (
auto ¶m : value) append(value.access(param));
123 void append(params
const &value) &;
125 void append(params &&value) &;
129 template<
typename TYPE>
void append(TYPE
const &value) &
132 if constexpr (nullness<strip_t<TYPE>>::always_null)
135 m_params.emplace_back();
139 m_params.emplace_back();
143 m_params.emplace_back(entry{to_string(value)});
148 template<PQXX_RANGE_ARG RANGE>
void append_multi(RANGE
const &range) &
150#if defined(PQXX_HAVE_CONCEPTS)
151 if constexpr (std::ranges::sized_range<RANGE>)
152 reserve(std::size(*
this) + std::size(range));
154 for (
auto &value : range) append(value);
167 pqxx::internal::c_params make_c_params()
const;
171 template<
typename Arg,
typename... More>
172 void append_pack(Arg &&arg, More &&...args)
174 this->append(std::forward<Arg>(arg));
176 append_pack(std::forward<More>(args)...);
180 constexpr void append_pack() noexcept {}
186 std::variant<std::nullptr_t, zview, std::string, bytes_view, bytes>;
187 std::vector<entry> m_params;
189 static constexpr std::string_view s_overflow{
190 "Statement parameter length overflow."sv};
205template<
typename COUNTER =
unsigned int>
class placeholders
210 (std::numeric_limits<COUNTER>::max)()};
214 static constexpr auto initial{
"$1\0"sv};
215 initial.copy(std::data(m_buf), std::size(initial));
224 return zview{std::data(m_buf), m_len};
233 std::string
get()
const {
return std::string(std::data(m_buf), m_len); }
240 "Too many parameters in one statement: limit is ",
max_params,
".")};
241 PQXX_ASSUME(m_current > 0);
243 if (m_current % 10 == 0)
248 char *
const data{std::data(m_buf)};
250 data + 1, data + std::size(m_buf), m_current)};
263 COUNTER
count() const noexcept {
return m_current; }
267 COUNTER m_current = 1;
280 std::array<char, std::numeric_limits<COUNTER>::digits10 + 3> m_buf;
290[[deprecated(
"Use the params class instead.")]]
constexpr inline auto
299[[deprecated(
"Use the params class instead.")]]
constexpr inline auto
302 using IT =
typename C::const_iterator;
303#include "pqxx/internal/ignore-deprecated-pre.hxx"
305#include "pqxx/internal/ignore-deprecated-post.hxx"
310template<
typename C,
typename ACCESSOR>
311[[deprecated(
"Use the params class instead.")]]
constexpr inline auto
314 using IT =
decltype(std::begin(container));
315#include "pqxx/internal/ignore-deprecated-pre.hxx"
317#include "pqxx/internal/ignore-deprecated-post.hxx"
Definition statement_parameters.hxx:36
Generate parameter placeholders for use in an SQL statement.
Definition params.hxx:206
static constexpr unsigned int max_params
Maximum number of parameters we support.
Definition params.hxx:209
COUNTER count() const noexcept
Return the current placeholder number. The initial placeholder is 1.
Definition params.hxx:263
std::string get() const
Read the current placeholder text, as a std::string.
Definition params.hxx:233
constexpr zview view() const &noexcept
Read an ephemeral version of the current placeholder text.
Definition params.hxx:222
void next() &
Move on to the next parameter.
Definition params.hxx:236
Marker-type wrapper: zero-terminated std::string_view.
Definition zview.hxx:38
Something is out of range, similar to std::out_of_range.
Definition except.hxx:326
std::string concat(TYPE... item)
Efficiently combine a bunch of items into one big string.
Definition concat.hxx:31
auto ssize(T const &c)
Transitional: std::ssize(), or custom implementation if not available.
Definition util.hxx:555
Definition params.hxx:287
constexpr auto make_dynamic_params(IT begin, IT end)
Definition params.hxx:291
The home of all libpqxx classes, functions, templates, etc.
Definition array.cxx:27
constexpr void ignore_unused(T &&...) noexcept
Suppress compiler warning about an unused item.
Definition util.hxx:144
constexpr bool is_null(TYPE const &value) noexcept
Is value null?
Definition strconv.hxx:515
TO check_cast(FROM value, std::string_view description)
Cast a numeric value to another type, or throw if it underflows/overflows.
Definition util.hxx:153
static char * into_buf(char *begin, char *end, TYPE const &value)
Write value's string representation into buffer at begin.