libpqxx  7.2.0
pqxx::prepare Namespace Reference

Dedicated namespace for helper types related to prepared statements. More...

Functions

template<typename IT >
constexpr auto make_dynamic_params (IT begin, IT end)
 Pass a number of statement parameters only known at runtime. More...
 
template<typename C >
constexpr auto make_dynamic_params (C const &container)
 Pass a number of statement parameters only known at runtime. More...
 
template<typename C , typename ACCESSOR >
constexpr auto make_dynamic_params (C &container, ACCESSOR accessor)
 Pass a number of statement parameters only known at runtime. More...
 

Detailed Description

Dedicated namespace for helper types related to prepared statements.

Function Documentation

◆ make_dynamic_params() [1/3]

template<typename IT >
constexpr auto pqxx::prepare::make_dynamic_params ( IT  begin,
IT  end 
)

Pass a number of statement parameters only known at runtime.

When you call any of the exec_params functions, the number of arguments is normally known at compile time. This helper function supports the case where it is not.

Use this function to pass a variable number of parameters, based on a sequence ranging from begin to end exclusively.

The technique combines with the regular static parameters. You can use it to insert dynamic parameter lists in any place, or places, among the call's parameters. You can even insert multiple dynamic sequences.

Parameters
beginA pointer or iterator for iterating parameters.
endA pointer or iterator for iterating parameters.
Returns
An object representing the parameters.

◆ make_dynamic_params() [2/3]

template<typename C >
constexpr auto pqxx::prepare::make_dynamic_params ( C const &  container)

Pass a number of statement parameters only known at runtime.

When you call any of the exec_params functions, the number of arguments is normally known at compile time. This helper function supports the case where it is not.

Use this function to pass a variable number of parameters, based on a container of parameter values.

The technique combines with the regular static parameters. You can use it to insert dynamic parameter lists in any place, or places, among the call's parameters. You can even insert multiple dynamic containers.

Parameters
containerA container of parameter values.
Returns
An object representing the parameters.

◆ make_dynamic_params() [3/3]

template<typename C , typename ACCESSOR >
constexpr auto pqxx::prepare::make_dynamic_params ( C &  container,
ACCESSOR  accessor 
)

Pass a number of statement parameters only known at runtime.

When you call any of the exec_params functions, the number of arguments is normally known at compile time. This helper function supports the case where it is not.

Use this function to pass a variable number of parameters, based on a container of parameter values.

The technique combines with the regular static parameters. You can use it to insert dynamic parameter lists in any place, or places, among the call's parameters. You can even insert multiple dynamic containers.

Parameters
containerA container of parameter values.
accessorFor each parameter p, pass accessor(p).
Returns
An object representing the parameters.