libpqxx
The C++ client library for PostgreSQL
 
Loading...
Searching...
No Matches
pqxx::string_traits< std::string_view > Struct Reference

String traits for string_view. More...

Static Public Member Functions

static constexpr std::size_t size_buffer (std::string_view const &value) noexcept
 
static char * into_buf (char *begin, char *end, std::string_view const &value)
 
static zview to_buf (char *begin, char *end, std::string_view const &value)
 
static std::string_view from_string (std::string_view)=delete
 Don't convert to this type; it has nowhere to store its contents.
 
static zview to_buf (char *begin, char *end, std::string_view const &value)
 Return a string_view representing value, plus terminating zero.
 
static char * into_buf (char *begin, char *end, std::string_view const &value)
 Write value's string representation into buffer at begin.
 
static std::string_view from_string (std::string_view text)
 Parse a string representation of a TYPE value.
 
static std::size_t size_buffer (std::string_view const &value) noexcept
 Estimate how much buffer space is needed to represent value.
 

Static Public Attributes

static constexpr bool converts_to_string {true}
 
static constexpr bool converts_from_string {false}
 
static constexpr bool converts_to_string
 Is conversion from TYPE to strings supported?
 
static constexpr bool converts_from_string
 Is conversion from string_view to TYPE supported?
 

Detailed Description

String traits for string_view.

Member Function Documentation

◆ from_string()

static std::string_view pqxx::string_traits< std::string_view >::from_string ( std::string_view text)
inlinestaticnodiscard

Parse a string representation of a TYPE value.

Throws conversion_error if value does not meet the expected format for a value of this type.

Warning
A null value has no string representation. Do not parse a null.

◆ size_buffer()

static std::size_t pqxx::string_traits< std::string_view >::size_buffer ( std::string_view const & value)
inlinestaticnodiscardnoexcept

Estimate how much buffer space is needed to represent value.

The estimate may be a little pessimistic, if it saves time.

The estimate includes the terminating zero.

◆ to_buf()

static zview pqxx::string_traits< std::string_view >::to_buf ( char * begin,
char * end,
std::string_view const & value )
inlinestaticnodiscard

Return a string_view representing value, plus terminating zero.

Produces a string_view containing the PostgreSQL string representation for value.

Warning
A null value has no string representation. Do not pass a null.

Uses the space from begin to end as a buffer, if needed. The returned string may lie somewhere in that buffer, or it may be a compile-time constant, or it may be null if value was a null value. Even if the string is stored in the buffer, its begin() may or may not be the same as begin.

The string_view is guaranteed to be valid as long as the buffer from begin to end remains accessible and unmodified.

Exceptions
pqxx::conversion_overrunif the provided buffer space may not be enough. For maximum performance, this is a conservative estimate. It may complain about a buffer which is actually large enough for your value, if an exact check gets too expensive.

Member Data Documentation

◆ converts_from_string

bool pqxx::string_traits< std::string_view >::converts_from_string
staticconstexpr

Is conversion from string_view to TYPE supported?

When defining your own conversions, specialise this as true to indicate that your string traits support from_string.

◆ converts_to_string

bool pqxx::string_traits< std::string_view >::converts_to_string
staticconstexpr

Is conversion from TYPE to strings supported?

When defining your own conversions, specialise this as true to indicate that your string traits support the conversions to strings.


The documentation for this struct was generated from the following file: