--- /srv/reproducible-results/rbuild-debian/r-b-build.ASJhhKkc/b1/libpqxx_7.10.0-1_armhf.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.ASJhhKkc/b2/libpqxx_7.10.0-1_armhf.changes ├── Files │ @@ -1,5 +1,5 @@ │ │ b396cf3ea008ce7f6d70c0616c84bc48 2639436 debug optional libpqxx-7.10-dbgsym_7.10.0-1_armhf.deb │ b68f1841f191e4b67ebbdc8b34c0dbc6 182936 libs optional libpqxx-7.10_7.10.0-1_armhf.deb │ 22dc20d8ba0fd7c7a76ab4e534a2dae6 378816 libdevel optional libpqxx-dev_7.10.0-1_armhf.deb │ - bbd6f2db53a159e688a2dfb1ce913b75 2637332 doc optional libpqxx-doc_7.10.0-1_all.deb │ + b79dd4199ec6c5ca95a48617cab7f784 2639232 doc optional libpqxx-doc_7.10.0-1_all.deb ├── libpqxx-doc_7.10.0-1_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2025-01-07 17:35:40.000000 debian-binary │ │ --rw-r--r-- 0 0 0 32424 2025-01-07 17:35:40.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 2604716 2025-01-07 17:35:40.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 32400 2025-01-07 17:35:40.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 2606640 2025-01-07 17:35:40.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: libpqxx-doc │ │ │ │ Source: libpqxx │ │ │ │ Version: 7.10.0-1 │ │ │ │ Architecture: all │ │ │ │ Maintainer: Debian PostgreSQL team │ │ │ │ -Installed-Size: 13546 │ │ │ │ +Installed-Size: 13597 │ │ │ │ Suggests: libpqxx-dev (>= 7.10.0-1) │ │ │ │ Section: doc │ │ │ │ Priority: optional │ │ │ │ Multi-Arch: foreign │ │ │ │ Homepage: https://github.com/jtv/libpqxx/ │ │ │ │ Description: C++ library to connect to PostgreSQL (documentation) │ │ │ │ C++ library to enable user programs to communicate with │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -57,22 +57,22 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 7476 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 16227 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 678 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 28289 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 125398 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5809 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 29774 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 62524 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 75445 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1037 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 734 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 7752 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator__coll__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 769 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator__inherit__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8763 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator__inherit__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 25117 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 31662 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 37137 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1273 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1052 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11447 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator__coll__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 776 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator__inherit__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8876 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator__inherit__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 21335 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__row__iterator-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 25258 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__row__iterator.html │ │ │ │ @@ -322,18 +322,18 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9532 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 22538 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 643 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 10254 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range__bound-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 14962 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range__bound.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 618 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range__bound.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 21619 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 62809 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 73620 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2802 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19721 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 51358 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 60407 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1893 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 421 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4514 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row__coll__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 753 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row__inherit__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8703 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row__inherit__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 658 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1sql__error__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5836 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1sql__error__coll__graph.png │ │ │ │ @@ -391,15 +391,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9689 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/connection-sql__cursor_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8829 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/connection-stream__from_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8759 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/connection-stream__to_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13910 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/connection-transaction_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 137398 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/connection_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 260956 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/conversions_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 59527 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/cursor_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 36023 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/datatypes.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 36021 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/datatypes.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13989 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dbtransaction_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19653 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/deprecated.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5222 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dir_09456df80b5baeba1147d2b9ef5f002c.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 399 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dir_09456df80b5baeba1147d2b9ef5f002c_dep.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1857 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dir_09456df80b5baeba1147d2b9ef5f002c_dep.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11101 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dir_3abbb4e2076021b5d2239498be5fcb30.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1544 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dir_3abbb4e2076021b5d2239498be5fcb30.js │ │ │ │ @@ -422,15 +422,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 45631 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/doxygen.css │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15461 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/doxygen.svg │ │ │ │ -rw-r--r-- 0 root (0) root (0) 7704 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/dynsections.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11901 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/encoding__group_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 137795 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/encodings_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8209 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/errorhandler-connection_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 18589 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/errorhandler_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 10024 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/escaping.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 10026 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/escaping.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 144139 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/except_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 85079 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/field_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 25190 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/files.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 223 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/files_dup.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1996 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/folderclosed.svg │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1996 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/folderclosedd.svg │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3269 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/folderopen.svg │ │ │ │ @@ -855,42 +855,42 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9364 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/prepared__statement_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 101844 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/range_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5685 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/resize.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8660 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-connection_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11425 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-creation_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8756 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-pipeline_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8591 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-sql__cursor_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 63743 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 29407 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iter_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 62185 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iterator_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 67049 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 31512 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iter_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 65381 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iterator_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19467 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/robusttransaction_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 91997 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/row_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 98297 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/row_8hxx_source.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 7545 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_0.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4729 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_1.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6978 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_10.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 21501 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 7532 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 2857 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_13.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 21567 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 7531 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 2858 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_13.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 906 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_14.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1394 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_15.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 94 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_16.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1207 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_17.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 319 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_18.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15544 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_2.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4603 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_3.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 9409 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_4.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 7171 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_5.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 9410 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_4.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 7172 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_5.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5455 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_6.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1038 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_7.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 5821 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 5822 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 147 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_9.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2895 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_a.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1394 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_b.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 9602 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 9517 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9162 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_d.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6432 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_e.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4663 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_f.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 875 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_0.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1086 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_1.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 975 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_10.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 835 2025-01-07 17:35:40.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_11.js │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1basic__ilostream.html │ │ │ │ @@ -151,15 +151,15 @@ │ │ │ │  basic_ilostream (dbtransaction &t, oid o, largeobject::size_type buf_size=512) │ │ │ │  Create a basic_ilostream.
│ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │
template<typename CHAR = char, typename TRAITS = std::char_traits<CHAR>>
│ │ │ │ class pqxx::basic_ilostream< CHAR, TRAITS >

Input stream that gets its data from a large object.

│ │ │ │ -
Deprecated:
Access large objects directly using the blob class.
│ │ │ │ +
Deprecated:
Access large objects directly using the blob class.
│ │ │ │

This class worked like any other istream, but to read data from a large object. It supported all formatting and streaming operations of std::istream.

│ │ │ │

This functionality was considered too fragile and complex, so it has been replaced with a single, much simpler class.

│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ basic_ilostream() [1/2]

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1basic__lostream.html │ │ │ │ @@ -151,15 +151,15 @@ │ │ │ │  basic_lostream (dbtransaction &t, oid o, largeobject::size_type buf_size=512) │ │ │ │  Create a basic_lostream.
│ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │
template<typename CHAR = char, typename TRAITS = std::char_traits<CHAR>>
│ │ │ │ class pqxx::basic_lostream< CHAR, TRAITS >

Stream that reads and writes a large object.

│ │ │ │ -
Deprecated:
Access large objects directly using the blob class.
│ │ │ │ +
Deprecated:
Access large objects directly using the blob class.
│ │ │ │

This worked like a std::iostream, but to read data from, or write data to, a large object. It supported all formatting and streaming operations of std::iostream.

│ │ │ │

This functionality was considered too fragile and complex, so it has been replaced with a single, much simpler class.

│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ basic_lostream() [1/2]

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1basic__olostream.html │ │ │ │ @@ -151,15 +151,15 @@ │ │ │ │  basic_olostream (dbtransaction &t, oid o, largeobject::size_type buf_size=512) │ │ │ │  Create a basic_olostream.
│ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │
template<typename CHAR = char, typename TRAITS = std::char_traits<CHAR>>
│ │ │ │ class pqxx::basic_olostream< CHAR, TRAITS >

Output stream that writes data back to a large object.

│ │ │ │ -
Deprecated:
Access large objects directly using the blob class.
│ │ │ │ +
Deprecated:
Access large objects directly using the blob class.
│ │ │ │

This worked like any other ostream, but to write data to a large object. It supported all formatting and streaming operations of std::ostream.

│ │ │ │

This functionality was considered too fragile and complex, so it has been replaced with a single, much simpler class.

│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ basic_olostream() [1/2]

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection.html │ │ │ │ @@ -379,31 +379,31 @@ │ │ │ │   │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.html │ │ │ │ @@ -128,298 +128,298 @@ │ │ │ │ │ │ │ │ │ │ │ │
[legend]
│ │ │ │

Notifications and Receivers

This is PostgreSQL-specific extension that goes beyond standard SQL. It's a communications mechanism between clients on a database, akin to a transactional message bus.

│ │ │ │

A notification happens on a channel, identified by a name. You can set a connection to listen for notifications on the channel, using the connection's listen() function. (Internally this will issue a LISTEN SQL command). Any client on the database can send a notification on that channel by executing a NOTIFY SQL command. The transaction classes implement a convenience function for this, called transaction_base::notify().

│ │ │ │

Notifications can carry an optional payload string. This is free-form text which carries additional information to the receiver.

│ │ │ │
Warning
There are a few pitfalls with the channel names: case sensitivity and encodings. They are not too hard to avoid, but the safest thing to do is use only lower-case ASCII names.
│ │ │ │ -

│ │ │ │ +

│ │ │ │ Case sensitivity

│ │ │ │

Channel names are case-sensitive. By default, however, PostgreSQL does convert the channel name in a NOTIFY or LISTEN command to lower-case, to give the impression that it is not case-sensitive while keeping the performance cost low.

│ │ │ │

Thus, a LISTEN Hello will pick up a notification from NOTIFY Hello but also one from NOTIFY hello, because the database converts Hello into hello going in either direction.

│ │ │ │

You can prevent this conversion by putting the name in double quotes, as quote_name() does. This is what libpqxx's notification functions do. If you use libpqxx to lisen on Hello but raw SQL to notify Hello, the notification will not arrive because the notification actually uses the string hello instead.

│ │ │ │

Confused? Safest thing to do is to use only lower-case letters in the channel names!

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Transactions

│ │ │ │

Both listening and notifying are transactional in the backend: they only take effect once the back-end transaction in which you do them is committed.

│ │ │ │

For an outgoing notification, this means that the transaction holds on to the outgoing message until you commit. (A nontransaction does not start a backend transaction, so if that's the transaction type you're using, the message does go out immediately.)

│ │ │ │

For listening to incoming notifications, it gets a bit more complicated. To avoid complicating its internal bookkeeping, libpqxx only lets you start listening while no transaction is open.

│ │ │ │

No notifications will come in while you're in a transaction... again unless it's a nontransaction of course, because that does not open a transaction on the backend.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Exceptions

│ │ │ │

If your handler throws an exception, that will simply propagate up the call chain to wherever you were when you received it.

│ │ │ │

This is differnt from the old notification_receiver mechanism which logged exceptions but did not propagate them.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Encoding

│ │ │ │

When a client sends a notification, it does so in its client encoding. If necessary, the back-end converts them to its internal encoding. And then when a client receives the notification, the database converts it to the receiver's client encoding.

│ │ │ │

Simple enough, right?

│ │ │ │

However if you should change your connection's client encoding after you start listening on a channel, then any notifications you receive may have different channel names than the ones for which you are listening.

│ │ │ │

If this could be a problem in your scenario, stick to names in pure ASCII. Those will look the same in all the encodings postgres supports.

│ │ │ │
using notification_handler = std::function< void(notification)>
│ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │

│ │ │ │ Public Types

│ │ │ │ -using iterator_category = std::bidirectional_iterator_tag
iterator_category = std::bidirectional_iterator_tag
 
│ │ │ │ -using value_type = row const
value_type = row const
 
│ │ │ │ -using pointer = row const *
pointer = row const *
 
│ │ │ │ -using reference = row
reference = row
 
│ │ │ │ -using size_type = result_size_type
size_type = result_size_type
 
│ │ │ │ -using difference_type = result_difference_type
difference_type = result_difference_type
 
- Public Types inherited from pqxx::row
│ │ │ │ -using size_type = row_size_type
size_type = row_size_type
 
│ │ │ │ -using difference_type = row_difference_type
difference_type = row_difference_type
 
│ │ │ │ -using const_iterator = const_row_iterator
const_iterator = const_row_iterator
 
│ │ │ │ -using iterator = const_iterator
iterator = const_iterator
 
│ │ │ │ -using reference = field
reference = field
 
│ │ │ │ -using pointer = const_row_iterator
pointer = const_row_iterator
 
│ │ │ │ -using const_reverse_iterator = const_reverse_row_iterator
const_reverse_iterator = const_reverse_row_iterator
 
│ │ │ │ -using reverse_iterator = const_reverse_iterator
reverse_iterator = const_reverse_iterator
 
│ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +pointer  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ +row &  │ │ │ │ │ │ │ │ │ │ │ │ +row &  │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +constexpr size_type  │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │

│ │ │ │ Public Member Functions

│ │ │ │ - const_result_iterator () noexcept=default
const_result_iterator () noexcept=default
 Create an iterator, but in an unusable state.
 
│ │ │ │ - const_result_iterator (const_result_iterator const &) noexcept=default
const_result_iterator (const_result_iterator const &) noexcept=default
 Copy an iterator.
 
│ │ │ │ - const_result_iterator (const_result_iterator &&) noexcept=default
const_result_iterator (const_result_iterator &&) noexcept=default
 Move an iterator.
 
│ │ │ │ - const_result_iterator (row const &t) noexcept
const_result_iterator (row const &t) noexcept
 Begin iterating a row.
 
Dereferencing operators

An iterator "points to" its own row, which is also itself. This makes it easy to address a pqxx::result as a two-dimensional container, without going through the intermediate step of dereferencing the iterator. It makes the interface similar to C pointer/array semantics.

│ │ │ │

IIRC Alex Stepanov, the inventor of the STL, once remarked that having this as standard behaviour for pointers would be useful in some algorithms. So even if this makes me look foolish, I would seem to be in distinguished company.

│ │ │ │
│ │ │ │ -pointer operator-> () const
operator-> () const
 Dereference the iterator.
 
│ │ │ │ -reference operator* () const
operator* () const
 Dereference the iterator.
 
Manipulations
│ │ │ │ -const_result_iterator & operator= (const_result_iterator const &rhs)
operator= (const_result_iterator const &rhs)
 
│ │ │ │ -const_result_iterator & operator= (const_result_iterator &&rhs)
operator= (const_result_iterator &&rhs)
 
│ │ │ │ -const_result_iterator operator++ (int) &
operator++ (int) &
 
│ │ │ │ const_result_iterator & operator++ ()
 
│ │ │ │ -const_result_iterator operator-- (int) &
operator-- (int) &
 
│ │ │ │ const_result_iterator & operator-- ()
 
│ │ │ │ -const_result_iterator & operator+= (difference_type i)
operator+= (difference_type i)
 
│ │ │ │ -const_result_iterator & operator-= (difference_type i)
operator-= (difference_type i)
 
│ │ │ │ -void swap (const_result_iterator &other) noexcept
swap (const_result_iterator &other) noexcept
 Interchange two iterators in an exception-safe manner.
 
Comparisons
│ │ │ │ -bool operator== (const_result_iterator const &i) const
operator== (const_result_iterator const &i) const
 
│ │ │ │ -bool operator!= (const_result_iterator const &i) const
operator!= (const_result_iterator const &i) const
 
│ │ │ │ -bool operator< (const_result_iterator const &i) const
operator< (const_result_iterator const &i) const
 
│ │ │ │ -bool operator<= (const_result_iterator const &i) const
operator<= (const_result_iterator const &i) const
 
│ │ │ │ -bool operator> (const_result_iterator const &i) const
operator> (const_result_iterator const &i) const
 
│ │ │ │ -bool operator>= (const_result_iterator const &i) const
operator>= (const_result_iterator const &i) const
 
Field access
│ │ │ │ -reference back () const noexcept
back () const noexcept
 
│ │ │ │ -reference front () const noexcept
front () const noexcept
 
│ │ │ │ -reference at (size_type) const
at (size_type) const
 
reference at (zview col_name) const
reference at (zview col_name) const
 
│ │ │ │ -constexpr result::size_type rownumber () const noexcept
rownumber () const noexcept
 Row number, assuming this is a real row and not end()/rend().
 
- Public Member Functions inherited from pqxx::row
│ │ │ │ - row (row &&) noexcept=default
row (row &&) noexcept=default
 
│ │ │ │ - row (row const &) noexcept=default
row (row const &) noexcept=default
 
│ │ │ │ -row & operator= (row const &) noexcept=default
operator= (row const &) noexcept=default
 
│ │ │ │ -row & operator= (row &&) noexcept=default
operator= (row &&) noexcept=default
 
│ │ │ │ -PQXX_PURE bool operator== (row const &) const noexcept
operator== (row const &) const noexcept
 
│ │ │ │ -bool operator!= (row const &rhs) const noexcept
operator!= (row const &rhs) const noexcept
 
│ │ │ │ -const_iterator begin () const noexcept
begin () const noexcept
 
│ │ │ │ -const_iterator cbegin () const noexcept
cbegin () const noexcept
 
│ │ │ │ -const_iterator end () const noexcept
end () const noexcept
 
│ │ │ │ -const_iterator cend () const noexcept
cend () const noexcept
 
│ │ │ │ -reference front () const noexcept
front () const noexcept
 
│ │ │ │ -reference back () const noexcept
back () const noexcept
 
│ │ │ │ -const_reverse_row_iterator rbegin () const noexcept
rbegin () const noexcept
 
│ │ │ │ -const_reverse_row_iterator crbegin () const noexcept
crbegin () const noexcept
 
│ │ │ │ -const_reverse_row_iterator rend () const noexcept
rend () const noexcept
 
│ │ │ │ -const_reverse_row_iterator crend () const noexcept
crend () const noexcept
 
│ │ │ │ -reference operator[] (size_type) const noexcept
operator[] (size_type) const noexcept
 
reference operator[] (zview col_name) const
reference operator[] (zview col_name) const
 
│ │ │ │ -reference at (size_type) const
at (size_type) const
 
reference at (zview col_name) const
reference at (zview col_name) const
 
│ │ │ │ -constexpr size_type size () const noexcept
size () const noexcept
 
│ │ │ │ -constexpr result::size_type rownumber () const noexcept
rownumber () const noexcept
 Row number, assuming this is a real row and not end()/rend().
 
│ │ │ │ -size_type column_number (zview col_name) const
column_number (zview col_name) const
 Number of given column (throws exception if it doesn't exist).
 
│ │ │ │ -oid column_type (size_type) const
column_type (size_type) const
 Return a column's type.
 
│ │ │ │ -oid column_type (zview col_name) const
column_type (zview col_name) const
 Return a column's type.
 
│ │ │ │ -oid column_table (size_type col_num) const
column_table (size_type col_num) const
 What table did this column come from?
 
│ │ │ │ -oid column_table (zview col_name) const
column_table (zview col_name) const
 What table did this column come from?
 
size_type table_column (size_type) const
size_type table_column (size_type) const
 What column number in its table did this result column come from?
 
│ │ │ │ -size_type table_column (zview col_name) const
table_column (zview col_name) const
 What column number in its table did this result column come from?
 
│ │ │ │ -constexpr result::size_type num () const noexcept
num () const noexcept
 
template<typename Tuple >
void to (Tuple &t) const
template<typename Tuple >
void to (Tuple &t) const
 Extract entire row's values into a tuple.
 
template<typename... TYPE>
std::tuple< TYPE... > as () const
std::tuple< TYPE... > as () const
 Extract entire row's values into a tuple.
 
│ │ │ │ -void swap (row &) noexcept
swap (row &) noexcept
 
row slice (size_type sbegin, size_type send) const
row slice (size_type sbegin, size_type send) const
 
│ │ │ │ -PQXX_PURE bool empty () const noexcept
empty () const noexcept
 Is this a row without fields? Can only happen to a slice.
 
│ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +difference_type  │ │ │ │ │ │ │ │

Arithmetic operators

│ │ │ │ -class pqxx::result
pqxx::result
 
│ │ │ │ -const_result_iterator operator+ (difference_type, const_result_iterator const &)
operator+ (difference_type, const_result_iterator const &)
 
│ │ │ │ -const_result_iterator operator+ (difference_type) const
operator+ (difference_type) const
 
│ │ │ │ -const_result_iterator operator- (difference_type) const
operator- (difference_type) const
 
│ │ │ │ -difference_type operator- (const_result_iterator const &) const
operator- (const_result_iterator const &) const
 
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ +template<typenameTuple > │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -9,234 +9,234 @@ │ │ │ │ │ [+]Inheritance diagram for pqxx::const_result_iterator: │ │ │ │ │ [Inheritance graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ [+]Collaboration diagram for pqxx::const_result_iterator: │ │ │ │ │ [Collaboration graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ PPuubblliicc TTyyppeess │ │ │ │ │ -using  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │   │ │ │ │ │ -using  vvaalluuee__ttyyppee = _r_o_w const │ │ │ │ │ +_u_s_i_n_g  vvaalluuee__ttyyppee = _r_o_w _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -using  ppooiinntteerr = _r_o_w const * │ │ │ │ │ +_u_s_i_n_g  ppooiinntteerr = _r_o_w _c_o_n_s_t * │ │ │ │ │   │ │ │ │ │ -using  rreeffeerreennccee = _r_o_w │ │ │ │ │ +_u_s_i_n_g  rreeffeerreennccee = _r_o_w │ │ │ │ │   │ │ │ │ │ -using  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ [-] Public Types inherited from _p_q_x_x_:_:_r_o_w │ │ │ │ │ -using  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │ +_u_s_i_n_g  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │   │ │ │ │ │ -using  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   ccoonnsstt__rreessuulltt__iitteerraattoorr () noexcept=default │ │ │ │ │ +   ccoonnsstt__rreessuulltt__iitteerraattoorr () _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   Create an iterator, but in an unusable state. │ │ │ │ │   │ │ │ │ │ -   ccoonnsstt__rreessuulltt__iitteerraattoorr (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &) noexcept=default │ │ │ │ │ +   ccoonnsstt__rreessuulltt__iitteerraattoorr (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   Copy an iterator. │ │ │ │ │   │ │ │ │ │   ccoonnsstt__rreessuulltt__iitteerraattoorr (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&) │ │ │ │ │ - noexcept=default │ │ │ │ │ + _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   Move an iterator. │ │ │ │ │   │ │ │ │ │ -   ccoonnsstt__rreessuulltt__iitteerraattoorr (_r_o_w const &t) noexcept │ │ │ │ │ +   ccoonnsstt__rreessuulltt__iitteerraattoorr (_r_o_w _c_o_n_s_t &_t) _n_o_e_x_c_e_p_t │ │ │ │ │   Begin iterating a _r_o_w. │ │ │ │ │   │ │ │ │ │ Dereferencing operators │ │ │ │ │ An iterator "points to" its own row, which is also itself. This makes it easy │ │ │ │ │ to address a _p_q_x_x_:_:_r_e_s_u_l_t as a two-dimensional container, without going through │ │ │ │ │ the intermediate step of dereferencing the iterator. It makes the interface │ │ │ │ │ similar to C pointer/array semantics. │ │ │ │ │ IIRC Alex Stepanov, the inventor of the STL, once remarked that having this as │ │ │ │ │ standard behaviour for pointers would be useful in some algorithms. So even if │ │ │ │ │ this makes me look foolish, I would seem to be in distinguished company. │ │ │ │ │ - pointer  ooppeerraattoorr-->> () const │ │ │ │ │ + _p_o_i_n_t_e_r  ooppeerraattoorr-->> () _c_o_n_s_t │ │ │ │ │   Dereference the iterator. │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () _c_o_n_s_t │ │ │ │ │   Dereference the iterator. │ │ │ │ │   │ │ │ │ │ Manipulations │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &rhs) │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_r_h_s) │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&rhs) │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&_r_h_s) │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++++ (int) & │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++++ (_i_n_t) & │ │ │ │ │   │ │ │ │ │ _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++++ () │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr---- (int) & │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr---- (_i_n_t) & │ │ │ │ │   │ │ │ │ │ _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr---- () │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++== (difference_type i) │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++== (difference_type _i) │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr--== (difference_type i) │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr--== (difference_type _i) │ │ │ │ │   │ │ │ │ │ - void  sswwaapp (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &other) noexcept │ │ │ │ │ + _v_o_i_d  sswwaapp (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &_o_t_h_e_r) _n_o_e_x_c_e_p_t │ │ │ │ │   Interchange two iterators in an exception-safe │ │ │ │ │ manner. │ │ │ │ │   │ │ │ │ │ Comparisons │ │ │ │ │ - bool  ooppeerraattoorr==== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr==== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr!!== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr!!== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr<< (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr<< (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr<<== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr<<== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr>> (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr>> (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr>>== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr>>== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  bbaacckk () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  bbaacckk () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ffrroonntt () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ffrroonntt () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  aatt (size_type) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  aatt (size_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │ +_c_o_n_s_t_e_x_p_r result::size_type  rroowwnnuummbbeerr () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Row number, assuming this is a real row and not │ │ │ │ │ end()/rend(). │ │ │ │ │   │ │ │ │ │ [-] Public Member Functions inherited from _p_q_x_x_:_:_r_o_w │ │ │ │ │ -   rrooww (_r_o_w &&) noexcept=default │ │ │ │ │ +   rrooww (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ -   rrooww (_r_o_w const &) noexcept=default │ │ │ │ │ +   rrooww (_r_o_w _c_o_n_s_t &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w const &) noexcept=default │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w _c_o_n_s_t &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w &&) noexcept=default │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - PQXX_PURE bool  ooppeerraattoorr==== (_r_o_w const &) const noexcept │ │ │ │ │ + PQXX_PURE _b_o_o_l  ooppeerraattoorr==== (_r_o_w _c_o_n_s_t &) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr!!== (_r_o_w const &rhs) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr!!== (_r_o_w _c_o_n_s_t &_r_h_s) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ffrroonntt () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ffrroonntt () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  bbaacckk () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  bbaacckk () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rrbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rrbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rreenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rreenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrreenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrreenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr[[]] (size_type) const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr[[]] (size_type) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _o_p_e_r_a_t_o_r_[_] (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _o_p_e_r_a_t_o_r_[_] (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  aatt (size_type) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  aatt (size_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - constexpr size_type  ssiizzee () const noexcept │ │ │ │ │ + _c_o_n_s_t_e_x_p_r size_type  ssiizzee () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ -constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │ +_c_o_n_s_t_e_x_p_r result::size_type  rroowwnnuummbbeerr () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Row number, assuming this is a real row and not │ │ │ │ │ end()/rend(). │ │ │ │ │   │ │ │ │ │ - size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w col_name) const │ │ │ │ │ + size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (size_type) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (size_type) _c_o_n_s_t │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (size_type col_num) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (size_type _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) const │ │ │ │ │ + size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) _c_o_n_s_t │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ - size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │ + size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ -constexpr result::size_type  nnuumm () const noexcept │ │ │ │ │ +_c_o_n_s_t_e_x_p_r result::size_type  nnuumm () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - void  _t_o (Tuple &t) const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_u_p_l_e > │ │ │ │ │ + _v_o_i_d  _t_o (_T_u_p_l_e &_t) _c_o_n_s_t │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - std::tuple< TYPE... >  _a_s () const │ │ │ │ │ + std::tuple< TYPE... >  _a_s () _c_o_n_s_t │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ - void  sswwaapp (_r_o_w &) noexcept │ │ │ │ │ + _v_o_i_d  sswwaapp (_r_o_w &) _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_o_w  _s_l_i_c_e (size_type sbegin, size_type send) const │ │ │ │ │ + _r_o_w  _s_l_i_c_e (size_type _s_b_e_g_i_n, size_type _s_e_n_d) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │ + PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Is this a row without fields? Can only happen to a │ │ │ │ │ slice. │ │ │ │ │   │ │ │ │ │ ********** AArriitthhmmeettiicc ooppeerraattoorrss ********** │ │ │ │ │ - class  ppqqxxxx::::rreessuulltt │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::rreessuulltt │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type, _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ +_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type, _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ &) │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type) const │ │ │ │ │ +_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type) const │ │ │ │ │ +_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) const │ │ │ │ │ + difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ AAddddiittiioonnaall IInnhheerriitteedd MMeemmbbeerrss │ │ │ │ │ [-] Protected Member Functions inherited from _p_q_x_x_:_:_r_o_w │ │ │ │ │ -   _r_o_w (_r_e_s_u_l_t r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e index, size_type cols) │ │ │ │ │ - noexcept │ │ │ │ │ +   _r_o_w (_r_e_s_u_l_t _r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e index, size_type _c_o_l_s) │ │ │ │ │ + _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - void  cchheecckk__ssiizzee (size_type expected) const │ │ │ │ │ + _v_o_i_d  cchheecckk__ssiizzee (size_type _e_x_p_e_c_t_e_d) _c_o_n_s_t │ │ │ │ │   Throw _u_s_a_g_e___e_r_r_o_r if row size is not expected. │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - TUPLE  _a_s___t_u_p_l_e () const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_U_P_L_E > │ │ │ │ │ + _T_U_P_L_E  _a_s___t_u_p_l_e () _c_o_n_s_t │ │ │ │ │   Convert to a given tuple of values, don't check sizes. │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - void  ccoonnvveerrtt (Tuple &t) const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_u_p_l_e > │ │ │ │ │ + _v_o_i_d  ccoonnvveerrtt (_T_u_p_l_e &_t) _c_o_n_s_t │ │ │ │ │   Convert entire row to tuple fields, without checking row │ │ │ │ │ size. │ │ │ │ │   │ │ │ │ │ [-] Protected Attributes inherited from _p_q_x_x_:_:_r_o_w │ │ │ │ │ _r_e_s_u_l_t  mm__rreessuulltt │ │ │ │ │   Result set of which this is one row. │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator.html │ │ │ │ @@ -130,141 +130,141 @@ │ │ │ │ │ │ │ │ │ │ │ │
[legend]
│ │ │ │

│ │ │ │ Additional Inherited Members

- Protected Member Functions inherited from pqxx::row
 row (result r, result_size_type index, size_type cols) noexcept
 row (result r, result_size_type index, size_type cols) noexcept
 
│ │ │ │ -void check_size (size_type expected) const
check_size (size_type expected) const
 Throw usage_error if row size is not expected.
 
template<typename TUPLE >
TUPLE as_tuple () const
template<typename TUPLE >
TUPLE as_tuple () const
 Convert to a given tuple of values, don't check sizes.
 
│ │ │ │ -template<typename Tuple >
void convert (Tuple &t) const
void convert (Tuple &t) const
 Convert entire row to tuple fields, without checking row size.
 
- Protected Attributes inherited from pqxx::row
│ │ │ │ result m_result
 Result set of which this is one row.
 
│ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │

│ │ │ │ Public Types

│ │ │ │ -using super = const_result_iterator
super = const_result_iterator
 
│ │ │ │ -using iterator_type = const_result_iterator
iterator_type = const_result_iterator
 
│ │ │ │ -using value_type = iterator_type::value_type
value_type = iterator_type::value_type
 
│ │ │ │ -using reference = iterator_type::reference
reference = iterator_type::reference
 
│ │ │ │ -using difference_type = result_difference_type
difference_type = result_difference_type
 
│ │ │ │ -using iterator_category = std::bidirectional_iterator_tag
iterator_category = std::bidirectional_iterator_tag
 
│ │ │ │ -using pointer = row const *
pointer = row const *
 
│ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator &  │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +difference_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_result_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +difference_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ │ │ │ │

│ │ │ │ Public Member Functions

│ │ │ │ - const_reverse_result_iterator ()=default
const_reverse_result_iterator ()=default
 Create an iterator, but in an unusable state.
 
│ │ │ │ - const_reverse_result_iterator (const_reverse_result_iterator const &rhs)=default
const_reverse_result_iterator (const_reverse_result_iterator const &rhs)=default
 Copy an iterator.
 
│ │ │ │ - const_reverse_result_iterator (const_result_iterator const &rhs)
const_reverse_result_iterator (const_result_iterator const &rhs)
 Copy a reverse iterator from a regular iterator.
 
│ │ │ │ - const_reverse_result_iterator (const_result_iterator const &&rhs)
const_reverse_result_iterator (const_result_iterator const &&rhs)
 Move a regular iterator into a reverse iterator.
 
│ │ │ │ -PQXX_PURE const_result_iterator base () const noexcept
base () const noexcept
 Return the underlying "regular" iterator (as per standard library).
 
Manipulations
│ │ │ │ -const_reverse_result_iterator & operator= (const_reverse_result_iterator const &r)
operator= (const_reverse_result_iterator const &r)
 
│ │ │ │ -const_reverse_result_iterator & operator= (const_reverse_result_iterator &&r)
operator= (const_reverse_result_iterator &&r)
 
│ │ │ │ const_reverse_result_iterator & operator++ ()
 
│ │ │ │ -const_reverse_result_iterator operator++ (int) &
operator++ (int) &
 
│ │ │ │ const_reverse_result_iterator & operator-- ()
 
│ │ │ │ -const_reverse_result_iterator operator-- (int) &
operator-- (int) &
 
│ │ │ │ -const_reverse_result_iterator & operator+= (difference_type i)
operator+= (difference_type i)
 
│ │ │ │ -const_reverse_result_iterator & operator-= (difference_type i)
operator-= (difference_type i)
 
│ │ │ │ -void swap (const_reverse_result_iterator &other) noexcept
swap (const_reverse_result_iterator &other) noexcept
 
Arithmetic operators
│ │ │ │ -const_reverse_result_iterator operator+ (difference_type i) const
operator+ (difference_type i) const
 
│ │ │ │ -const_reverse_result_iterator operator- (difference_type i)
operator- (difference_type i)
 
│ │ │ │ -difference_type operator- (const_reverse_result_iterator const &rhs) const
operator- (const_reverse_result_iterator const &rhs) const
 
Comparisons
│ │ │ │ -bool operator== (const_reverse_result_iterator const &rhs) const noexcept
operator== (const_reverse_result_iterator const &rhs) const noexcept
 
│ │ │ │ -bool operator!= (const_reverse_result_iterator const &rhs) const noexcept
operator!= (const_reverse_result_iterator const &rhs) const noexcept
 
│ │ │ │ -bool operator< (const_reverse_result_iterator const &rhs) const
operator< (const_reverse_result_iterator const &rhs) const
 
│ │ │ │ -bool operator<= (const_reverse_result_iterator const &rhs) const
operator<= (const_reverse_result_iterator const &rhs) const
 
│ │ │ │ -bool operator> (const_reverse_result_iterator const &rhs) const
operator> (const_reverse_result_iterator const &rhs) const
 
│ │ │ │ -bool operator>= (const_reverse_result_iterator const &rhs) const
operator>= (const_reverse_result_iterator const &rhs) const
 
Dereferencing operators
│ │ │ │ -const_result_iterator operator- (difference_type) const
operator- (difference_type) const
 Dereference iterator.
 
│ │ │ │ -difference_type operator- (const_result_iterator const &) const
operator- (const_result_iterator const &) const
 Dereference iterator.
 
│ │ │ │ -reference operator* () const
operator* () const
 Dereference iterator.
 
Field access
│ │ │ │ -reference back () const noexcept
back () const noexcept
 
│ │ │ │ -reference front () const noexcept
front () const noexcept
 
│ │ │ │ -reference at (size_type) const
at (size_type) const
 
reference at (zview col_name) const
reference at (zview col_name) const
 
│ │ │ │ -constexpr result::size_type rownumber () const noexcept
rownumber () const noexcept
 Row number, assuming this is a real row and not end()/rend().
 
│ │ │ │

Detailed Description

│ │ │ │

Reverse iterator for result. Use as result::const_reverse_iterator.

│ │ │ │

Member Function Documentation

│ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -9,120 +9,120 @@ │ │ │ │ │ [+]Inheritance diagram for pqxx::const_reverse_result_iterator: │ │ │ │ │ [Inheritance graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ [+]Collaboration diagram for pqxx::const_reverse_result_iterator: │ │ │ │ │ [Collaboration graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ PPuubblliicc TTyyppeess │ │ │ │ │ -using  ssuuppeerr = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ssuuppeerr = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  iitteerraattoorr__ttyyppee = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr__ttyyppee = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  vvaalluuee__ttyyppee = iterator_type::value_type │ │ │ │ │ +_u_s_i_n_g  vvaalluuee__ttyyppee = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_v_a_l_u_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  rreeffeerreennccee = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_r_e_f_e_r_e_n_c_e │ │ │ │ │ +_u_s_i_n_g  rreeffeerreennccee = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_r_e_f_e_r_e_n_c_e │ │ │ │ │   │ │ │ │ │ -using  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │   │ │ │ │ │ -using  ppooiinntteerr = _r_o_w const * │ │ │ │ │ +_u_s_i_n_g  ppooiinntteerr = _r_o_w _c_o_n_s_t * │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr ()=default │ │ │ │ │ +   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr ()=_d_e_f_a_u_l_t │ │ │ │ │   Create an iterator, but in an unusable state. │ │ │ │ │   │ │ │ │ │   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr │ │ │ │ │ - (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &rhs)=default │ │ │ │ │ + (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &_r_h_s)=_d_e_f_a_u_l_t │ │ │ │ │   Copy an iterator. │ │ │ │ │   │ │ │ │ │   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr │ │ │ │ │ - (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &rhs) │ │ │ │ │ + (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &_r_h_s) │ │ │ │ │   Copy a reverse iterator from a regular │ │ │ │ │ iterator. │ │ │ │ │   │ │ │ │ │   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr │ │ │ │ │ - (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &&rhs) │ │ │ │ │ + (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &&_r_h_s) │ │ │ │ │   Move a regular iterator into a reverse │ │ │ │ │ iterator. │ │ │ │ │   │ │ │ │ │ -PQXX_PURE _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  bbaassee () const noexcept │ │ │ │ │ +PQXX_PURE _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  bbaassee () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Return the underlying "regular" iterator (as │ │ │ │ │ per standard library). │ │ │ │ │   │ │ │ │ │ Manipulations │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &r) │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &_r) │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&r) │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&_r) │ │ │ │ │   │ │ │ │ │ _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++++ () │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++++ (int) & │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++++ (_i_n_t) & │ │ │ │ │   │ │ │ │ │ _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr---- () │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr---- (int) & │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr---- (_i_n_t) & │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++== (difference_type i) │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr++== (difference_type _i) │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr--== (difference_type i) │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &  ooppeerraattoorr--== (difference_type _i) │ │ │ │ │   │ │ │ │ │ - void  sswwaapp (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &other) │ │ │ │ │ - noexcept │ │ │ │ │ + _v_o_i_d  sswwaapp (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r &_o_t_h_e_r) │ │ │ │ │ + _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ Arithmetic operators │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type i) const │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr++ (difference_type _i) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type i) │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type _i) │ │ │ │ │   │ │ │ │ │ - difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &rhs) const │ │ │ │ │ + difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &_r_h_s) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ Comparisons │ │ │ │ │ - bool  ooppeerraattoorr==== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ - const &rhs) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr==== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ + _c_o_n_s_t &_r_h_s) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr!!== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ - const &rhs) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr!!== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ + _c_o_n_s_t &_r_h_s) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr<< (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &rhs) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr<< (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &_r_h_s) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr<<== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ - const &rhs) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr<<== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ + _c_o_n_s_t &_r_h_s) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr>> (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const │ │ │ │ │ - &rhs) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr>> (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t │ │ │ │ │ + &_r_h_s) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr>>== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ - const &rhs) const │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr>>== (_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ + _c_o_n_s_t &_r_h_s) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ Dereferencing operators │ │ │ │ │ - _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type) const │ │ │ │ │ + _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  ooppeerraattoorr-- (difference_type) _c_o_n_s_t │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ - difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) │ │ │ │ │ - const │ │ │ │ │ + difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &) │ │ │ │ │ + _c_o_n_s_t │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () _c_o_n_s_t │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  bbaacckk () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  bbaacckk () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ffrroonntt () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ffrroonntt () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  aatt (size_type) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  aatt (size_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │ + _c_o_n_s_t_e_x_p_r result::size_type  rroowwnnuummbbeerr () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Row number, assuming this is a real row and │ │ │ │ │ not end()/rend(). │ │ │ │ │   │ │ │ │ │ ********** DDeettaaiilleedd DDeessccrriippttiioonn ********** │ │ │ │ │ Reverse iterator for result. Use as result::const_reverse_iterator. │ │ │ │ │ ********** MMeemmbbeerr FFuunnccttiioonn DDooccuummeennttaattiioonn ********** │ │ │ │ │ ********** _?◆_? aatt(()) ********** │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1errorhandler.html │ │ │ │ @@ -126,15 +126,15 @@ │ │ │ │

│ │ │ │ Friends

│ │ │ │ │ │ │ │ class internal::gate::errorhandler_connection │ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │ -
Deprecated:
Base class for obsolete error-handler callbacks.
│ │ │ │ +
Deprecated:
Base class for obsolete error-handler callbacks.
│ │ │ │

This method of handling errors is obsolete. Use a "notice handler" instead.

│ │ │ │
Warning
Strange things happen when a result object outlives its parent connection. If you register an error handler on a connection, then you must not access the result after destroying the connection. This applies even if you destroy the error handler first!
│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ errorhandler()

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1largeobject.html │ │ │ │ @@ -171,15 +171,15 @@ │ │ │ │   │ │ │ │ │ │ │ │ PQXX_PRIVATE std::string reason (connection const &, int err) const │ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │

Identity of a large object.

│ │ │ │ -
Deprecated:
Use the blob class instead.
│ │ │ │ +
Deprecated:
Use the blob class instead.
│ │ │ │

Encapsulates the identity of a large object.

│ │ │ │

A largeobject must be accessed only from within a backend transaction, but the object's identity remains valid as long as the object exists.

│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ largeobject() [1/5]

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1largeobject__streambuf.html │ │ │ │ @@ -190,15 +190,15 @@ │ │ │ │ │ │ │ │ virtual int_type underflow () override │ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │
template<typename CHAR = char, typename TRAITS = std::char_traits<CHAR>>
│ │ │ │ class pqxx::largeobject_streambuf< CHAR, TRAITS >

Streambuf to use large objects in standard I/O streams.

│ │ │ │ -
Deprecated:
Access large objects directly using the blob class.
│ │ │ │ +
Deprecated:
Access large objects directly using the blob class.
│ │ │ │

The standard streambuf classes provide uniform access to data storage such as files or string buffers, so they can be accessed using standard input or output streams. This streambuf implementation provided similar access to large objects, so they could be read and written using the same stream classes.

│ │ │ │

This functionality was considered too fragile and complex, so it has been replaced with a single, much simpler class.

│ │ │ │

Member Data Documentation

│ │ │ │ │ │ │ │

◆ default_mode

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1largeobjectaccess.html │ │ │ │ @@ -238,15 +238,15 @@ │ │ │ │   │ │ │ │ bool operator>= (largeobject const &other) const │ │ │ │  Compare object identities.
│ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │

Accessor for large object's contents.

│ │ │ │ -
Deprecated:
Use the blob class instead.
│ │ │ │ +
Deprecated:
Use the blob class instead.
│ │ │ │

Member Typedef Documentation

│ │ │ │ │ │ │ │

◆ openmode

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.html │ │ │ │ @@ -100,224 +100,225 @@ │ │ │ │ │ │ │ │

Result set containing data returned by a query or command. │ │ │ │ More...

│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │

│ │ │ │ Public Types

│ │ │ │ -using size_type = result_size_type
size_type = result_size_type
 
│ │ │ │ -using difference_type = result_difference_type
difference_type = result_difference_type
 
│ │ │ │ -using reference = row
reference = row
 
│ │ │ │ -using const_iterator = const_result_iterator
const_iterator = const_result_iterator
 
│ │ │ │ -using pointer = const_iterator
pointer = const_iterator
 
│ │ │ │ -using iterator = const_iterator
iterator = const_iterator
 
│ │ │ │ -using const_reverse_iterator = const_reverse_result_iterator
const_reverse_iterator = const_reverse_result_iterator
 
│ │ │ │ -using reverse_iterator = const_reverse_iterator
reverse_iterator = const_reverse_iterator
 
│ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +result &  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE size_type  │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +row  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +field  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │

│ │ │ │ Public Member Functions

│ │ │ │ - result (result const &rhs) noexcept=default
result (result const &rhs) noexcept=default
 
│ │ │ │ - result (result &&rhs) noexcept=default
result (result &&rhs) noexcept=default
 
result & operator= (result const &rhs) noexcept=default
result & operator= (result const &rhs) noexcept=default
 Assign one result to another.
 
│ │ │ │ -result & operator= (result &&rhs) noexcept=default
operator= (result &&rhs) noexcept=default
 Assign one result to another, invaliding the old one.
 
Comparisons

You can compare results for equality. Beware: this is a very strict, dumb comparison. The smallest difference between two results (such as a string "Foo" versus a string "foo") will make them unequal.

│ │ │ │
│ │ │ │ -bool operator== (result const &) const noexcept
operator== (result const &) const noexcept
 Compare two results for equality.
 
│ │ │ │ -bool operator!= (result const &rhs) const noexcept
operator!= (result const &rhs) const noexcept
 Compare two results for inequality.
 
template<typename... TYPE>
auto iter () const
auto iter () const
 Iterate rows, reading them directly into a tuple of "TYPE...".
 
│ │ │ │ -const_reverse_iterator rbegin () const
rbegin () const
 
│ │ │ │ -const_reverse_iterator crbegin () const
crbegin () const
 
│ │ │ │ -const_reverse_iterator rend () const
rend () const
 
│ │ │ │ -const_reverse_iterator crend () const
crend () const
 
│ │ │ │ -const_iterator begin () const noexcept
begin () const noexcept
 
│ │ │ │ -const_iterator cbegin () const noexcept
cbegin () const noexcept
 
│ │ │ │ -const_iterator end () const noexcept
end () const noexcept
 
│ │ │ │ -const_iterator cend () const noexcept
cend () const noexcept
 
│ │ │ │ -reference front () const noexcept
front () const noexcept
 
│ │ │ │ -reference back () const noexcept
back () const noexcept
 
│ │ │ │ -PQXX_PURE size_type size () const noexcept
size () const noexcept
 
│ │ │ │ -PQXX_PURE bool empty () const noexcept
empty () const noexcept
 
│ │ │ │ -size_type capacity () const noexcept
capacity () const noexcept
 
void swap (result &) noexcept
void swap (result &) noexcept
 Exchange two result values in an exception-safe manner.
 
row operator[] (size_type i) const noexcept
row operator[] (size_type i) const noexcept
 Index a row by number.
 
│ │ │ │ -row at (size_type) const
at (size_type) const
 Index a row by number, but check that the row number is valid.
 
│ │ │ │ -field at (size_type, row_size_type) const
at (size_type, row_size_type) const
 Index a field by row number and column number.
 
void clear () noexcept
void clear () noexcept
 Let go of the result's data.
 
│ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE row_size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +row_size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +charconst *  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +row_size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +row_size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE std::string const &  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +result  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │

Column information

│ │ │ │ -class pqxx::internal::gate::result_pipeline
pqxx::internal::gate::result_pipeline
 
│ │ │ │ -class pqxx::field
pqxx::field
 
│ │ │ │ -class pqxx::internal::gate::result_creation
pqxx::internal::gate::result_creation
 
│ │ │ │ -class pqxx::internal::gate::result_connection
pqxx::internal::gate::result_connection
 
│ │ │ │ -class pqxx::internal::gate::result_row
pqxx::internal::gate::result_row
 
│ │ │ │ -class pqxx::internal::gate::result_sql_cursor
pqxx::internal::gate::result_sql_cursor
 
│ │ │ │ -PQXX_PURE row_size_type columns () const noexcept
columns () const noexcept
 Number of columns in result.
 
│ │ │ │ -row_size_type column_number (zview name) const
column_number (zview name) const
 Number of given column (throws exception if it doesn't exist).
 
│ │ │ │ -char const * column_name (row_size_type number) const &
column_name (row_size_type number) const &
 Name of column with this number (throws exception if it doesn't exist)
 
int column_storage (row_size_type number) const
int column_storage (row_size_type number) const
 Server-side storage size for field of column's type, in bytes.
 
int column_type_modifier (row_size_type number) const noexcept
int column_type_modifier (row_size_type number) const noexcept
 Type modifier of the column with this number.
 
│ │ │ │ -oid column_type (row_size_type col_num) const
column_type (row_size_type col_num) const
 Return column's type, as an OID from the system catalogue.
 
│ │ │ │ -oid column_type (zview col_name) const
column_type (zview col_name) const
 Return column's type, as an OID from the system catalogue.
 
│ │ │ │ -oid column_table (row_size_type col_num) const
column_table (row_size_type col_num) const
 What table did this column come from?
 
│ │ │ │ -oid column_table (zview col_name) const
column_table (zview col_name) const
 What table did this column come from?
 
│ │ │ │ -row_size_type table_column (row_size_type col_num) const
table_column (row_size_type col_num) const
 What column in its table did this column come from?
 
│ │ │ │ -row_size_type table_column (zview col_name) const
table_column (zview col_name) const
 What column in its table did this column come from?
 
│ │ │ │ -PQXX_PURE std::string const & query () const &noexcept
query () const &noexcept
 Query that produced this result, if available (empty string otherwise)
 
PQXX_PURE oid inserted_oid () const
PQXX_PURE oid inserted_oid () const
 If command was an INSERT of 1 row, return oid of the inserted row.
 
PQXX_PURE size_type affected_rows () const
PQXX_PURE size_type affected_rows () const
 If command was INSERT, UPDATE, or DELETE: number of affected rows.
 
template<typename CALLABLE >
void for_each (CALLABLE &&func) const
template<typename CALLABLE >
void for_each (CALLABLE &&func) const
 Run func on each row, passing the row's fields as parameters.
 
result expect_rows (size_type n) const
result expect_rows (size_type n) const
 Check that result contains exactly n rows.
 
row one_row () const
row one_row () const
 Check that result contains exactly 1 row, and return that row.
 
std::optional< row > opt_row () const
std::optional< row > opt_row () const
 Expect that result contains at moost one row, and return as optional.
 
│ │ │ │ -result no_rows () const
no_rows () const
 Expect that result contains no rows. Return result for convenience.
 
result expect_columns (row_size_type cols) const
result expect_columns (row_size_type cols) const
 Expect that result consists of exactly cols columns.
 
field one_field () const
field one_field () const
 Expect that result consists of exactly 1 row and 1 column.
 
│ │ │ │

Detailed Description

│ │ │ │

Result set containing data returned by a query or command.

│ │ │ │

This behaves as a container (as defined by the C++ standard library) and provides random access const iterators to iterate over its rows. You can also access a row by indexing a result R by the row's zero-based number:

│ │ │ │ -
for (result::size_type i=0; i < std::size(R); ++i) Process(R[i]);
│ │ │ │ +
for (result::size_type i=0; i < std::size(R); ++i) Process(R[i]);
│ │ │ │ +
pqxx::const_reverse_result_iterator
Reverse iterator for result. Use as result::const_reverse_iterator.
Definition result_iterator.hxx:196
│ │ │ │

Result sets in libpqxx are lightweight, reference-counted wrapper objects which are relatively small and cheap to copy. Think of a result object as a "smart pointer" to an underlying result set.

│ │ │ │
Warning
The result set that a result object points to is not thread-safe. If you copy a result object, it still refers to the same underlying result set. So never copy, destroy, query, or otherwise access a result while another thread may be copying, destroying, querying, or otherwise accessing the same result set–even if it is doing so through a different result object!
│ │ │ │

Member Function Documentation

│ │ │ │ │ │ │ │

◆ affected_rows()

│ │ │ │ │ │ │ │
│ │ │ │ @@ -343,15 +344,15 @@ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
void pqxx::result::clear void pqxx::result::clear ()
│ │ │ │ 		│ │ │ │ @@ -369,15 +370,15 @@ │ │ │ │ │ │ │ │

◆ column_storage()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
int pqxx::result::column_storage int pqxx::result::column_storage (row_size_type number) const
│ │ │ │
│ │ │ │ @@ -393,15 +394,15 @@ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -493,23 +494,23 @@ │ │ │ │ │ │ │ │ │ │ │ │

◆ for_each()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ -template<typename CALLABLE >
│ │ │ │ +template<typename CALLABLE >
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
int pqxx::result::column_type_modifier int pqxx::result::column_type_modifier (row_size_type number) const
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -519,17 +520,17 @@ │ │ │ │ │ │ │ │

Run func on each row, passing the row's fields as parameters.

│ │ │ │

Goes through the rows from first to last. You provide a callable func.

│ │ │ │

For each row in the result, for_each will call func. It converts the row's fields to the types of func's parameters, and pass them to func.

│ │ │ │

(Therefore func must have a single signature. It can't be a generic lambda, or an object of a class with multiple overloaded function call operators. Otherwise, for_each will have no way to detect a parameter list without ambiguity.)

│ │ │ │

If any of your parameter types is std::string_view, it refers to the underlying storage of this result.

│ │ │ │

If any of your parameter types is a reference type, its argument will refer to a temporary value which only lives for the duration of that single invocation to func. If the reference is an lvalue reference, it must be const.

│ │ │ │ -

For example, this queries employee names and salaries from the database and prints how much each would like to earn instead:

tx.exec("SELECT name, salary FROM employee").for_each(
│ │ │ │ -
[](std::string_view name, float salary){
│ │ │ │ -
std::cout << name << " would like " << salary * 2 << ".\n";
│ │ │ │ +

For example, this queries employee names and salaries from the database and prints how much each would like to earn instead:

tx.exec("SELECT name, salary FROM employee").for_each(
│ │ │ │ +
[](std::string_view name, float salary){
│ │ │ │ +
std::cout << name << " would like " << salary * 2 << ".\n";
│ │ │ │
})
│ │ │ │

If func throws an exception, processing stops at that point and propagates the exception.

│ │ │ │
Exceptions
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
void pqxx::result::for_each void pqxx::result::for_each (CALLABLE && CALLABLE && func) const
│ │ │ │ 		│ │ │ │ inline
│ │ │ │ │ │ │ │
pqxx::usage_errorif func's number of parameters does not match the number of columns in this result.
│ │ │ │ │ │ │ │ @@ -566,15 +567,15 @@ │ │ │ │
│ │ │ │ template<typename... TYPE>
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
auto pqxx::result::iter auto pqxx::result::iter () const
│ │ │ │ 		│ │ │ │ @@ -651,15 +652,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -734,15 +735,15 @@ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
result & pqxx::result::operator= (result const & result const & rhs)
│ │ │ │ 		│ │ │ │ defaultnoexcept
│ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -3,198 +3,201 @@ │ │ │ │ │ Loading... │ │ │ │ │ Searching... │ │ │ │ │ No Matches │ │ │ │ │ _P_u_b_l_i_c_ _T_y_p_e_s | _P_u_b_l_i_c_ _M_e_m_b_e_r_ _F_u_n_c_t_i_o_n_s | _L_i_s_t_ _o_f_ _a_l_l_ _m_e_m_b_e_r_s │ │ │ │ │ pqxx::result Class Reference │ │ │ │ │ Result set containing data returned by a query or command. _M_o_r_e_._._. │ │ │ │ │ PPuubblliicc TTyyppeess │ │ │ │ │ -using  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  rreeffeerreennccee = _r_o_w │ │ │ │ │ +_u_s_i_n_g  rreeffeerreennccee = _r_o_w │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  ppooiinntteerr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ppooiinntteerr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   rreessuulltt (_r_e_s_u_l_t const &rhs) noexcept=default │ │ │ │ │ +   rreessuulltt (_r_e_s_u_l_t _c_o_n_s_t &_r_h_s) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ -   rreessuulltt (_r_e_s_u_l_t &&rhs) noexcept=default │ │ │ │ │ +   rreessuulltt (_r_e_s_u_l_t &&_r_h_s) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t &  _o_p_e_r_a_t_o_r_= (_r_e_s_u_l_t const &rhs) noexcept=default │ │ │ │ │ + _r_e_s_u_l_t &  _o_p_e_r_a_t_o_r_= (_r_e_s_u_l_t _c_o_n_s_t &_r_h_s) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   Assign one result to another. │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t &  ooppeerraattoorr== (_r_e_s_u_l_t &&rhs) noexcept=default │ │ │ │ │ + _r_e_s_u_l_t &  ooppeerraattoorr== (_r_e_s_u_l_t &&_r_h_s) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   Assign one result to another, invaliding the old one. │ │ │ │ │   │ │ │ │ │ Comparisons │ │ │ │ │ You can compare results for equality. Beware: this is a very strict, dumb │ │ │ │ │ comparison. The smallest difference between two results (such as a string "Foo" │ │ │ │ │ versus a string "foo") will make them unequal. │ │ │ │ │ - bool  ooppeerraattoorr==== (_r_e_s_u_l_t const &) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr==== (_r_e_s_u_l_t _c_o_n_s_t &) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Compare two results for equality. │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr!!== (_r_e_s_u_l_t const &rhs) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr!!== (_r_e_s_u_l_t _c_o_n_s_t &_r_h_s) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Compare two results for inequality. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - auto  _i_t_e_r () const │ │ │ │ │ + _a_u_t_o  _i_t_e_r () _c_o_n_s_t │ │ │ │ │   Iterate rows, reading them directly into a tuple of │ │ │ │ │ "TYPE...". │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  rrbbeeggiinn () const │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  rrbbeeggiinn () _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () const │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  rreenndd () const │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  rreenndd () _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ -_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  ccrreenndd () const │ │ │ │ │ +_c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  ccrreenndd () _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ffrroonntt () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ffrroonntt () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  bbaacckk () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  bbaacckk () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - PQXX_PURE size_type  ssiizzee () const noexcept │ │ │ │ │ + PQXX_PURE size_type  ssiizzee () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │ + PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - size_type  ccaappaacciittyy () const noexcept │ │ │ │ │ + size_type  ccaappaacciittyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - void  _s_w_a_p (_r_e_s_u_l_t &) noexcept │ │ │ │ │ + _v_o_i_d  _s_w_a_p (_r_e_s_u_l_t &) _n_o_e_x_c_e_p_t │ │ │ │ │   Exchange two result values in an exception-safe manner. │ │ │ │ │   │ │ │ │ │ - _r_o_w  _o_p_e_r_a_t_o_r_[_] (size_type i) const noexcept │ │ │ │ │ + _r_o_w  _o_p_e_r_a_t_o_r_[_] (size_type _i) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Index a row by number. │ │ │ │ │   │ │ │ │ │ - _r_o_w  aatt (size_type) const │ │ │ │ │ + _r_o_w  aatt (size_type) _c_o_n_s_t │ │ │ │ │   Index a row by number, but check that the row number is │ │ │ │ │ valid. │ │ │ │ │   │ │ │ │ │ - _f_i_e_l_d  aatt (size_type, _r_o_w___s_i_z_e___t_y_p_e) const │ │ │ │ │ + _f_i_e_l_d  aatt (size_type, _r_o_w___s_i_z_e___t_y_p_e) _c_o_n_s_t │ │ │ │ │   Index a field by row number and column number. │ │ │ │ │   │ │ │ │ │ - void  _c_l_e_a_r () noexcept │ │ │ │ │ + _v_o_i_d  _c_l_e_a_r () _n_o_e_x_c_e_p_t │ │ │ │ │   Let go of the result's data. │ │ │ │ │   │ │ │ │ │ ********** CCoolluummnn iinnffoorrmmaattiioonn ********** │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ppiippeelliinnee │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ppiippeelliinnee │ │ │ │ │   │ │ │ │ │ - class  ppqqxxxx::::ffiieelldd │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::ffiieelldd │ │ │ │ │   │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccrreeaattiioonn │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccrreeaattiioonn │ │ │ │ │   │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccoonnnneeccttiioonn │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccoonnnneeccttiioonn │ │ │ │ │   │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__rrooww │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__rrooww │ │ │ │ │   │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ssqqll__ccuurrssoorr │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ssqqll__ccuurrssoorr │ │ │ │ │   │ │ │ │ │ - PQXX_PURE _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnnss () const noexcept │ │ │ │ │ + PQXX_PURE _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnnss () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Number of columns in result. │ │ │ │ │   │ │ │ │ │ - _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w name) const │ │ │ │ │ + _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w name) _c_o_n_s_t │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - char const *  ccoolluummnn__nnaammee (_r_o_w___s_i_z_e___t_y_p_e number) const & │ │ │ │ │ + _c_h_a_r _c_o_n_s_t *  ccoolluummnn__nnaammee (_r_o_w___s_i_z_e___t_y_p_e _n_u_m_b_e_r) _c_o_n_s_t & │ │ │ │ │   Name of column with this number (throws │ │ │ │ │ exception if it doesn't exist) │ │ │ │ │   │ │ │ │ │ - int  _c_o_l_u_m_n___s_t_o_r_a_g_e (_r_o_w___s_i_z_e___t_y_p_e number) const │ │ │ │ │ + _i_n_t  _c_o_l_u_m_n___s_t_o_r_a_g_e (_r_o_w___s_i_z_e___t_y_p_e _n_u_m_b_e_r) _c_o_n_s_t │ │ │ │ │   Server-side storage size for field of column's │ │ │ │ │ type, in bytes. │ │ │ │ │   │ │ │ │ │ - int  _c_o_l_u_m_n___t_y_p_e___m_o_d_i_f_i_e_r (_r_o_w___s_i_z_e___t_y_p_e number) │ │ │ │ │ - const noexcept │ │ │ │ │ + _i_n_t  _c_o_l_u_m_n___t_y_p_e___m_o_d_i_f_i_e_r (_r_o_w___s_i_z_e___t_y_p_e _n_u_m_b_e_r) │ │ │ │ │ + _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Type modifier of the column with this number. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_r_o_w___s_i_z_e___t_y_p_e col_num) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_r_o_w___s_i_z_e___t_y_p_e _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │   Return column's type, as an OID from the system │ │ │ │ │ catalogue. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   Return column's type, as an OID from the system │ │ │ │ │ catalogue. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_r_o_w___s_i_z_e___t_y_p_e col_num) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_r_o_w___s_i_z_e___t_y_p_e _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _r_o_w___s_i_z_e___t_y_p_e  ttaabbllee__ccoolluummnn (_r_o_w___s_i_z_e___t_y_p_e col_num) const │ │ │ │ │ + _r_o_w___s_i_z_e___t_y_p_e  ttaabbllee__ccoolluummnn (_r_o_w___s_i_z_e___t_y_p_e _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │   What column in its table did this column come │ │ │ │ │ from? │ │ │ │ │   │ │ │ │ │ - _r_o_w___s_i_z_e___t_y_p_e  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_o_w___s_i_z_e___t_y_p_e  ttaabbllee__ccoolluummnn (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What column in its table did this column come │ │ │ │ │ from? │ │ │ │ │   │ │ │ │ │ -PQXX_PURE std::string const &  qquueerryy () const &noexcept │ │ │ │ │ +PQXX_PURE std::string _c_o_n_s_t &  qquueerryy () _c_o_n_s_t &_n_o_e_x_c_e_p_t │ │ │ │ │   Query that produced this result, if available │ │ │ │ │ (empty string otherwise) │ │ │ │ │   │ │ │ │ │ - PQXX_PURE _o_i_d  _i_n_s_e_r_t_e_d___o_i_d () const │ │ │ │ │ + PQXX_PURE _o_i_d  _i_n_s_e_r_t_e_d___o_i_d () _c_o_n_s_t │ │ │ │ │   If command was an INSERT of 1 row, return oid of │ │ │ │ │ the inserted row. │ │ │ │ │   │ │ │ │ │ - PQXX_PURE size_type  _a_f_f_e_c_t_e_d___r_o_w_s () const │ │ │ │ │ + PQXX_PURE size_type  _a_f_f_e_c_t_e_d___r_o_w_s () _c_o_n_s_t │ │ │ │ │   If command was INSERT, UPDATE, or DELETE: number │ │ │ │ │ of affected rows. │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - void  _f_o_r___e_a_c_h (CALLABLE &&func) const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _C_A_L_L_A_B_L_E > │ │ │ │ │ + _v_o_i_d  _f_o_r___e_a_c_h (_C_A_L_L_A_B_L_E &&_f_u_n_c) _c_o_n_s_t │ │ │ │ │   Run func on each row, passing the row's fields │ │ │ │ │ as parameters. │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t  _e_x_p_e_c_t___r_o_w_s (size_type n) const │ │ │ │ │ + _r_e_s_u_l_t  _e_x_p_e_c_t___r_o_w_s (size_type _n) _c_o_n_s_t │ │ │ │ │   Check that result contains exactly n rows. │ │ │ │ │   │ │ │ │ │ - _r_o_w  _o_n_e___r_o_w () const │ │ │ │ │ + _r_o_w  _o_n_e___r_o_w () _c_o_n_s_t │ │ │ │ │   Check that result contains exactly 1 row, and │ │ │ │ │ return that row. │ │ │ │ │   │ │ │ │ │ - std::optional< _r_o_w >  _o_p_t___r_o_w () const │ │ │ │ │ + std::optional< _r_o_w >  _o_p_t___r_o_w () _c_o_n_s_t │ │ │ │ │   Expect that result contains at moost one row, │ │ │ │ │ and return as optional. │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t  nnoo__rroowwss () const │ │ │ │ │ + _r_e_s_u_l_t  nnoo__rroowwss () _c_o_n_s_t │ │ │ │ │   Expect that result contains no rows. Return │ │ │ │ │ result for convenience. │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t  _e_x_p_e_c_t___c_o_l_u_m_n_s (_r_o_w___s_i_z_e___t_y_p_e cols) const │ │ │ │ │ + _r_e_s_u_l_t  _e_x_p_e_c_t___c_o_l_u_m_n_s (_r_o_w___s_i_z_e___t_y_p_e _c_o_l_s) _c_o_n_s_t │ │ │ │ │   Expect that result consists of exactly cols │ │ │ │ │ columns. │ │ │ │ │   │ │ │ │ │ - _f_i_e_l_d  _o_n_e___f_i_e_l_d () const │ │ │ │ │ + _f_i_e_l_d  _o_n_e___f_i_e_l_d () _c_o_n_s_t │ │ │ │ │   Expect that result consists of exactly 1 row and │ │ │ │ │ 1 column. │ │ │ │ │   │ │ │ │ │ ********** DDeettaaiilleedd DDeessccrriippttiioonn ********** │ │ │ │ │ Result set containing data returned by a query or command. │ │ │ │ │ This behaves as a container (as defined by the C++ standard library) and │ │ │ │ │ provides random access const iterators to iterate over its rows. You can also │ │ │ │ │ access a row by indexing a result R by the row's zero-based number: │ │ │ │ │ -for (result::size_type i=0; i < std::size(R); ++i) Process(R[i]); │ │ │ │ │ +for (result::size_type _i=0; _i < std::size(_R); ++_i) _P_r_o_c_e_s_s(_R[_i]); │ │ │ │ │ +_p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +Reverse iterator for result. Use as result::const_reverse_iterator. │ │ │ │ │ +DDeeffiinniittiioonn result_iterator.hxx:196 │ │ │ │ │ Result sets in libpqxx are lightweight, reference-counted wrapper objects which │ │ │ │ │ are relatively small and cheap to copy. Think of a result object as a "smart │ │ │ │ │ pointer" to an underlying result set. │ │ │ │ │ Warning │ │ │ │ │ The result set that a result object points to is not thread-safe. If you │ │ │ │ │ copy a result object, it still refers to the same underlying result set. │ │ │ │ │ So never copy, destroy, query, or otherwise access a result while another │ │ │ │ │ @@ -204,29 +207,29 @@ │ │ │ │ │ ********** _?◆_? aaffffeecctteedd__rroowwss(()) ********** │ │ │ │ │ pqxx::result::size_type pqxx::result::affected_rows ( ) const │ │ │ │ │ If command was INSERT, UPDATE, or DELETE: number of affected rows. │ │ │ │ │ Returns │ │ │ │ │ Number of affected rows if last command was INSERT, UPDATE, or DELETE; │ │ │ │ │ zero for all other commands. │ │ │ │ │ ********** _?◆_? cclleeaarr(()) ********** │ │ │ │ │ -void pqxx::result:: ( ) inlinenoexcept │ │ │ │ │ +_v_o_i_d pqxx::result:: ( ) inlinenoexcept │ │ │ │ │ clear │ │ │ │ │ Let go of the result's data. │ │ │ │ │ Use this if you need to deallocate the result data earlier than you can destroy │ │ │ │ │ the result object itself. │ │ │ │ │ Multiple result objects can refer to the same set of underlying data. The │ │ │ │ │ underlying data will be deallocated once all result objects that refer to it │ │ │ │ │ are cleared or destroyed. │ │ │ │ │ ********** _?◆_? ccoolluummnn__ssttoorraaggee(()) ********** │ │ │ │ │ -int pqxx::result::column_storage ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const │ │ │ │ │ +_i_n_t pqxx::result::column_storage ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const │ │ │ │ │ Server-side storage size for field of column's type, in bytes. │ │ │ │ │ Returns the size of the server's internal representation of the column's data │ │ │ │ │ type. A negative value indicates the data type is variable-length. │ │ │ │ │ ********** _?◆_? ccoolluummnn__ttyyppee__mmooddiiffiieerr(()) ********** │ │ │ │ │ -int pqxx::result::column_type_modifier ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const noexcept │ │ │ │ │ +_i_n_t pqxx::result::column_type_modifier ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const noexcept │ │ │ │ │ Type modifier of the column with this number. │ │ │ │ │ The meaning of modifier values is type-specific; they typically indicate │ │ │ │ │ precision or size limits. │ │ │ │ │ UUssee tthhiiss oonnllyy iiff yyoouu kknnooww wwhhaatt yyoouu''rree ddooiinngg.. Most applications do not need it, │ │ │ │ │ and most types do not use modifiers. │ │ │ │ │ The value -1 indicates "no information available." │ │ │ │ │ Warning │ │ │ │ │ @@ -242,16 +245,16 @@ │ │ │ │ │ _r_e_s_u_l_t pqxx::result::expect_rows ( size_type  nn ) const inline │ │ │ │ │ Check that result contains exactly n rows. │ │ │ │ │ Returns │ │ │ │ │ The result itself, for convenience. │ │ │ │ │ Exceptions │ │ │ │ │ ref _u_n_e_x_p_e_c_t_e_d___r_o_w_s if the actual count is not equal to n. │ │ │ │ │ ********** _?◆_? ffoorr__eeaacchh(()) ********** │ │ │ │ │ -template │ │ │ │ │ -void pqxx::result::for_each ( CALLABLE &&  ffuunncc ) const inline │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _C_A_L_L_A_B_L_E > │ │ │ │ │ +_v_o_i_d pqxx::result::for_each ( _C_A_L_L_A_B_L_E &&  ffuunncc ) const inline │ │ │ │ │ Run func on each row, passing the row's fields as parameters. │ │ │ │ │ Goes through the rows from first to last. You provide a callable func. │ │ │ │ │ For each row in the result, for_each will call func. It converts the row's │ │ │ │ │ fields to the types of func's parameters, and pass them to func. │ │ │ │ │ (Therefore func must have a ssiinnggllee signature. It can't be a generic lambda, or │ │ │ │ │ an object of a class with multiple overloaded function call operators. │ │ │ │ │ Otherwise, for_each will have no way to detect a parameter list without │ │ │ │ │ @@ -259,17 +262,17 @@ │ │ │ │ │ If any of your parameter types is std::string_view, it refers to the underlying │ │ │ │ │ storage of this result. │ │ │ │ │ If any of your parameter types is a reference type, its argument will refer to │ │ │ │ │ a temporary value which only lives for the duration of that single invocation │ │ │ │ │ to func. If the reference is an lvalue reference, it must be const. │ │ │ │ │ For example, this queries employee names and salaries from the database and │ │ │ │ │ prints how much each would like to earn instead: │ │ │ │ │ -tx.exec("SELECT name, salary FROM employee").for_each( │ │ │ │ │ -[](std::string_view name, float salary){ │ │ │ │ │ -std::cout << name << " would like " << salary * 2 << ".\n"; │ │ │ │ │ +_t_x.exec("SELECT name, salary FROM employee").for_each( │ │ │ │ │ +[](std::string_view name, float _s_a_l_a_r_y){ │ │ │ │ │ +std::cout << name << " would like " << _s_a_l_a_r_y * 2 << ".\n"; │ │ │ │ │ }) │ │ │ │ │ If func throws an exception, processing stops at that point and propagates the │ │ │ │ │ exception. │ │ │ │ │ Exceptions │ │ │ │ │ _p_q_x_x_:_:_u_s_a_g_e___e_r_r_o_r if func's number of parameters does not match the │ │ │ │ │ number of columns in this result. │ │ │ │ │ The parameter types must have conversions from PostgreSQL's string format │ │ │ │ │ @@ -278,15 +281,15 @@ │ │ │ │ │ _p_q_x_x_:_:_o_i_d pqxx::result::inserted_oid ( ) const │ │ │ │ │ If command was an INSERT of 1 row, return oid of the inserted row. │ │ │ │ │ Returns │ │ │ │ │ Identifier of inserted row if exactly one row was inserted, or _o_i_d___n_o_n_e │ │ │ │ │ otherwise. │ │ │ │ │ ********** _?◆_? iitteerr(()) ********** │ │ │ │ │ template │ │ │ │ │ -auto pqxx::result::iter ( ) const inline │ │ │ │ │ +_a_u_t_o pqxx::result::iter ( ) const inline │ │ │ │ │ Iterate rows, reading them directly into a tuple of "TYPE...". │ │ │ │ │ Converts the fields to values of the given respective types. │ │ │ │ │ Use this only with a ranged "for" loop. The iteration produces std:: │ │ │ │ │ tuple which you can "unpack" to a series of auto variables. │ │ │ │ │ ********** _?◆_? oonnee__ffiieelldd(()) ********** │ │ │ │ │ _p_q_x_x_:_:_f_i_e_l_d pqxx::result::one_field ( ) const │ │ │ │ │ Expect that result consists of exactly 1 row and 1 column. │ │ │ │ │ @@ -298,15 +301,15 @@ │ │ │ │ │ _p_q_x_x_:_:_r_o_w pqxx::result::one_row ( ) const │ │ │ │ │ Check that result contains exactly 1 row, and return that row. │ │ │ │ │ Returns │ │ │ │ │ _p_q_x_x_:_:_r_o_w │ │ │ │ │ Exceptions │ │ │ │ │ ref _u_n_e_x_p_e_c_t_e_d___r_o_w_s if the actual count is not equal to n. │ │ │ │ │ ********** _?◆_? ooppeerraattoorr==(()) ********** │ │ │ │ │ -_r_e_s_u_l_t & pqxx::result:: ( _r_e_s_u_l_t const &  rrhhss ) defaultnoexcept │ │ │ │ │ +_r_e_s_u_l_t & pqxx::result:: ( _r_e_s_u_l_t _c_o_n_s_t &  rrhhss ) defaultnoexcept │ │ │ │ │ operator= │ │ │ │ │ Assign one result to another. │ │ │ │ │ Copying results is cheap: it copies only smart pointers, but the actual data │ │ │ │ │ stays in the same place. │ │ │ │ │ ********** _?◆_? ooppeerraattoorr[[]](()) ********** │ │ │ │ │ _p_q_x_x_:_:_r_o_w pqxx::result::operator[] ( size_type  ii ) const noexcept │ │ │ │ │ Index a row by number. │ │ │ │ │ @@ -316,15 +319,15 @@ │ │ │ │ │ std::optional< _p_q_x_x_:_:_r_o_w > pqxx::result::opt_row ( ) const │ │ │ │ │ Expect that result contains at moost one row, and return as optional. │ │ │ │ │ Returns an empty std::optional if the result is empty, or if it has exactly one │ │ │ │ │ row, a std::optional containing the row. │ │ │ │ │ Exceptions │ │ │ │ │ ref _u_n_e_x_p_e_c_t_e_d___r_o_w_s is the row count is not 0 or 1. │ │ │ │ │ ********** _?◆_? sswwaapp(()) ********** │ │ │ │ │ -void pqxx::result:: ( _r_e_s_u_l_t &  rrhhss ) noexcept │ │ │ │ │ +_v_o_i_d pqxx::result:: ( _r_e_s_u_l_t &  rrhhss ) noexcept │ │ │ │ │ swap │ │ │ │ │ Exchange two result values in an exception-safe manner. │ │ │ │ │ If the swap fails, the two values will be exactly as they were before. │ │ │ │ │ The swap is not necessarily thread-safe. │ │ │ │ │ =============================================================================== │ │ │ │ │ The documentation for this class was generated from the following files: │ │ │ │ │ * /build/reproducible-path/libpqxx-7.10.0/include/pqxx/_r_e_s_u_l_t_._h_x_x │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.html │ │ │ │ @@ -126,121 +126,121 @@ │ │ │ │ │ │ │ │ │ │ │ │
[legend]
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
void pqxx::result::swap void pqxx::result::swap (result & rhs)
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │ │ │ │ │ +using  │ │ │ │ │ │ │ │

│ │ │ │ Public Types

│ │ │ │ -using size_type = row_size_type
size_type = row_size_type
 
│ │ │ │ -using difference_type = row_difference_type
difference_type = row_difference_type
 
│ │ │ │ -using const_iterator = const_row_iterator
const_iterator = const_row_iterator
 
│ │ │ │ -using iterator = const_iterator
iterator = const_iterator
 
│ │ │ │ -using reference = field
reference = field
 
│ │ │ │ -using pointer = const_row_iterator
pointer = const_row_iterator
 
│ │ │ │ -using const_reverse_iterator = const_reverse_row_iterator
const_reverse_iterator = const_reverse_row_iterator
 
│ │ │ │ -using reverse_iterator = const_reverse_iterator
reverse_iterator = const_reverse_iterator
 
│ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ +  │ │ │ │ │ │ │ │ │ │ │ │ +row &  │ │ │ │ │ │ │ │ │ │ │ │ +row &  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │ +bool  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_iterator  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +const_reverse_row_iterator  │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +reference  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +constexpr size_type  │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ │ │ │ │

│ │ │ │ Public Member Functions

│ │ │ │ - row (row &&) noexcept=default
row (row &&) noexcept=default
 
│ │ │ │ - row (row const &) noexcept=default
row (row const &) noexcept=default
 
│ │ │ │ -row & operator= (row const &) noexcept=default
operator= (row const &) noexcept=default
 
│ │ │ │ -row & operator= (row &&) noexcept=default
operator= (row &&) noexcept=default
 
Comparison
│ │ │ │ -PQXX_PURE bool operator== (row const &) const noexcept
operator== (row const &) const noexcept
 
│ │ │ │ -bool operator!= (row const &rhs) const noexcept
operator!= (row const &rhs) const noexcept
 
│ │ │ │ -const_iterator begin () const noexcept
begin () const noexcept
 
│ │ │ │ -const_iterator cbegin () const noexcept
cbegin () const noexcept
 
│ │ │ │ -const_iterator end () const noexcept
end () const noexcept
 
│ │ │ │ -const_iterator cend () const noexcept
cend () const noexcept
 
Field access
│ │ │ │ -reference front () const noexcept
front () const noexcept
 
│ │ │ │ -reference back () const noexcept
back () const noexcept
 
│ │ │ │ -const_reverse_row_iterator rbegin () const noexcept
rbegin () const noexcept
 
│ │ │ │ -const_reverse_row_iterator crbegin () const noexcept
crbegin () const noexcept
 
│ │ │ │ -const_reverse_row_iterator rend () const noexcept
rend () const noexcept
 
│ │ │ │ -const_reverse_row_iterator crend () const noexcept
crend () const noexcept
 
│ │ │ │ -reference operator[] (size_type) const noexcept
operator[] (size_type) const noexcept
 
reference operator[] (zview col_name) const
reference operator[] (zview col_name) const
 
│ │ │ │ -reference at (size_type) const
at (size_type) const
 
reference at (zview col_name) const
reference at (zview col_name) const
 
│ │ │ │ -constexpr size_type size () const noexcept
size () const noexcept
 
│ │ │ │ -constexpr result::size_type rownumber () const noexcept
rownumber () const noexcept
 Row number, assuming this is a real row and not end()/rend().
 
│ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +class  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -250,80 +250,81 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ +template<typenameTuple > │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │

Column information

│ │ │ │ -class const_row_iterator
const_row_iterator
 
│ │ │ │ -class result
result
 
│ │ │ │ template<typename... T>
class pqxx::internal::result_iter
class pqxx::internal::result_iter
 
│ │ │ │ -class field
field
 
│ │ │ │ result m_result
 Result set of which this is one row.
 
result::size_type m_index = 0
 Row number.
 First column in slice. This row ignores lower-numbered columns.
 
│ │ │ │ size_type m_end = 0
 End column in slice. This row only sees lower-numbered columns.
 
│ │ │ │ -size_type column_number (zview col_name) const
column_number (zview col_name) const
 Number of given column (throws exception if it doesn't exist).
 
│ │ │ │ -oid column_type (size_type) const
column_type (size_type) const
 Return a column's type.
 
│ │ │ │ -oid column_type (zview col_name) const
column_type (zview col_name) const
 Return a column's type.
 
│ │ │ │ -oid column_table (size_type col_num) const
column_table (size_type col_num) const
 What table did this column come from?
 
│ │ │ │ -oid column_table (zview col_name) const
column_table (zview col_name) const
 What table did this column come from?
 
size_type table_column (size_type) const
size_type table_column (size_type) const
 What column number in its table did this result column come from?
 
│ │ │ │ -size_type table_column (zview col_name) const
table_column (zview col_name) const
 What column number in its table did this result column come from?
 
│ │ │ │ -constexpr result::size_type num () const noexcept
num () const noexcept
 
template<typename Tuple >
void to (Tuple &t) const
template<typename Tuple >
void to (Tuple &t) const
 Extract entire row's values into a tuple.
 
template<typename... TYPE>
std::tuple< TYPE... > as () const
std::tuple< TYPE... > as () const
 Extract entire row's values into a tuple.
 
│ │ │ │ -void swap (row &) noexcept
swap (row &) noexcept
 
row slice (size_type sbegin, size_type send) const
row slice (size_type sbegin, size_type send) const
 
│ │ │ │ -PQXX_PURE bool empty () const noexcept
empty () const noexcept
 Is this a row without fields? Can only happen to a slice.
 
 row (result r, result_size_type index, size_type cols) noexcept
 row (result r, result_size_type index, size_type cols) noexcept
 
│ │ │ │ -void check_size (size_type expected) const
check_size (size_type expected) const
 Throw usage_error if row size is not expected.
 
template<typename TUPLE >
TUPLE as_tuple () const
template<typename TUPLE >
TUPLE as_tuple () const
 Convert to a given tuple of values, don't check sizes.
 
│ │ │ │ -template<typename Tuple >
void convert (Tuple &t) const
void convert (Tuple &t) const
 Convert entire row to tuple fields, without checking row size.
 
│ │ │ │

Detailed Description

│ │ │ │

Reference to one row in a result.

│ │ │ │

A row represents one row (also called a row) in a query result set. It also acts as a container mapping column numbers or names to field values (see below):

│ │ │ │ -
cout << row["date"].c_str() << ": " << row["name"].c_str() << endl;
│ │ │ │ +
cout << row["date"].c_str() << ": " << row["name"].c_str() << endl;
│ │ │ │ +
pqxx::const_reverse_row_iterator
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition row.hxx:411
│ │ │ │
pqxx::row
Reference to one row in a result.
Definition row.hxx:47
│ │ │ │

The row itself acts like a (non-modifyable) container, complete with its own const_iterator and const_reverse_iterator.

│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ row()

│ │ │ │ │ │ │ │
│ │ │ │ @@ -409,21 +410,21 @@ │ │ │ │
│ │ │ │ │ │ │ │

◆ as_tuple()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ -template<typename TUPLE >
│ │ │ │ +template<typename TUPLE >
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
TUPLE pqxx::row::as_tuple TUPLE pqxx::row::as_tuple () const
│ │ │ │ 		│ │ │ │ @@ -536,23 +537,23 @@ │ │ │ │ │ │ │ │ │ │ │ │

◆ to()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ -template<typename Tuple >
│ │ │ │ +template<typename Tuple >
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -9,88 +9,88 @@ │ │ │ │ │ [+]Inheritance diagram for pqxx::row: │ │ │ │ │ [Inheritance graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ [+]Collaboration diagram for pqxx::row: │ │ │ │ │ [Collaboration graph] │ │ │ │ │ [_l_e_g_e_n_d] │ │ │ │ │ PPuubblliicc TTyyppeess │ │ │ │ │ -using  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │ +_u_s_i_n_g  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │ +_u_s_i_n_g  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │   │ │ │ │ │ -using  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  ccoonnsstt__rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -using  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │ +_u_s_i_n_g  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   rrooww (_r_o_w &&) noexcept=default │ │ │ │ │ +   rrooww (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ -   rrooww (_r_o_w const &) noexcept=default │ │ │ │ │ +   rrooww (_r_o_w _c_o_n_s_t &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w const &) noexcept=default │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w _c_o_n_s_t &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w &&) noexcept=default │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │   │ │ │ │ │ Comparison │ │ │ │ │ - PQXX_PURE bool  ooppeerraattoorr==== (_r_o_w const &) const noexcept │ │ │ │ │ + PQXX_PURE _b_o_o_l  ooppeerraattoorr==== (_r_o_w _c_o_n_s_t &) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - bool  ooppeerraattoorr!!== (_r_o_w const &rhs) const noexcept │ │ │ │ │ + _b_o_o_l  ooppeerraattoorr!!== (_r_o_w _c_o_n_s_t &_r_h_s) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  bbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  ccbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  eenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ffrroonntt () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ffrroonntt () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  bbaacckk () const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  bbaacckk () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rrbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rrbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrrbbeeggiinn () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rreenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  rreenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrreenndd () const noexcept │ │ │ │ │ + _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r  ccrreenndd () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr[[]] (size_type) const noexcept │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr[[]] (size_type) _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _o_p_e_r_a_t_o_r_[_] (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _o_p_e_r_a_t_o_r_[_] (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  aatt (size_type) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  aatt (size_type) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - constexpr size_type  ssiizzee () const noexcept │ │ │ │ │ + _c_o_n_s_t_e_x_p_r size_type  ssiizzee () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ -constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │ +_c_o_n_s_t_e_x_p_r result::size_type  rroowwnnuummbbeerr () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Row number, assuming this is a real row and not │ │ │ │ │ end()/rend(). │ │ │ │ │   │ │ │ │ │ ********** CCoolluummnn iinnffoorrmmaattiioonn ********** │ │ │ │ │ - class  ccoonnsstt__rrooww__iitteerraattoorr │ │ │ │ │ + _c_l_a_s_s  ccoonnsstt__rrooww__iitteerraattoorr │ │ │ │ │   │ │ │ │ │ - class  rreessuulltt │ │ │ │ │ + _c_l_a_s_s  rreessuulltt │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - class  ppqqxxxx::::iinntteerrnnaall::::rreessuulltt__iitteerr │ │ │ │ │ + _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::rreessuulltt__iitteerr │ │ │ │ │   │ │ │ │ │ - class  ffiieelldd │ │ │ │ │ + _c_l_a_s_s  ffiieelldd │ │ │ │ │   │ │ │ │ │ _r_e_s_u_l_t  mm__rreessuulltt │ │ │ │ │   Result set of which this is one row. │ │ │ │ │   │ │ │ │ │ result::size_type  _m___i_n_d_e_x = 0 │ │ │ │ │   Row number. │ │ │ │ │   │ │ │ │ │ @@ -98,78 +98,81 @@ │ │ │ │ │   First column in slice. This row ignores lower- │ │ │ │ │ numbered columns. │ │ │ │ │   │ │ │ │ │ size_type  mm__eenndd = 0 │ │ │ │ │   End column in slice. This row only sees lower- │ │ │ │ │ numbered columns. │ │ │ │ │   │ │ │ │ │ - size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w col_name) const │ │ │ │ │ + size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (size_type) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (size_type) _c_o_n_s_t │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (size_type col_num) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (size_type _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) const │ │ │ │ │ + size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) _c_o_n_s_t │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ - size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │ + size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ -constexpr result::size_type  nnuumm () const noexcept │ │ │ │ │ +_c_o_n_s_t_e_x_p_r result::size_type  nnuumm () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - void  _t_o (Tuple &t) const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_u_p_l_e > │ │ │ │ │ + _v_o_i_d  _t_o (_T_u_p_l_e &_t) _c_o_n_s_t │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - std::tuple< TYPE... >  _a_s () const │ │ │ │ │ + std::tuple< TYPE... >  _a_s () _c_o_n_s_t │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ - void  sswwaapp (_r_o_w &) noexcept │ │ │ │ │ + _v_o_i_d  sswwaapp (_r_o_w &) _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - _r_o_w  _s_l_i_c_e (size_type sbegin, size_type send) const │ │ │ │ │ + _r_o_w  _s_l_i_c_e (size_type _s_b_e_g_i_n, size_type _s_e_n_d) _c_o_n_s_t │ │ │ │ │   │ │ │ │ │ - PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │ + PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │   Is this a row without fields? Can only happen to a │ │ │ │ │ slice. │ │ │ │ │   │ │ │ │ │ -   _r_o_w (_r_e_s_u_l_t r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e index, size_type │ │ │ │ │ - cols) noexcept │ │ │ │ │ +   _r_o_w (_r_e_s_u_l_t _r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e index, size_type │ │ │ │ │ + _c_o_l_s) _n_o_e_x_c_e_p_t │ │ │ │ │   │ │ │ │ │ - void  cchheecckk__ssiizzee (size_type expected) const │ │ │ │ │ + _v_o_i_d  cchheecckk__ssiizzee (size_type _e_x_p_e_c_t_e_d) _c_o_n_s_t │ │ │ │ │   Throw _u_s_a_g_e___e_r_r_o_r if row size is not expected. │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - TUPLE  _a_s___t_u_p_l_e () const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_U_P_L_E > │ │ │ │ │ + _T_U_P_L_E  _a_s___t_u_p_l_e () _c_o_n_s_t │ │ │ │ │   Convert to a given tuple of values, don't check │ │ │ │ │ sizes. │ │ │ │ │   │ │ │ │ │ -template │ │ │ │ │ - void  ccoonnvveerrtt (Tuple &t) const │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_u_p_l_e > │ │ │ │ │ + _v_o_i_d  ccoonnvveerrtt (_T_u_p_l_e &_t) _c_o_n_s_t │ │ │ │ │   Convert entire row to tuple fields, without │ │ │ │ │ checking row size. │ │ │ │ │   │ │ │ │ │ ********** DDeettaaiilleedd DDeessccrriippttiioonn ********** │ │ │ │ │ Reference to one row in a result. │ │ │ │ │ A row represents one row (also called a row) in a query result set. It also │ │ │ │ │ acts as a container mapping column numbers or names to field values (see │ │ │ │ │ below): │ │ │ │ │ -cout << _r_o_w["date"].c_str() << ": " << _r_o_w["name"].c_str() << endl; │ │ │ │ │ +_c_o_u_t << _r_o_w["date"].c_str() << ": " << _r_o_w["name"].c_str() << _e_n_d_l; │ │ │ │ │ +_p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +Reverse iterator for a row. Use as row::const_reverse_iterator. │ │ │ │ │ +DDeeffiinniittiioonn row.hxx:411 │ │ │ │ │ _p_q_x_x_:_:_r_o_w │ │ │ │ │ Reference to one row in a result. │ │ │ │ │ DDeeffiinniittiioonn row.hxx:47 │ │ │ │ │ The row itself acts like a (non-modifyable) container, complete with its own │ │ │ │ │ const_iterator and const_reverse_iterator. │ │ │ │ │ ********** CCoonnssttrruuccttoorr && DDeessttrruuccttoorr DDooccuummeennttaattiioonn ********** │ │ │ │ │ ********** _?◆_? rrooww(()) ********** │ │ │ │ │ @@ -191,16 +194,16 @@ │ │ │ │ │ Converts to the types of the tuple's respective fields. │ │ │ │ │ The types must have conversions from PostgreSQL's text format defined; see │ │ │ │ │ _S_u_p_p_o_r_t_i_n_g_ _a_d_d_i_t_i_o_n_a_l_ _d_a_t_a_ _t_y_p_e_s. │ │ │ │ │ Exceptions │ │ │ │ │ _u_s_a_g_e___e_r_r_o_r If the number of columns in the row does not match the number │ │ │ │ │ of fields in t. │ │ │ │ │ ********** _?◆_? aass__ttuuppllee(()) ********** │ │ │ │ │ -template │ │ │ │ │ -TUPLE pqxx::row::as_tuple ( ) const inlineprotected │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_U_P_L_E > │ │ │ │ │ +_T_U_P_L_E pqxx::row::as_tuple ( ) const inlineprotected │ │ │ │ │ Convert to a given tuple of values, don't check sizes. │ │ │ │ │ We need this for cases where we have a full tuple of field types, but not a │ │ │ │ │ parameter pack. │ │ │ │ │ ********** _?◆_? aatt(()) ********** │ │ │ │ │ _p_q_x_x_:_:_f_i_e_l_d pqxx::row::at ( _z_v_i_e_w  ccooll__nnaammee ) const │ │ │ │ │ Address field by name. │ │ │ │ │ Warning │ │ │ │ │ @@ -229,16 +232,16 @@ │ │ │ │ │ from a column in a table. If the column is computed in any other way, a │ │ │ │ │ logic_error will be thrown. │ │ │ │ │ Parameters │ │ │ │ │ col_num a zero-based column number in this result set │ │ │ │ │ Returns │ │ │ │ │ a zero-based column number in originating table │ │ │ │ │ ********** _?◆_? ttoo(()) ********** │ │ │ │ │ -template │ │ │ │ │ -void pqxx::row::to ( Tuple &  tt ) const inline │ │ │ │ │ +template<_t_y_p_e_n_a_m_e _T_u_p_l_e > │ │ │ │ │ +_v_o_i_d pqxx::row::to ( _T_u_p_l_e &  tt ) const inline │ │ │ │ │ Extract entire row's values into a tuple. │ │ │ │ │ Converts to the types of the tuple's respective fields. │ │ │ │ │ The types in the tuple must have conversions from PostgreSQL's text format │ │ │ │ │ defined; see _S_u_p_p_o_r_t_i_n_g_ _a_d_d_i_t_i_o_n_a_l_ _d_a_t_a_ _t_y_p_e_s. │ │ │ │ │ Exceptions │ │ │ │ │ _u_s_a_g_e___e_r_r_o_r If the number of columns in the row does not match the number │ │ │ │ │ of fields in t. │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1stream__from.html │ │ │ │ @@ -287,15 +287,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
void pqxx::row::to void pqxx::row::to (Tuple & Tuple & t) const
│ │ │ │ 		│ │ │ │ inline )
│ │ │ │
│ │ │ │ │ │ │ │

Stream all rows in table, all columns.

│ │ │ │ -
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ +
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │

◆ stream_from() [3/7]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -346,15 +346,15 @@ │ │ │ │
│ │ │ │ inline
│ │ │ │
│ │ │ │ │ │ │ │

Stream given columns from all rows in table.

│ │ │ │ -
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ +
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ stream_from() [4/7]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -399,15 +399,15 @@ │ │ │ │
│ │ │ │ inline
│ │ │ │
│ │ │ │ │ │ │ │

Stream given columns from all rows in table.

│ │ │ │ -
Deprecated:
Use factory function query instead.
│ │ │ │ +
Deprecated:
Use factory function query instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ stream_from() [5/7]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -436,15 +436,15 @@ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ -
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ +
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ stream_from() [6/7]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -481,15 +481,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ -
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ +
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ stream_from() [7/7]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -524,15 +524,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ ) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ -
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ +
Deprecated:
Use factories table or raw_table instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │

Member Function Documentation

│ │ │ │ │ │ │ │

◆ complete()

│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1stream__to.html │ │ │ │ @@ -218,15 +218,15 @@ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Create a stream, without specifying columns.

│ │ │ │ -
Deprecated:
Use table or raw_table as a factory.
│ │ │ │ +
Deprecated:
Use table or raw_table as a factory.
│ │ │ │

Fields will be inserted in whatever order the columns have in the database.

│ │ │ │

You'll probably want to specify the columns, so that the mapping between your data fields and the table is explicit in your code, and not hidden in an "implicit contract" between your code and your schema.

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ stream_to() [2/2]

│ │ │ │ @@ -267,15 +267,15 @@ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Create a stream, specifying column names as a container of strings.

│ │ │ │ -
Deprecated:
Use table or raw_table as a factory.
│ │ │ │ +
Deprecated:
Use table or raw_table as a factory.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │

Member Function Documentation

│ │ │ │ │ │ │ │

◆ complete()

│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/datatypes.html │ │ │ │ @@ -93,52 +93,52 @@ │ │ │ │
Supporting additional data types
│ │ │ │
│ │ │ │
│ │ │ │

Communication with the database mostly happens in a text format. When you include an integer value in a query, either you use to_string to convert it to that text format, or under the bonnet, libpqxx does it for you. When you get a query result field "as a float," libpqxx converts from the text format to a floating-point type. These conversions are everywhere in libpqxx.

│ │ │ │

The conversion system supports many built-in types, but it is also extensible. You can "teach" libpqxx (in the scope of your own application) to convert additional types of values to and from PostgreSQL's string format.

│ │ │ │

This is massively useful, but it's not for the faint of heart. You'll need to specialise some templates. And, the API for doing this can change with any major libpqxx release.

│ │ │ │

If that happens, your code may fail to compile with the newer libpqxx version, and you'll have to go through the NEWS file to find the API changes. Usually it'll be a small change, like an additional function you need to implement, or a constant you need to define.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Converting types

│ │ │ │

In your application, a conversion is driven entirely by a C++ type you specify. The value's SQL type on the database side has nothing to do with it. Nor is there anything in the string that would identify its type. Your code says "convert to this type" and libpqxx does it.

│ │ │ │

So, if you've SELECTed a 64-bit integer from the database, and you try to convert it to a C++ short, one of two things will happen: either the number is small enough to fit in your short and it just works, or else it throws a conversion exception. Similarly, if you try to read a 32-bit SQL int as a C++ 32-bit unsigned int, that'll work fine, unless the value happens to be negative. In such cases the conversion will throw a conversion_error.

│ │ │ │

Or, your database table might have a text column, but a given field may contain a string that looks just like a number. You can convert that value to an integer type just fine. Or to a floating-point type. All that matters to the conversion is the actual value, and the type your code specifies.

│ │ │ │

In some cases the templates for these conversions can tell the type from the arguments you pass them:

│ │ │ │
auto x = to_string(99);
│ │ │ │

In other cases you may need to instantiate template explicitly:

│ │ │ │
auto y = from_string<int>("99");
│ │ │ │ -

│ │ │ │ +

│ │ │ │ Supporting a new type

│ │ │ │

Let's say you have some other SQL type which you want to be able to store in, or retrieve from, the database. What would it take to support that?

│ │ │ │

Sometimes you do not need complete support. You might need a conversion to a string but not from a string, for example. You write out the conversion at compile time, so don't be too afraid to be incomplete. If you leave out one of these steps, it's not going to crash at run time or mess up your data. The worst that can happen is that your code won't build.

│ │ │ │

So what do you need for a complete conversion?

│ │ │ │

First off, of course, you need a C++ type. It may be your own, but it doesn't have to be. It could be a type from a third-party library, or even one from the standard library that libpqxx does not yet support.

│ │ │ │

First thing to do is specialise the pqxx::type_name variable to give the type a human-readable name. That allows libpqxx error messages and such to talk about the type. If you don't define a name, libpqxx will try to figure one out with some help from the compiler, but it may not always be easy to read.

│ │ │ │

Then, does your type have a built-in null value? For example, a char * can be null on the C++ side. Or some types are always null, such as nullptr. You specialise the pqxx::nullness template to specify the details.

│ │ │ │

Finally, you specialise the pqxx::string_traits template. This is where you define the actual conversions.

│ │ │ │

Let's go through these steps one by one.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Your type

│ │ │ │

You'll need a type for which the conversions are not yet defined, because the C++ type is what determines the right conversion. One type, one set of conversions.

│ │ │ │

The type doesn't have to be one that you create. The conversion logic was designed such that you can build it around any type. So you can just as easily build a conversion for a type that's defined somewhere else. There's no need to include any special methods or other members inside the type itself. That's also why libpqxx can convert built-in types like int.

│ │ │ │

By the way, if the type is an enum, you don't need to do any of this. Just invoke the preprocessor macro PQXX_DECLARE_ENUM_CONVERSION, from the global namespace near the top of your translation unit, and pass the type as an argument.

│ │ │ │

The library also provides specialisations for std::optional<T>, std::shared_ptr<T>, and std::unique_ptr<T>. If you have conversions for T, you'll also automatically have conversions for those.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Specialise <tt>type_name</tt>

│ │ │ │

When errors happen during conversion, libpqxx will compose error messages for the user. Sometimes these will include the name of the type that's being converted.

│ │ │ │

To tell libpqxx the name of each type, there's a template variable called pqxx::type_name. For any given type T, it should have a specialisation that provides that T's human-readable name:

│ │ │ │
// T is your type.
│ │ │ │
namespace pqxx
│ │ │ │
{
│ │ │ │
template<> std::string const type_name<T>{"My T type's name"};
│ │ │ │
}
│ │ │ │
pqxx
The home of all libpqxx classes, functions, templates, etc.
Definition array.cxx:27
│ │ │ │

(Yes, this means that you need to define something inside the pqxx namespace. Future versions of libpqxx may move this into a separate namespace.)

│ │ │ │

Define this early on in your translation unit, before any code that might cause libpqxx to need the name. That way, the libpqxx code which needs to know the type's name can see your definition.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Specialise <tt>nullness</tt>

│ │ │ │

A struct template pqxx::nullness defines whether your type has a natural "null value" built in. If so, it also provides member functions for producing and recognising null values.

│ │ │ │

The simplest scenario is also the most common: most types don't have a null value built in. There is no "null `int`" in C++. In that kind of case, just derive your nullness traits from pqxx::no_null as a shorthand:

│ │ │ │
// T is your type.
│ │ │ │
namespace pqxx
│ │ │ │
{
│ │ │ │
template<> struct nullness<T> : pqxx::no_null<T> {};
│ │ │ │ @@ -172,15 +172,15 @@ │ │ │ │
}
│ │ │ │
pqxx::nullness::is_null
static bool is_null(TYPE const &value)
Is value a null?
│ │ │ │
pqxx::nullness::null
static TYPE null()
Return a null value.
│ │ │ │
pqxx::nullness::has_null
static bool has_null
Does this type have a null value?
Definition strconv.hxx:93
│ │ │ │
pqxx::nullness::always_null
static bool always_null
Is this type always null?
Definition strconv.hxx:96
│ │ │ │

You may be wondering why there's a function to produce a null value, but also a function to check whether a value is null. Why not just compare the value to the result of null()? Because two null values may not be equal (like in SQL, where NULL <> NULL). Or T may have multiple different null values. Or T may override the comparison operator to behave in some unusual way.

│ │ │ │

As a third case, your type may be one that always represents a null value. This is the case for std::nullptr_t and std::nullopt_t. In that case, you set nullness<TYPE>::always_null to true (as well as has_null of course), and you won't need to define any actual conversions.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Specialise <tt>string_traits</tt>

│ │ │ │

This part is the most work. You can skip it for types that are always null, but those will be rare.

│ │ │ │

The APIs for doing this are designed so that you don't need to allocate memory on the free store, also known as "the heap": new/delete. Memory allocation can be hidden inside std::string, std::vector, etc. The conversion API allows you to use std::string for convenience, or memory buffers for speed.

│ │ │ │

Start by specialising the pqxx::string_traits template. You don't absolutely have to implement all parts of this API. Generally, if it compilers, you're OK for the time being. Just bear in mind that future libpqxx versions may change the API — or how it uses the API internally.

│ │ │ │
namespace pqxx
│ │ │ │
{
│ │ │ │
// T is your type.
│ │ │ │ @@ -211,22 +211,22 @@ │ │ │ │
pqxx::string_traits::from_string
static TYPE from_string(std::string_view text)
Parse a string representation of a TYPE value.
│ │ │ │
pqxx::string_traits::size_buffer
static std::size_t size_buffer(TYPE const &value) noexcept
Estimate how much buffer space is needed to represent value.
│ │ │ │
pqxx::string_traits::to_buf
static zview to_buf(char *begin, char *end, TYPE const &value)
Return a string_view representing value, plus terminating zero.
│ │ │ │
pqxx::string_traits::converts_to_string
static constexpr bool converts_to_string
Is conversion from TYPE to strings supported?
Definition strconv.hxx:159
│ │ │ │
pqxx::string_traits::into_buf
static char * into_buf(char *begin, char *end, TYPE const &value)
Write value's string representation into buffer at begin.
│ │ │ │
pqxx::string_traits::converts_from_string
static constexpr bool converts_from_string
Is conversion from string_view to TYPE supported?
Definition strconv.hxx:165
│ │ │ │

You'll also need to write those member functions, or as many of them as needed to get your code to build.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ <tt>from_string</tt>

│ │ │ │

We start off simple: from_string parses a string as a value of T, and returns that value.

│ │ │ │

The string may or may not be zero-terminated; it's just the string_view from beginning to end (with end being exclusive). In your tests, be sure to cover cases where the string does not end in a zero byte!

│ │ │ │

It's perfectly possible that the string doesn't actually represent a T value. Mistakes happen. There can be corner cases. When you run into this, throw a pqxx::conversion_error.

│ │ │ │

(Of course it's also possible that you run into some other error, so it's fine to throw different exceptions as well. But when it's definitely "this is not │ │ │ │ the right format for a `T`," throw conversion_error.)

│ │ │ │ -

│ │ │ │ +

│ │ │ │ <tt>to_buf</tt>

│ │ │ │

In this function, you convert a value of T into a string that the postgres server will understand.

│ │ │ │

The caller will provide you with a buffer where you can write the string, if you need it: from begin to end exclusive. It's a half-open interval, so don't access *end.

│ │ │ │

If the buffer is insufficient for you to do the conversion, throw a pqxx::conversion_overrun. It doesn't have to be exact: you can be a little pessimistic and demand a bit more space than you need. Just be sure to throw the exception if there's any risk of overrunning the buffer.

│ │ │ │

You don't have to use the buffer for this function though. For example, pqxx::string_traits<bool>::to_buf returns a compile-time constant string and completely ignores the buffer.

│ │ │ │

Even if you do use the buffer, your string does not have to start at the beginning of the buffer. For example, the integer conversions may work from right to left, if that's easier: they can start by writing the least significant digit to the end of the buffer, divide the remainder by 10, and repeat for the next digit.

│ │ │ │

Return a pqxx::zview. This is basically a std::string_view, but with one difference: when you create a zview you guarantee that there is a valid zero byte right after the string_view. The zero byte does not count as part of its size, but it has to be there.

│ │ │ │ @@ -234,36 +234,36 @@ │ │ │ │
void invariant(zview z)
│ │ │ │
{
│ │ │ │
assert(z[std::size(z)] == 0);
│ │ │ │
}
│ │ │ │

The trailing zero should not go inside the zview, but if you convert into the buffer, do make sure you that trailing stays inside the buffer, i.e. before the end. (If there's no room for that zero inside the buffer, throw pqxx::conversion_error).

│ │ │ │

Beware of locales when converting. If you use standard library features like sprintf, they may obey whatever locale is currently set on the system where the code runs. That means that a simple integer like 1000000 may come out as "1000000" on your system, but as "1,000,000" on mine, or as "1.000.000" for somebody else, and on an Indian system it may be "1,00,000". Don't let that happen, or it will confuse things. Use only non-locale-sensitive library functions. Values coming from or going to the database should be in fixed, non-localised formats.

│ │ │ │

If your conversions need to deal with fields in types that libpqxx already supports, you can use the conversion functions for those: pqxx::from_string, pqxx::to_string, pqxx::to_buf. They in turn will call the string_traits specialisations for those types. Or, you can call their string_traits directly.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ <tt>into_buf</tt>

│ │ │ │

This is a stricter version of to_buf. All the same requirements apply, but in addition you must write your string into the given buffer, starting exactly at begin.

│ │ │ │

That's why this function returns just a simple pointer: the address right behind the trailing zero. If the caller wants to use the string, they can find it at begin. If they want to write another value into the rest of the buffer, they can continue writing at the location you returned.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ <tt>size_buffer</tt>

│ │ │ │

Here you estimate how much buffer space you need for converting a T to a string. Be precise if you can, but pessimistic if you must. It's usually better to waste a few bytes of space than to spend a lot of time computing the exact buffer space you need. And failing the conversion because you under-budgeted the buffer is worst of all.

│ │ │ │

Include the trailing zero in the buffer size. If your to_buf takes more space than just what's needed to store the result, include that too.

│ │ │ │

Make size_buffer a constexpr function if you can. It can allow the caller to allocate the buffer on the stack, with a size known at compile time.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Optional: Specialise <tt>is_unquoted_safe</tt>

│ │ │ │

When converting arrays or composite values to strings, libpqxx may need to quote values and escape any special characters. This takes time.

│ │ │ │

Some types though, such as integral or floating-point types, can never have any special characters such as quotes, commas, or backslashes in their string representations. In such cases, there's no need to quote or escape such values in SQL arrays or composite types.

│ │ │ │

If your type is like that, you can tell libpqxx about this by defining:

│ │ │ │
namespace pqxx
│ │ │ │
{
│ │ │ │
// T is your type.
│ │ │ │
template<> inline constexpr bool is_unquoted_safe<T>{true};
│ │ │ │
}
│ │ │ │

The code that converts this type of field to strings in an array or a composite type can then use a simpler, more efficient variant of the code. It's always safe to leave this out; it's just an optimisation for when you're completely sure that it's safe.

│ │ │ │

Do not do this if a string representation of your type may contain a comma; semicolon; parenthesis; brace; quote; backslash; newline; or any other character that might need escaping.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Optional: Specialise <tt>param_format</tt>

│ │ │ │

This one you don't generally need to worry about. Read on if you're writing a type which represents raw binary data, or if you're writing a template where some specialisations may contain raw binary data.

│ │ │ │

When you call parameterised statements, or prepared statements with parameters, libpqxx needs to pass your parameters on to libpq, the underlying C-level PostgreSQL client library.

│ │ │ │

There are two formats for doing that: text and binary. In the first, we represent all values as strings in the PostgreSQL text format, and the server then converts them into its own internal binary representation. That's what those string conversions above are all about, and it's what we do for almost all types of parameters.

│ │ │ │

But we do it differently when the parameter is a contiguous series of raw bytes and the corresponding SQL type is BYTEA. There is a text format for those, but we bypass it for efficiency. The server can use the binary data in the exact same form, without any conversion or extra processing. The binary data is also twice as compact during transport.

│ │ │ │

(People sometimes ask why we can't just treat all types as binary. However the general case isn't so clear-cut. The binary formats are not documented, there are no guarantees that they will be platform-independent or that they will remain stable across postgres releases, and there's no really solid way to detect when we might get the format wrong. On top of all that, the conversions aren't necessarily as straightforward and efficient as they sound. So, for the general case, libpqxx sticks with the text formats. Raw binary data alone stands out as a clear win.)

│ │ │ │

Long story short, the machinery for passing parameters needs to know: is this parameter a binary string, or not? In the normal case it can assume "no," and that's what it does. The text format is always a safe choice; we just try to use the binary format where it's faster.

│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/deprecated.html │ │ │ │ @@ -95,83 +95,83 @@ │ │ │ │
│ │ │ │
│ │ │ │
Class pqxx::array_parser
│ │ │ │
Use pqxx::array instead.
│ │ │ │
Class pqxx::basic_fieldstream< CHAR, TRAITS >
│ │ │ │
To convert a field's value string to some other type, e.g. to an int, use the field's as<...>() member function. To read a field efficiently just as a string, use its c_str() or its as<std::string_vview>().
│ │ │ │
Class pqxx::basic_ilostream< CHAR, TRAITS >
│ │ │ │ -
Access large objects directly using the blob class.
│ │ │ │ +
Access large objects directly using the blob class.
│ │ │ │
Class pqxx::basic_lostream< CHAR, TRAITS >
│ │ │ │ -
Access large objects directly using the blob class.
│ │ │ │ -
Class pqxx::basic_olostream< CHAR, TRAITS >
│ │ │ │
Access large objects directly using the blob class.
│ │ │ │ +
Class pqxx::basic_olostream< CHAR, TRAITS >
│ │ │ │ +
Access large objects directly using the blob class.
│ │ │ │
Class pqxx::binarystring
│ │ │ │
Use bytes and bytes_view for binary data. In C++20 or better, any contiguous_range of std::byte will do.
│ │ │ │
Member pqxx::blob::read (std::vector< std::byte, ALLOC > &buf)
│ │ │ │
As libpqxx moves to C++20 as its baseline language version, this will take and return std::span<std::byte>.
│ │ │ │
Member pqxx::connection::get_errorhandlers () const
│ │ │ │
Return pointers to the active errorhandlers.
│ │ │ │
Member pqxx::connection::set_variable (std::string_view var, std::string_view value) &
│ │ │ │
To set a session variable, use set_session_var. To set a transaction-local variable, execute an SQL SET command.
│ │ │ │
Member pqxx::connection_base
│ │ │ │
Old base class for connection. They are now the same class.
│ │ │ │
Member pqxx::encrypt_password (zview user, zview password)
│ │ │ │ -
Use connection::encrypt_password instead.
│ │ │ │ +
Use connection::encrypt_password instead.
│ │ │ │
Member pqxx::encrypt_password (char const user[], char const password[])
│ │ │ │
Use connection::encrypt_password instead.
│ │ │ │
Class pqxx::errorhandler
│ │ │ │ -
Base class for obsolete error-handler callbacks.
│ │ │ │ +
Base class for obsolete error-handler callbacks.
│ │ │ │
Member pqxx::fieldstream
│ │ │ │
Read a field using field::as<...>() or field::c_str().
│ │ │ │
Member pqxx::from_query
│ │ │ │
Use transaction_base::stream instead of stream_from.
│ │ │ │
Struct pqxx::from_query_t
│ │ │ │
Use stream_from::query() instead.
│ │ │ │
Member pqxx::from_table
│ │ │ │
Use transaction_base::stream instead of stream_from.
│ │ │ │
Struct pqxx::from_table_t
│ │ │ │
Use stream_from::table() instead.
│ │ │ │
Class pqxx::internal::dynamic_params< IT, ACCESSOR >
│ │ │ │
Use params instead.
│ │ │ │
Class pqxx::largeobject
│ │ │ │ -
Use the blob class instead.
│ │ │ │ +
Use the blob class instead.
│ │ │ │
Class pqxx::largeobject_streambuf< CHAR, TRAITS >
│ │ │ │ -
Access large objects directly using the blob class.
│ │ │ │ +
Access large objects directly using the blob class.
│ │ │ │
Class pqxx::largeobjectaccess
│ │ │ │ -
Use the blob class instead.
│ │ │ │ +
Use the blob class instead.
│ │ │ │
Member pqxx::operator<< (std::basic_ostream< CHAR > &s, field const &value)
│ │ │ │
The C++ streams library is not great to work with. In particular, error handling is easy to get wrong. So you're probably better off doing this by hand.
│ │ │ │
Member pqxx::params::append (binarystring const &value) &
│ │ │ │
Append binarystring parameter.
│ │ │ │
Namespace pqxx::prepare
│ │ │ │ -
The new params class replaces all of this.
│ │ │ │ +
The new params class replaces all of this.
│ │ │ │
Class pqxx::quiet_errorhandler
│ │ │ │
Use a notice handler instead.
│ │ │ │
Member pqxx::row::slice (size_type sbegin, size_type send) const
│ │ │ │
I haven't heard of anyone caring about row slicing at all in at least the last 15 years. Yet it adds complexity, so unless anyone files a bug explaining why they really need this feature, I'm going to remove it. Even if they do, the feature may need an update.
│ │ │ │
Class pqxx::stream_from
│ │ │ │
Use transaction_base::stream.
│ │ │ │ -
Member pqxx::stream_from::stream_from (transaction_base &, from_table_t, std::string_view table, Iter columns_begin, Iter columns_end)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &tx, from_table_t, std::string_view table, Columns const &columns)
│ │ │ │ -
Use factory function query instead.
│ │ │ │ +
Use factory function query instead.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &tx, std::string_view table)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │ +
Use factories table or raw_table instead.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &tx, std::string_view table, Columns const &columns)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │ +
Use factories table or raw_table instead.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &, std::string_view table, Iter columns_begin, Iter columns_end)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │ -
Member pqxx::stream_from::stream_from (transaction_base &, from_table_t, std::string_view table)
│ │ │ │ +
Use factories table or raw_table instead.
│ │ │ │ +
Member pqxx::stream_from::stream_from (transaction_base &, from_table_t, std::string_view table, Iter columns_begin, Iter columns_end)
│ │ │ │
Use factories table or raw_table instead.
│ │ │ │ +
Member pqxx::stream_from::stream_from (transaction_base &, from_table_t, std::string_view table)
│ │ │ │ +
Use factories table or raw_table instead.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &, from_query_t, std::string_view query)
│ │ │ │
Use factory function query instead.
│ │ │ │ -
Member pqxx::stream_to::stream_to (transaction_base &, std::string_view table_name, Columns const &columns)
│ │ │ │ -
Use table or raw_table as a factory.
│ │ │ │
Member pqxx::stream_to::stream_to (transaction_base &tx, std::string_view table_name)
│ │ │ │ -
Use table or raw_table as a factory.
│ │ │ │ +
Use table or raw_table as a factory.
│ │ │ │ +
Member pqxx::stream_to::stream_to (transaction_base &, std::string_view table_name, Columns const &columns)
│ │ │ │ +
Use table or raw_table as a factory.
│ │ │ │
Member pqxx::strip_t
│ │ │ │
In C++20 we'll replace this with std::remove_cvref.
│ │ │ │
Member pqxx::transaction_base::set_variable (std::string_view var, std::string_view value)
│ │ │ │
To set a transaction-local variable, execute an SQL SET command. To set a session variable, use the connection's set_session_var function.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ ├── html2text {} │ │ │ │ │ @@ -67,41 +67,41 @@ │ │ │ │ │ Member _p_q_x_x_:_:_r_o_w_:_:_s_l_i_c_e (size_type sbegin, size_type send) const │ │ │ │ │ I haven't heard of anyone caring about row slicing at all in at least the │ │ │ │ │ last 15 years. Yet it adds complexity, so unless anyone files a bug │ │ │ │ │ explaining why they really need this feature, I'm going to remove it. │ │ │ │ │ Even if they do, the feature may need an update. │ │ │ │ │ Class _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m │ │ │ │ │ Use _t_r_a_n_s_a_c_t_i_o_n___b_a_s_e_:_:_s_t_r_e_a_m. │ │ │ │ │ - Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, _f_r_o_m___t_a_b_l_e___t, │ │ │ │ │ - std::string_view table, Iter columns_begin, Iter columns_end) │ │ │ │ │ - Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &tx, _f_r_o_m___t_a_b_l_e___t, │ │ │ │ │ std::string_view table, Columns const &columns) │ │ │ │ │ Use factory function _q_u_e_r_y instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &tx, std::string_view │ │ │ │ │ table) │ │ │ │ │ Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &tx, std::string_view │ │ │ │ │ table, Columns const &columns) │ │ │ │ │ Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, std::string_view │ │ │ │ │ table, Iter columns_begin, Iter columns_end) │ │ │ │ │ Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, _f_r_o_m___t_a_b_l_e___t, │ │ │ │ │ + std::string_view table, Iter columns_begin, Iter columns_end) │ │ │ │ │ + Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ + Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, _f_r_o_m___t_a_b_l_e___t, │ │ │ │ │ std::string_view table) │ │ │ │ │ Use factories _t_a_b_l_e or _r_a_w___t_a_b_l_e instead. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___f_r_o_m_:_:_s_t_r_e_a_m___f_r_o_m (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, _f_r_o_m___q_u_e_r_y___t, │ │ │ │ │ std::string_view query) │ │ │ │ │ Use factory function _q_u_e_r_y instead. │ │ │ │ │ - Member _p_q_x_x_:_:_s_t_r_e_a_m___t_o_:_:_s_t_r_e_a_m___t_o (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, std::string_view │ │ │ │ │ - table_name, Columns const &columns) │ │ │ │ │ - Use _t_a_b_l_e or _r_a_w___t_a_b_l_e as a factory. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_e_a_m___t_o_:_:_s_t_r_e_a_m___t_o (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &tx, std::string_view │ │ │ │ │ table_name) │ │ │ │ │ Use _t_a_b_l_e or _r_a_w___t_a_b_l_e as a factory. │ │ │ │ │ + Member _p_q_x_x_:_:_s_t_r_e_a_m___t_o_:_:_s_t_r_e_a_m___t_o (_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e &, std::string_view │ │ │ │ │ + table_name, Columns const &columns) │ │ │ │ │ + Use _t_a_b_l_e or _r_a_w___t_a_b_l_e as a factory. │ │ │ │ │ Member _p_q_x_x_:_:_s_t_r_i_p___t │ │ │ │ │ In C++20 we'll replace this with std::remove_cvref. │ │ │ │ │ Member _p_q_x_x_:_:_t_r_a_n_s_a_c_t_i_o_n___b_a_s_e_:_:_s_e_t___v_a_r_i_a_b_l_e (std::string_view var, std:: │ │ │ │ │ string_view value) │ │ │ │ │ To set a transaction-local variable, execute an SQL SET command. To set a │ │ │ │ │ session variable, use the connection's set_session_var function. │ │ │ │ │ * Generated by _[_d_o_x_y_g_e_n_]1.9.8 │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/escaping.html │ │ │ │ @@ -95,30 +95,30 @@ │ │ │ │
│ │ │ │

Writing queries as strings is easy. But sometimes you need a variable in there: ‘"SELECT id FROM user WHERE name = &rsquo;" + name + "'"`.

│ │ │ │

This is dangerous. See the bug? If name can contain quotes, you may have an SQL injection vulnerability there, where users can enter nasty stuff like "`.'; DROP TABLE user`". Or if you're lucky, it's just a nasty bug that you discover when name happens to be "d'Arcy". Or... Well, I was born in a place called _'s-Gravenhage..._

│ │ │ │

There are two ways of dealing with this. One is statement Statement parameters — many SQL execution functions in libpqxx let you write placeholders for variable values in your SQL, like $1, $2, etc. When you then pass your variables as the parameter values, they get substituted into the query, but in a safe form.

│ │ │ │

The other is to escape the values yourself, before inserting them into your SQL. This isn't as safe as using parameters, since you need to be really conscientious about it. Use Statement parameters if you can... and libpqxx will do the escaping for you.

│ │ │ │

In escaping, quotes and other problematic characters are marked as "this is │ │ │ │ just a character inside the string, not the end of the string." There are several functions in libpqxx to do this for you.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ SQL injection

│ │ │ │

To understand what SQL injection vulnerabilities are and why they should be prevented, imagine you use the following SQL statement somewhere in your program:

│ │ │ │
tx.exec(
│ │ │ │
"SELECT number, amount "
│ │ │ │
"FROM account "
│ │ │ │
"WHERE allowed_to_see('" + userid + "','" + password + "')");
│ │ │ │

This shows a logged-in user important information on all accounts he is authorized to view. The userid and password strings are variables entered by the user himself.

│ │ │ │

Now, if the user is actually an attacker who knows (or can guess) the general shape of this SQL statement, imagine getting the following password:

│ │ │ │
x') OR ('x' = 'x
│ │ │ │

Does that make sense to you? Probably not. But if this is inserted into the SQL string by the C++ code above, the query becomes:

│ │ │ │
SELECT number, amount
│ │ │ │
FROM account
│ │ │ │
WHERE allowed_to_see('user','x') OR ('x' = 'x')
│ │ │ │

Is this what you wanted to happen? Probably not! The neat allowed_to_see() clause is completely circumvented by the "`OR ('x' = 'x')`" clause, which is always true. Therefore, the attacker will get to see all accounts in the database!

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Using the esc functions

│ │ │ │

Here's how you can fix the problem in the example above:

│ │ │ │
tx.exec(
│ │ │ │
"SELECT number, amount "
│ │ │ │
"FROM account "
│ │ │ │
"WHERE allowed_to_see('" + tx.esc(userid) + "', "
│ │ │ │
"'" + tx.esc(password) + "')");
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/namespacepqxx.html │ │ │ │ @@ -1525,15 +1525,15 @@ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Encrypt password.

│ │ │ │ -
Deprecated:
Use connection::encrypt_password instead.
│ │ │ │ +
Deprecated:
Use connection::encrypt_password instead.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ from_string()

│ │ │ │ │ │ │ │
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/namespacepqxx_1_1prepare.html │ │ │ │ @@ -90,15 +90,15 @@ │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │
pqxx::prepare Namespace Reference
│ │ │ │
│ │ │ │
│ │ │ │

Detailed Description

│ │ │ │ -
Deprecated:
The new params class replaces all of this.
│ │ │ │ +
Deprecated:
The new params class replaces all of this.
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │
93} // namespace pqxx::internal
│ │ │ │
94
│ │ │ │
95
│ │ │ │
│ │ │ │ -
96template<typename... TYPE> inline auto pqxx::result::iter() const
│ │ │ │ +
96template<typename... TYPE> inline auto pqxx::result::iter() const
│ │ │ │
97{
│ │ │ │ -
98 return pqxx::internal::result_iteration<TYPE...>{*this};
│ │ │ │ +
98 return pqxx::internal::result_iteration<TYPE...>{*this};
│ │ │ │
99}
│ │ │ │
│ │ │ │
100
│ │ │ │
101
│ │ │ │
102template<typename CALLABLE>
│ │ │ │
│ │ │ │ -
103inline void pqxx::result::for_each(CALLABLE &&func) const
│ │ │ │ +
103inline void pqxx::result::for_each(CALLABLE &&func) const
│ │ │ │
104{
│ │ │ │ -
105 using args_tuple = internal::args_t<decltype(func)>;
│ │ │ │ -
106 constexpr auto sz{std::tuple_size_v<args_tuple>};
│ │ │ │ +
105 using args_tuple = internal::args_t<decltype(func)>;
│ │ │ │ +
106 constexpr auto sz{std::tuple_size_v<args_tuple>};
│ │ │ │
107 static_assert(
│ │ │ │ -
108 sz > 0,
│ │ │ │ +
108 sz > 0,
│ │ │ │
109 "Callback for for_each must take parameters, one for each column in the "
│ │ │ │
110 "result.");
│ │ │ │
111
│ │ │ │ -
112 auto const cols{this->columns()};
│ │ │ │ -
113 if (sz != cols)
│ │ │ │ +
112 auto const cols{this->columns()};
│ │ │ │ +
113 if (sz != cols)
│ │ │ │
114 throw usage_error{internal::concat(
│ │ │ │ -
115 "Callback to for_each takes ", sz, "parameter", (sz == 1) ? "" : "s",
│ │ │ │ -
116 ", but result set has ", cols, "field", (cols == 1) ? "" : "s", ".")};
│ │ │ │ +
115 "Callback to for_each takes ", sz, "parameter", (sz == 1) ? "" : "s",
│ │ │ │ +
116 ", but result set has ", cols, "field", (cols == 1) ? "" : "s", ".")};
│ │ │ │
117
│ │ │ │ -
118 using pass_tuple = pqxx::internal::strip_types_t<args_tuple>;
│ │ │ │ -
119 for (auto const r : *this) std::apply(func, r.as_tuple<pass_tuple>());
│ │ │ │ +
118 using pass_tuple = pqxx::internal::strip_types_t<args_tuple>;
│ │ │ │ +
119 for (auto const r : *this) std::apply(func, r.as_tuple<pass_tuple>());
│ │ │ │
120}
│ │ │ │
│ │ │ │
121#endif
│ │ │ │ +
pqxx::const_reverse_result_iterator
Reverse iterator for result. Use as result::const_reverse_iterator.
Definition result_iterator.hxx:196
│ │ │ │
pqxx::internal::result_iter
Iterator for looped unpacking of a result.
Definition result_iter.hxx:27
│ │ │ │
pqxx::internal::result_iter::result_iter
result_iter()=default
Construct an "end" iterator.
│ │ │ │
pqxx::internal::result_iter::operator==
bool operator==(result_iter const &rhs) const
Comparison only works for comparing to end().
Definition result_iter.hxx:53
│ │ │ │
pqxx::internal::result_iteration
Definition result_iter.hxx:72
│ │ │ │
pqxx::result
Result set containing data returned by a query or command.
Definition result.hxx:92
│ │ │ │
pqxx::result::for_each
void for_each(CALLABLE &&func) const
Run func on each row, passing the row's fields as parameters.
Definition result_iter.hxx:103
│ │ │ │
pqxx::result::expect_columns
result expect_columns(row_size_type cols) const
Expect that result consists of exactly cols columns.
Definition result.hxx:363
│ │ │ │ ├── html2text {} │ │ │ │ │ @@ -85,40 +85,43 @@ │ │ │ │ │ 89 │ │ │ │ │ 90private: │ │ │ │ │ 91 _p_q_x_x_:_:_r_e_s_u_l_t const m_home; │ │ │ │ │ 92}; │ │ │ │ │ 93} // namespace pqxx::internal │ │ │ │ │ 94 │ │ │ │ │ 95 │ │ │ │ │ -_9_6template inline auto _p_q_x_x_:_:_r_e_s_u_l_t_:_:_i_t_e_r() const │ │ │ │ │ +_9_6template inline auto _p_q_x_x_:_:_r_e_s_u_l_t_:_:_i_t_e_r() const │ │ │ │ │ 97{ │ │ │ │ │ -98 return _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r_a_t_i_o_n{*this}; │ │ │ │ │ +98 return _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r_a_t_i_o_n<_T_Y_P_E...>{*this}; │ │ │ │ │ 99} │ │ │ │ │ 100 │ │ │ │ │ 101 │ │ │ │ │ 102template │ │ │ │ │ -_1_0_3inline void _p_q_x_x_:_:_r_e_s_u_l_t_:_:_f_o_r___e_a_c_h(CALLABLE &&func) const │ │ │ │ │ +_1_0_3inline void _p_q_x_x_:_:_r_e_s_u_l_t_:_:_f_o_r___e_a_c_h(_C_A_L_L_A_B_L_E &&_f_u_n_c) const │ │ │ │ │ 104{ │ │ │ │ │ -105 using args_tuple = _i_n_t_e_r_n_a_l_:_:_a_r_g_s___t; │ │ │ │ │ -106 constexpr auto sz{std::tuple_size_v}; │ │ │ │ │ +105 using _a_r_g_s___t_u_p_l_e = _i_n_t_e_r_n_a_l_:_:_a_r_g_s___t; │ │ │ │ │ +106 constexpr auto _s_z{std::tuple_size_v}; │ │ │ │ │ 107 static_assert( │ │ │ │ │ -108 sz > 0, │ │ │ │ │ +108 _s_z > 0, │ │ │ │ │ 109 "Callback for for_each must take parameters, one for each column in the " │ │ │ │ │ 110 "result."); │ │ │ │ │ 111 │ │ │ │ │ -112 auto const cols{this->columns()}; │ │ │ │ │ -113 if (sz != cols) │ │ │ │ │ +112 auto const _c_o_l_s{this->columns()}; │ │ │ │ │ +113 if (_s_z != _c_o_l_s) │ │ │ │ │ 114 throw _u_s_a_g_e___e_r_r_o_r{_i_n_t_e_r_n_a_l_:_:_c_o_n_c_a_t( │ │ │ │ │ -115 "Callback to for_each takes ", sz, "parameter", (sz == 1) ? "" : "s", │ │ │ │ │ -116 ", but result set has ", cols, "field", (cols == 1) ? "" : "s", ".")}; │ │ │ │ │ +115 "Callback to for_each takes ", _s_z, "parameter", (_s_z == 1) ? "" : "s", │ │ │ │ │ +116 ", but result set has ", _c_o_l_s, "field", (_c_o_l_s == 1) ? "" : "s", ".")}; │ │ │ │ │ 117 │ │ │ │ │ -118 using pass_tuple = _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_s_t_r_i_p___t_y_p_e_s___t_<_a_r_g_s___t_u_p_l_e_>; │ │ │ │ │ -119 for (auto const r : *this) std::apply(func, r.as_tuple()); │ │ │ │ │ +118 using _p_a_s_s___t_u_p_l_e = _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_s_t_r_i_p___t_y_p_e_s___t_<_a_r_g_s___t_u_p_l_e_>; │ │ │ │ │ +119 for (auto const _r : *this) std::apply(_f_u_n_c, _r.as_tuple<_p_a_s_s___t_u_p_l_e>()); │ │ │ │ │ 120} │ │ │ │ │ 121#endif │ │ │ │ │ +_p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ +Reverse iterator for result. Use as result::const_reverse_iterator. │ │ │ │ │ +DDeeffiinniittiioonn result_iterator.hxx:196 │ │ │ │ │ _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r │ │ │ │ │ Iterator for looped unpacking of a result. │ │ │ │ │ DDeeffiinniittiioonn result_iter.hxx:27 │ │ │ │ │ _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r_:_:_r_e_s_u_l_t___i_t_e_r │ │ │ │ │ result_iter()=default │ │ │ │ │ Construct an "end" iterator. │ │ │ │ │ _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r_:_:_o_p_e_r_a_t_o_r_=_= │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/result__iterator_8hxx_source.html │ │ │ │ @@ -127,32 +127,32 @@ │ │ │ │
28
│ │ │ │
│ │ │ │
32class PQXX_LIBEXPORT const_result_iterator : public row
│ │ │ │
33{
│ │ │ │
34public:
│ │ │ │
35 // TODO: Change operator[] so this becomes a proper random_access_iterator.
│ │ │ │
36 using iterator_category = std::bidirectional_iterator_tag;
│ │ │ │ -
37 using value_type = row const;
│ │ │ │ -
38 using pointer = row const *;
│ │ │ │ +
37 using value_type = row const;
│ │ │ │ +
38 using pointer = row const *;
│ │ │ │
39 using reference = row;
│ │ │ │
40 using size_type = result_size_type;
│ │ │ │
41 using difference_type = result_difference_type;
│ │ │ │
42
│ │ │ │
43#include "pqxx/internal/ignore-deprecated-pre.hxx"
│ │ │ │ -
45 const_result_iterator() noexcept = default;
│ │ │ │ -
47 const_result_iterator(const_result_iterator const &) noexcept = default;
│ │ │ │ -
49 const_result_iterator(const_result_iterator &&) noexcept = default;
│ │ │ │ +
45 const_result_iterator() noexcept = default;
│ │ │ │ +
47 const_result_iterator(const_result_iterator const &) noexcept = default;
│ │ │ │ +
49 const_result_iterator(const_result_iterator &&) noexcept = default;
│ │ │ │
50
│ │ │ │ -
52 const_result_iterator(row const &t) noexcept : row{t} {}
│ │ │ │ +
52 const_result_iterator(row const &t) noexcept : row{t} {}
│ │ │ │
53#include "pqxx/internal/ignore-deprecated-post.hxx"
│ │ │ │
54
│ │ │ │ -
70 [[nodiscard]] pointer operator->() const { return this; }
│ │ │ │ +
70 [[nodiscard]] pointer operator->() const { return this; }
│ │ │ │
71
│ │ │ │
72#include "pqxx/internal/ignore-deprecated-pre.hxx"
│ │ │ │ -
74 [[nodiscard]] reference operator*() const { return *this; }
│ │ │ │ +
74 [[nodiscard]] reference operator*() const { return *this; }
│ │ │ │
75#include "pqxx/internal/ignore-deprecated-post.hxx"
│ │ │ │
77
│ │ │ │
82 using row::back;
│ │ │ │
83 using row::front;
│ │ │ │
84 // TODO: Replace with standard operator[]: i[n] == *(i + n).
│ │ │ │
85 using row::operator[];
│ │ │ │
86 using row::at;
│ │ │ │ @@ -195,18 +195,18 @@ │ │ │ │
128 const_result_iterator &operator-=(difference_type i)
│ │ │ │
129 {
│ │ │ │
130 m_index -= i;
│ │ │ │
131 return *this;
│ │ │ │
132 }
│ │ │ │
133
│ │ │ │
│ │ │ │ -
135 void swap(const_result_iterator &other) noexcept
│ │ │ │ +
135 void swap(const_result_iterator &other) noexcept
│ │ │ │
136 {
│ │ │ │
137#include "pqxx/internal/ignore-deprecated-pre.hxx"
│ │ │ │ -
138 row::swap(other);
│ │ │ │ +
138 row::swap(other);
│ │ │ │
139#include "pqxx/internal/ignore-deprecated-post.hxx"
│ │ │ │
140 }
│ │ │ │
│ │ │ │
142
│ │ │ │
147 [[nodiscard]] bool operator==(const_result_iterator const &i) const
│ │ │ │
148 {
│ │ │ │
149 return m_index == i.m_index;
│ │ │ │ @@ -232,54 +232,54 @@ │ │ │ │
169 return m_index >= i.m_index;
│ │ │ │
170 }
│ │ │ │
172
│ │ │ │
177 [[nodiscard]] inline const_result_iterator operator+(difference_type) const;
│ │ │ │
178 friend const_result_iterator
│ │ │ │
179 operator+(difference_type, const_result_iterator const &);
│ │ │ │
│ │ │ │ -
180 [[nodiscard]] inline const_result_iterator operator-(difference_type) const;
│ │ │ │ -
181 [[nodiscard]] inline difference_type
│ │ │ │ +
180 [[nodiscard]] inline const_result_iterator operator-(difference_type) const;
│ │ │ │ +
181 [[nodiscard]] inline difference_type
│ │ │ │
│ │ │ │
182 operator-(const_result_iterator const &) const;
│ │ │ │
184
│ │ │ │
185private:
│ │ │ │
186 friend class pqxx::result;
│ │ │ │ -
187 const_result_iterator(pqxx::result const *r, result_size_type i) noexcept :
│ │ │ │ -
188 row{*r, i, r->columns()}
│ │ │ │ +
187 const_result_iterator(pqxx::result const *r, result_size_type i) noexcept :
│ │ │ │ +
188 row{*r, i, r->columns()}
│ │ │ │
189 {}
│ │ │ │
190};
│ │ │ │
191
│ │ │ │
192
│ │ │ │
│ │ │ │
194class PQXX_LIBEXPORT const_reverse_result_iterator
│ │ │ │
195 : private const_result_iterator
│ │ │ │
196{
│ │ │ │
197public:
│ │ │ │
198 using super = const_result_iterator;
│ │ │ │
199 using iterator_type = const_result_iterator;
│ │ │ │
200 using iterator_type::difference_type;
│ │ │ │
201 using iterator_type::iterator_category;
│ │ │ │ -
202 using iterator_type::pointer;
│ │ │ │ -
203 using value_type = iterator_type::value_type;
│ │ │ │ +
202 using iterator_type::pointer;
│ │ │ │ +
203 using value_type = iterator_type::value_type;
│ │ │ │
204 using reference = iterator_type::reference;
│ │ │ │
205
│ │ │ │
207 const_reverse_result_iterator() = default;
│ │ │ │ -
209 const_reverse_result_iterator(const_reverse_result_iterator const &rhs) =
│ │ │ │ +
209 const_reverse_result_iterator(const_reverse_result_iterator const &rhs) =
│ │ │ │
210 default;
│ │ │ │
│ │ │ │ -
212 explicit const_reverse_result_iterator(const_result_iterator const &rhs) :
│ │ │ │ -
213 const_result_iterator{rhs}
│ │ │ │ +
212 explicit const_reverse_result_iterator(const_result_iterator const &rhs) :
│ │ │ │ +
213 const_result_iterator{rhs}
│ │ │ │
214 {
│ │ │ │
215 super::operator--();
│ │ │ │
216 }
│ │ │ │
│ │ │ │
217
│ │ │ │
│ │ │ │ -
219 explicit const_reverse_result_iterator(const_result_iterator const &&rhs) :
│ │ │ │ -
220 const_result_iterator{std::move(rhs)}
│ │ │ │ +
219 explicit const_reverse_result_iterator(const_result_iterator const &&rhs) :
│ │ │ │ +
220 const_result_iterator{std::move(rhs)}
│ │ │ │
221 {
│ │ │ │
222 super::operator--();
│ │ │ │
223 }
│ │ │ │
│ │ │ │
224
│ │ │ │
226 [[nodiscard]] PQXX_PURE const_result_iterator base() const noexcept;
│ │ │ │
227
│ │ │ │ @@ -431,14 +431,15 @@ │ │ │ │
pqxx::const_result_iterator::const_result_iterator
const_result_iterator() noexcept=default
Create an iterator, but in an unusable state.
│ │ │ │
pqxx::const_result_iterator::operator*
reference operator*() const
Dereference the iterator.
Definition result_iterator.hxx:74
│ │ │ │
pqxx::const_reverse_result_iterator
Reverse iterator for result. Use as result::const_reverse_iterator.
Definition result_iterator.hxx:196
│ │ │ │
pqxx::const_reverse_result_iterator::const_reverse_result_iterator
const_reverse_result_iterator(const_reverse_result_iterator const &rhs)=default
Copy an iterator.
│ │ │ │
pqxx::const_reverse_result_iterator::const_reverse_result_iterator
const_reverse_result_iterator(const_result_iterator const &rhs)
Copy a reverse iterator from a regular iterator.
Definition result_iterator.hxx:212
│ │ │ │
pqxx::const_reverse_result_iterator::const_reverse_result_iterator
const_reverse_result_iterator(const_result_iterator const &&rhs)
Move a regular iterator into a reverse iterator.
Definition result_iterator.hxx:219
│ │ │ │
pqxx::const_reverse_result_iterator::const_reverse_result_iterator
const_reverse_result_iterator()=default
Create an iterator, but in an unusable state.
│ │ │ │ +
pqxx::const_reverse_row_iterator
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition row.hxx:411
│ │ │ │
pqxx::result
Result set containing data returned by a query or command.
Definition result.hxx:92
│ │ │ │
pqxx::row
Reference to one row in a result.
Definition row.hxx:47
│ │ │ │
pqxx::row::m_result
result m_result
Result set of which this is one row.
Definition row.hxx:249
│ │ │ │
pqxx::row::m_index
result::size_type m_index
Row number.
Definition row.hxx:256
│ │ │ │
pqxx
The home of all libpqxx classes, functions, templates, etc.
Definition array.cxx:27
│ │ │ │
pqxx::result_difference_type
int result_difference_type
Difference between result sizes.
Definition types.hxx:31
│ │ │ │
pqxx::result_size_type
int result_size_type
Number of rows in a result set.
Definition types.hxx:28
│ │ │ │ ├── html2text {} │ │ │ │ │ @@ -33,32 +33,32 @@ │ │ │ │ │ 26{ │ │ │ │ │ 28 │ │ │ │ │ _3_2class PQXX_LIBEXPORT _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r : public _r_o_w │ │ │ │ │ 33{ │ │ │ │ │ 34public: │ │ │ │ │ 35 // TODO: Change operator[] so this becomes a proper random_access_iterator. │ │ │ │ │ 36 using iterator_category = std::bidirectional_iterator_tag; │ │ │ │ │ -37 using value_type = _r_o_w const; │ │ │ │ │ -38 using pointer = _r_o_w const *; │ │ │ │ │ +37 using _v_a_l_u_e___t_y_p_e = _r_o_w const; │ │ │ │ │ +38 using _p_o_i_n_t_e_r = _r_o_w const *; │ │ │ │ │ 39 using _r_e_f_e_r_e_n_c_e = _r_o_w; │ │ │ │ │ 40 using size_type = _r_e_s_u_l_t___s_i_z_e___t_y_p_e; │ │ │ │ │ 41 using difference_type = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_e___t_y_p_e; │ │ │ │ │ 42 │ │ │ │ │ 43#include "pqxx/internal/ignore-deprecated-pre.hxx" │ │ │ │ │ -_4_5 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r() noexcept = default; │ │ │ │ │ -_4_7 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) noexcept = default; │ │ │ │ │ -_4_9 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&) noexcept = default; │ │ │ │ │ +_4_5 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r() _n_o_e_x_c_e_p_t = _d_e_f_a_u_l_t; │ │ │ │ │ +_4_7 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r _c_o_n_s_t &) _n_o_e_x_c_e_p_t = _d_e_f_a_u_l_t; │ │ │ │ │ +_4_9 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &&) _n_o_e_x_c_e_p_t = _d_e_f_a_u_l_t; │ │ │ │ │ 50 │ │ │ │ │ -_5_2 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_r_o_w const &t) noexcept : _r_o_w{t} {} │ │ │ │ │ +_5_2 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_r_o_w _c_o_n_s_t &_t) _n_o_e_x_c_e_p_t : _r_o_w{_t} {} │ │ │ │ │ 53#include "pqxx/internal/ignore-deprecated-post.hxx" │ │ │ │ │ 54 │ │ │ │ │ -_7_0 [[nodiscard]] pointer _o_p_e_r_a_t_o_r_-_>() const { return this; } │ │ │ │ │ +_7_0 [[_n_o_d_i_s_c_a_r_d]] _p_o_i_n_t_e_r _o_p_e_r_a_t_o_r_-_>() const { return this; } │ │ │ │ │ 71 │ │ │ │ │ 72#include "pqxx/internal/ignore-deprecated-pre.hxx" │ │ │ │ │ -_7_4 [[nodiscard]] _r_e_f_e_r_e_n_c_e _o_p_e_r_a_t_o_r_*() const { return *this; } │ │ │ │ │ +_7_4 [[_n_o_d_i_s_c_a_r_d]] _r_e_f_e_r_e_n_c_e _o_p_e_r_a_t_o_r_*() const { return *this; } │ │ │ │ │ 75#include "pqxx/internal/ignore-deprecated-post.hxx" │ │ │ │ │ 77 │ │ │ │ │ 82 using row::back; │ │ │ │ │ 83 using row::front; │ │ │ │ │ 84 // TODO: Replace with standard operator[]: i[n] == *(i + n). │ │ │ │ │ 85 using row::operator[]; │ │ │ │ │ 86 using row::at; │ │ │ │ │ @@ -100,18 +100,18 @@ │ │ │ │ │ 127 } │ │ │ │ │ 128 const_result_iterator &operator-=(difference_type i) │ │ │ │ │ 129 { │ │ │ │ │ 130 m_index -= i; │ │ │ │ │ 131 return *this; │ │ │ │ │ 132 } │ │ │ │ │ 133 │ │ │ │ │ -_1_3_5 void _s_w_a_p(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &other) noexcept │ │ │ │ │ +_1_3_5 void _s_w_a_p(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &_o_t_h_e_r) noexcept │ │ │ │ │ 136 { │ │ │ │ │ 137#include "pqxx/internal/ignore-deprecated-pre.hxx" │ │ │ │ │ -138 row::swap(other); │ │ │ │ │ +138 row::swap(_o_t_h_e_r); │ │ │ │ │ 139#include "pqxx/internal/ignore-deprecated-post.hxx" │ │ │ │ │ 140 } │ │ │ │ │ 142 │ │ │ │ │ 147 [[nodiscard]] bool operator==(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │ 148 { │ │ │ │ │ 149 return m_index == i._m___i_n_d_e_x; │ │ │ │ │ 150 } │ │ │ │ │ @@ -136,50 +136,50 @@ │ │ │ │ │ 169 return m_index >= i.m_index; │ │ │ │ │ 170 } │ │ │ │ │ 172 │ │ │ │ │ 177 [[nodiscard]] inline const_result_iterator operator+(difference_type) │ │ │ │ │ const; │ │ │ │ │ 178 friend const_result_iterator │ │ │ │ │ 179 operator+(difference_type, const_result_iterator const &); │ │ │ │ │ -_1_8_0 [[nodiscard]] inline _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r operator-(difference_type) │ │ │ │ │ +_1_8_0 [[_n_o_d_i_s_c_a_r_d]] inline _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r operator-(difference_type) │ │ │ │ │ const; │ │ │ │ │ -181 [[nodiscard]] inline difference_type │ │ │ │ │ +181 [[_n_o_d_i_s_c_a_r_d]] inline difference_type │ │ │ │ │ _1_8_2 operator-(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) const; │ │ │ │ │ 184 │ │ │ │ │ 185private: │ │ │ │ │ 186 friend class _p_q_x_x_:_:_r_e_s_u_l_t; │ │ │ │ │ -187 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_p_q_x_x_:_:_r_e_s_u_l_t const *r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e i) noexcept : │ │ │ │ │ -188 _r_o_w{*r, i, r->columns()} │ │ │ │ │ +187 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_p_q_x_x_:_:_r_e_s_u_l_t const *_r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e _i) _n_o_e_x_c_e_p_t : │ │ │ │ │ +188 _r_o_w{*_r, _i, _r->columns()} │ │ │ │ │ 189 {} │ │ │ │ │ 190}; │ │ │ │ │ 191 │ │ │ │ │ 192 │ │ │ │ │ _1_9_4class PQXX_LIBEXPORT _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ 195 : private _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ 196{ │ │ │ │ │ 197public: │ │ │ │ │ 198 using _s_u_p_e_r = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r; │ │ │ │ │ 199 using _i_t_e_r_a_t_o_r___t_y_p_e = _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r; │ │ │ │ │ 200 using iterator_type::difference_type; │ │ │ │ │ 201 using iterator_type::iterator_category; │ │ │ │ │ -202 using iterator_type::pointer; │ │ │ │ │ -203 using value_type = iterator_type::value_type; │ │ │ │ │ +202 using _i_t_e_r_a_t_o_r___t_y_p_e_:_:_p_o_i_n_t_e_r; │ │ │ │ │ +203 using _v_a_l_u_e___t_y_p_e = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_v_a_l_u_e___t_y_p_e; │ │ │ │ │ 204 using _r_e_f_e_r_e_n_c_e = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_r_e_f_e_r_e_n_c_e; │ │ │ │ │ 205 │ │ │ │ │ _2_0_7 _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r() = default; │ │ │ │ │ -_2_0_9 _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &rhs) = │ │ │ │ │ +_2_0_9 _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &_r_h_s) = │ │ │ │ │ 210 default; │ │ │ │ │ -_2_1_2 explicit _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &rhs) : │ │ │ │ │ -213 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r{rhs} │ │ │ │ │ +_2_1_2 explicit _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &_r_h_s) : │ │ │ │ │ +213 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r{_r_h_s} │ │ │ │ │ 214 { │ │ │ │ │ 215 super::operator--(); │ │ │ │ │ 216 } │ │ │ │ │ 217 │ │ │ │ │ -_2_1_9 explicit _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &&rhs) : │ │ │ │ │ -220 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r{std::move(rhs)} │ │ │ │ │ +_2_1_9 explicit _c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r(_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &&_r_h_s) : │ │ │ │ │ +220 _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r{std::move(_r_h_s)} │ │ │ │ │ 221 { │ │ │ │ │ 222 super::operator--(); │ │ │ │ │ 223 } │ │ │ │ │ 224 │ │ │ │ │ 226 [[nodiscard]] PQXX_PURE _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r base() const noexcept; │ │ │ │ │ 227 │ │ │ │ │ 233 using _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r::operator->; │ │ │ │ │ @@ -355,14 +355,17 @@ │ │ │ │ │ _p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ const_reverse_result_iterator(const_result_iterator const &&rhs) │ │ │ │ │ Move a regular iterator into a reverse iterator. │ │ │ │ │ DDeeffiinniittiioonn result_iterator.hxx:219 │ │ │ │ │ _p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_e_s_u_l_t___i_t_e_r_a_t_o_r │ │ │ │ │ const_reverse_result_iterator()=default │ │ │ │ │ Create an iterator, but in an unusable state. │ │ │ │ │ +_p_q_x_x_:_:_c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +Reverse iterator for a row. Use as row::const_reverse_iterator. │ │ │ │ │ +DDeeffiinniittiioonn row.hxx:411 │ │ │ │ │ _p_q_x_x_:_:_r_e_s_u_l_t │ │ │ │ │ Result set containing data returned by a query or command. │ │ │ │ │ DDeeffiinniittiioonn result.hxx:92 │ │ │ │ │ _p_q_x_x_:_:_r_o_w │ │ │ │ │ Reference to one row in a result. │ │ │ │ │ DDeeffiinniittiioonn row.hxx:47 │ │ │ │ │ _p_q_x_x_:_:_r_o_w_:_:_m___r_e_s_u_l_t │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/row_8hxx_source.html │ │ │ │ @@ -149,104 +149,104 @@ │ │ │ │
59
│ │ │ │
60 row() noexcept = default;
│ │ │ │
61 row(row &&) noexcept = default;
│ │ │ │
62 row(row const &) noexcept = default;
│ │ │ │
63 row &operator=(row const &) noexcept = default;
│ │ │ │
64 row &operator=(row &&) noexcept = default;
│ │ │ │
65
│ │ │ │ -
70 [[nodiscard]] PQXX_PURE bool operator==(row const &) const noexcept;
│ │ │ │ -
71 [[nodiscard]] bool operator!=(row const &rhs) const noexcept
│ │ │ │ +
70 [[nodiscard]] PQXX_PURE bool operator==(row const &) const noexcept;
│ │ │ │ +
71 [[nodiscard]] bool operator!=(row const &rhs) const noexcept
│ │ │ │
72 {
│ │ │ │ -
73 return not operator==(rhs);
│ │ │ │ +
73 return not operator==(rhs);
│ │ │ │
74 }
│ │ │ │
76
│ │ │ │ -
77 [[nodiscard]] const_iterator begin() const noexcept;
│ │ │ │ -
78 [[nodiscard]] const_iterator cbegin() const noexcept;
│ │ │ │ -
79 [[nodiscard]] const_iterator end() const noexcept;
│ │ │ │ -
80 [[nodiscard]] const_iterator cend() const noexcept;
│ │ │ │ +
77 [[nodiscard]] const_iterator begin() const noexcept;
│ │ │ │ +
78 [[nodiscard]] const_iterator cbegin() const noexcept;
│ │ │ │ +
79 [[nodiscard]] const_iterator end() const noexcept;
│ │ │ │ +
80 [[nodiscard]] const_iterator cend() const noexcept;
│ │ │ │
81
│ │ │ │ -
86 [[nodiscard]] reference front() const noexcept;
│ │ │ │ +
86 [[nodiscard]] reference front() const noexcept;
│ │ │ │
│ │ │ │ -
87 [[nodiscard]] reference back() const noexcept;
│ │ │ │ +
87 [[nodiscard]] reference back() const noexcept;
│ │ │ │
88
│ │ │ │ -
89 [[nodiscard]] const_reverse_row_iterator rbegin() const noexcept;
│ │ │ │ -
90 [[nodiscard]] const_reverse_row_iterator crbegin() const noexcept;
│ │ │ │ -
91 [[nodiscard]] const_reverse_row_iterator rend() const noexcept;
│ │ │ │ -
92 [[nodiscard]] const_reverse_row_iterator crend() const noexcept;
│ │ │ │ +
89 [[nodiscard]] const_reverse_row_iterator rbegin() const noexcept;
│ │ │ │ +
90 [[nodiscard]] const_reverse_row_iterator crbegin() const noexcept;
│ │ │ │ +
91 [[nodiscard]] const_reverse_row_iterator rend() const noexcept;
│ │ │ │ +
92 [[nodiscard]] const_reverse_row_iterator crend() const noexcept;
│ │ │ │
93
│ │ │ │ -
94 [[nodiscard]] reference operator[](size_type) const noexcept;
│ │ │ │ -
98 [[nodiscard]] reference operator[](zview col_name) const;
│ │ │ │ +
94 [[nodiscard]] reference operator[](size_type) const noexcept;
│ │ │ │ +
98 [[nodiscard]] reference operator[](zview col_name) const;
│ │ │ │
99
│ │ │ │ -
100 reference at(size_type) const;
│ │ │ │ -
104 reference at(zview col_name) const;
│ │ │ │ +
100 reference at(size_type) const;
│ │ │ │ +
104 reference at(zview col_name) const;
│ │ │ │
105
│ │ │ │ -
106 [[nodiscard]] constexpr size_type size() const noexcept
│ │ │ │ +
106 [[nodiscard]] constexpr size_type size() const noexcept
│ │ │ │
107 {
│ │ │ │
108 return m_end - m_begin;
│ │ │ │
109 }
│ │ │ │
110
│ │ │ │
│ │ │ │ -
112 [[nodiscard]] constexpr result::size_type rownumber() const noexcept
│ │ │ │ +
112 [[nodiscard]] constexpr result::size_type rownumber() const noexcept
│ │ │ │
113 {
│ │ │ │
114 return m_index;
│ │ │ │
115 }
│ │ │ │
│ │ │ │
│ │ │ │
116
│ │ │ │
122 [[nodiscard]] size_type column_number(zview col_name) const;
│ │ │ │
123
│ │ │ │
125 [[nodiscard]] oid column_type(size_type) const;
│ │ │ │
126
│ │ │ │
│ │ │ │ -
128 [[nodiscard]] oid column_type(zview col_name) const
│ │ │ │ +
128 [[nodiscard]] oid column_type(zview col_name) const
│ │ │ │
129 {
│ │ │ │ -
130 return column_type(column_number(col_name));
│ │ │ │ +
130 return column_type(column_number(col_name));
│ │ │ │
131 }
│ │ │ │
│ │ │ │
132
│ │ │ │
134 [[nodiscard]] oid column_table(size_type col_num) const;
│ │ │ │
135
│ │ │ │
│ │ │ │ -
137 [[nodiscard]] oid column_table(zview col_name) const
│ │ │ │ +
137 [[nodiscard]] oid column_table(zview col_name) const
│ │ │ │
138 {
│ │ │ │ -
139 return column_table(column_number(col_name));
│ │ │ │ +
139 return column_table(column_number(col_name));
│ │ │ │
140 }
│ │ │ │
│ │ │ │
141
│ │ │ │
143
│ │ │ │
150 [[nodiscard]] size_type table_column(size_type) const;
│ │ │ │
151
│ │ │ │
│ │ │ │ -
153 [[nodiscard]] size_type table_column(zview col_name) const
│ │ │ │ +
153 [[nodiscard]] size_type table_column(zview col_name) const
│ │ │ │
154 {
│ │ │ │ -
155 return table_column(column_number(col_name));
│ │ │ │ +
155 return table_column(column_number(col_name));
│ │ │ │
156 }
│ │ │ │
│ │ │ │
158
│ │ │ │
159 [[nodiscard]] constexpr result::size_type num() const noexcept
│ │ │ │
160 {
│ │ │ │
161 return rownumber();
│ │ │ │
162 }
│ │ │ │
163
│ │ │ │
165
│ │ │ │
│ │ │ │ -
173 template<typename Tuple> void to(Tuple &t) const
│ │ │ │ +
173 template<typename Tuple> void to(Tuple &t) const
│ │ │ │
174 {
│ │ │ │
175 check_size(std::tuple_size_v<Tuple>);
│ │ │ │ -
176 convert(t);
│ │ │ │ +
176 convert(t);
│ │ │ │
177 }
│ │ │ │
│ │ │ │
178
│ │ │ │
180
│ │ │ │
│ │ │ │ -
188 template<typename... TYPE> std::tuple<TYPE...> as() const
│ │ │ │ +
188 template<typename... TYPE> std::tuple<TYPE...> as() const
│ │ │ │
189 {
│ │ │ │ -
190 check_size(sizeof...(TYPE));
│ │ │ │ -
191 using seq = std::make_index_sequence<sizeof...(TYPE)>;
│ │ │ │ -
192 return get_tuple<std::tuple<TYPE...>>(seq{});
│ │ │ │ +
190 check_size(sizeof...(TYPE));
│ │ │ │ +
191 using seq = std::make_index_sequence<sizeof...(TYPE)>;
│ │ │ │ +
192 return get_tuple<std::tuple<TYPE...>>(seq{});
│ │ │ │
193 }
│ │ │ │
│ │ │ │
194
│ │ │ │
195 [[deprecated("Swap iterators, not rows.")]] void swap(row &) noexcept;
│ │ │ │
196
│ │ │ │
208 [[deprecated("Row slicing is going away. File a bug if you need it.")]] row
│ │ │ │
209 slice(size_type sbegin, size_type send) const;
│ │ │ │ @@ -256,37 +256,37 @@ │ │ │ │
214
│ │ │ │
215protected:
│ │ │ │
216 friend class const_row_iterator;
│ │ │ │
217 friend class result;
│ │ │ │
218 row(result r, result_size_type index, size_type cols) noexcept;
│ │ │ │
219
│ │ │ │
│ │ │ │ -
221 void check_size(size_type expected) const
│ │ │ │ +
221 void check_size(size_type expected) const
│ │ │ │
222 {
│ │ │ │ -
223 if (size() != expected)
│ │ │ │ +
223 if (size() != expected)
│ │ │ │
224 throw usage_error{internal::concat(
│ │ │ │ -
225 "Tried to extract ", expected, " field(s) from a row of ", size(),
│ │ │ │ +
225 "Tried to extract ", expected, " field(s) from a row of ", size(),
│ │ │ │
226 ".")};
│ │ │ │
227 }
│ │ │ │
│ │ │ │
228
│ │ │ │
230
│ │ │ │
│ │ │ │ -
233 template<typename TUPLE> TUPLE as_tuple() const
│ │ │ │ +
233 template<typename TUPLE> TUPLE as_tuple() const
│ │ │ │
234 {
│ │ │ │ -
235 using seq = std::make_index_sequence<std::tuple_size_v<TUPLE>>;
│ │ │ │ -
236 return get_tuple<TUPLE>(seq{});
│ │ │ │ +
235 using seq = std::make_index_sequence<std::tuple_size_v<TUPLE>>;
│ │ │ │ +
236 return get_tuple<TUPLE>(seq{});
│ │ │ │
237 }
│ │ │ │
│ │ │ │
238
│ │ │ │
239 template<typename... T> friend class pqxx::internal::result_iter;
│ │ │ │
│ │ │ │ -
241 template<typename Tuple> void convert(Tuple &t) const
│ │ │ │ +
241 template<typename Tuple> void convert(Tuple &t) const
│ │ │ │
242 {
│ │ │ │ -
243 extract_fields(t, std::make_index_sequence<std::tuple_size_v<Tuple>>{});
│ │ │ │ +
243 extract_fields(t, std::make_index_sequence<std::tuple_size_v<Tuple>>{});
│ │ │ │
244 }
│ │ │ │
│ │ │ │
245
│ │ │ │
246 friend class field;
│ │ │ │
247
│ │ │ │
249 result m_result;
│ │ │ │
250
│ │ │ │ @@ -294,18 +294,18 @@ │ │ │ │
256 result::size_type m_index = 0;
│ │ │ │
257
│ │ │ │
258 // TODO: Remove m_begin and (if possible) m_end when we remove slice().
│ │ │ │
260 size_type m_begin = 0;
│ │ │ │
262 size_type m_end = 0;
│ │ │ │
263
│ │ │ │
264private:
│ │ │ │ -
265 template<typename Tuple, std::size_t... indexes>
│ │ │ │ -
266 void extract_fields(Tuple &t, std::index_sequence<indexes...>) const
│ │ │ │ +
265 template<typename Tuple, std::size_t... indexes>
│ │ │ │ +
266 void extract_fields(Tuple &t, std::index_sequence<indexes...>) const
│ │ │ │
267 {
│ │ │ │ -
268 (extract_value<Tuple, indexes>(t), ...);
│ │ │ │ +
268 (extract_value<Tuple, indexes>(t), ...);
│ │ │ │
269 }
│ │ │ │
270
│ │ │ │
271 template<typename Tuple, std::size_t index>
│ │ │ │
272 void extract_value(Tuple &t) const;
│ │ │ │
273
│ │ │ │
275 template<typename TUPLE, std::size_t... indexes>
│ │ │ │
276 auto get_tuple(std::index_sequence<indexes...>) const
│ │ │ │ ├── html2text {} │ │ │ │ │ @@ -54,91 +54,91 @@ │ │ │ │ │ 59 │ │ │ │ │ 60 _r_o_w() noexcept = default; │ │ │ │ │ 61 _r_o_w(_r_o_w &&) noexcept = default; │ │ │ │ │ 62 _r_o_w(_r_o_w const &) noexcept = default; │ │ │ │ │ 63 _r_o_w &operator=(_r_o_w const &) noexcept = default; │ │ │ │ │ 64 _r_o_w &operator=(_r_o_w &&) noexcept = default; │ │ │ │ │ 65 │ │ │ │ │ -70 [[nodiscard]] PQXX_PURE bool operator==(_r_o_w const &) const noexcept; │ │ │ │ │ -71 [[nodiscard]] bool operator!=(_r_o_w const &rhs) const noexcept │ │ │ │ │ +70 [[_n_o_d_i_s_c_a_r_d]] PQXX_PURE bool operator==(_r_o_w const &) const noexcept; │ │ │ │ │ +71 [[_n_o_d_i_s_c_a_r_d]] bool operator!=(_r_o_w const &_r_h_s) const noexcept │ │ │ │ │ 72 { │ │ │ │ │ -73 return not operator==(rhs); │ │ │ │ │ +73 return _n_o_t operator==(_r_h_s); │ │ │ │ │ 74 } │ │ │ │ │ 76 │ │ │ │ │ -77 [[nodiscard]] _c_o_n_s_t___i_t_e_r_a_t_o_r begin() const noexcept; │ │ │ │ │ -78 [[nodiscard]] _c_o_n_s_t___i_t_e_r_a_t_o_r cbegin() const noexcept; │ │ │ │ │ -79 [[nodiscard]] _c_o_n_s_t___i_t_e_r_a_t_o_r end() const noexcept; │ │ │ │ │ -80 [[nodiscard]] _c_o_n_s_t___i_t_e_r_a_t_o_r cend() const noexcept; │ │ │ │ │ +77 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___i_t_e_r_a_t_o_r begin() const noexcept; │ │ │ │ │ +78 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___i_t_e_r_a_t_o_r cbegin() const noexcept; │ │ │ │ │ +79 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___i_t_e_r_a_t_o_r end() const noexcept; │ │ │ │ │ +80 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___i_t_e_r_a_t_o_r cend() const noexcept; │ │ │ │ │ 81 │ │ │ │ │ -86 [[nodiscard]] _r_e_f_e_r_e_n_c_e front() const noexcept; │ │ │ │ │ -_8_7 [[nodiscard]] _r_e_f_e_r_e_n_c_e back() const noexcept; │ │ │ │ │ +86 [[_n_o_d_i_s_c_a_r_d]] _r_e_f_e_r_e_n_c_e front() const noexcept; │ │ │ │ │ +_8_7 [[_n_o_d_i_s_c_a_r_d]] _r_e_f_e_r_e_n_c_e back() _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ 88 │ │ │ │ │ -89 [[nodiscard]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r rbegin() const noexcept; │ │ │ │ │ -90 [[nodiscard]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r crbegin() const noexcept; │ │ │ │ │ -91 [[nodiscard]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r rend() const noexcept; │ │ │ │ │ -92 [[nodiscard]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r crend() const noexcept; │ │ │ │ │ +89 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r rbegin() _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ +90 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r crbegin() _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ +91 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r rend() _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ +92 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t___r_e_v_e_r_s_e___r_o_w___i_t_e_r_a_t_o_r crend() _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ 93 │ │ │ │ │ -94 [[nodiscard]] _r_e_f_e_r_e_n_c_e operator[](size_type) const noexcept; │ │ │ │ │ -98 [[nodiscard]] _r_e_f_e_r_e_n_c_e operator[](_z_v_i_e_w col_name) const; │ │ │ │ │ +94 [[_n_o_d_i_s_c_a_r_d]] _r_e_f_e_r_e_n_c_e operator[](size_type) _c_o_n_s_t _n_o_e_x_c_e_p_t; │ │ │ │ │ +98 [[_n_o_d_i_s_c_a_r_d]] _r_e_f_e_r_e_n_c_e operator[](_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t; │ │ │ │ │ 99 │ │ │ │ │ -100 _r_e_f_e_r_e_n_c_e at(size_type) const; │ │ │ │ │ -104 _r_e_f_e_r_e_n_c_e at(_z_v_i_e_w col_name) const; │ │ │ │ │ +100 _r_e_f_e_r_e_n_c_e at(size_type) _c_o_n_s_t; │ │ │ │ │ +104 _r_e_f_e_r_e_n_c_e at(_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t; │ │ │ │ │ 105 │ │ │ │ │ -106 [[nodiscard]] constexpr size_type size() const noexcept │ │ │ │ │ +106 [[_n_o_d_i_s_c_a_r_d]] _c_o_n_s_t_e_x_p_r size_type size() _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ 107 { │ │ │ │ │ 108 return m_end - m_begin; │ │ │ │ │ 109 } │ │ │ │ │ 110 │ │ │ │ │ -_1_1_2 [[nodiscard]] constexpr result::size_type _r_o_w_n_u_m_b_e_r() const noexcept │ │ │ │ │ +_1_1_2 [[_n_o_d_i_s_c_a_r_d]] constexpr result::size_type _r_o_w_n_u_m_b_e_r() _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ 113 { │ │ │ │ │ 114 return m_index; │ │ │ │ │ 115 } │ │ │ │ │ 116 │ │ │ │ │ 122 [[nodiscard]] size_type column_number(_z_v_i_e_w col_name) const; │ │ │ │ │ 123 │ │ │ │ │ 125 [[nodiscard]] _o_i_d column_type(size_type) const; │ │ │ │ │ 126 │ │ │ │ │ -_1_2_8 [[nodiscard]] _o_i_d _c_o_l_u_m_n___t_y_p_e(_z_v_i_e_w col_name) const │ │ │ │ │ +_1_2_8 [[_n_o_d_i_s_c_a_r_d]] _o_i_d _c_o_l_u_m_n___t_y_p_e(_z_v_i_e_w _c_o_l___n_a_m_e) const │ │ │ │ │ 129 { │ │ │ │ │ -130 return column_type(column_number(col_name)); │ │ │ │ │ +130 return column_type(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ 131 } │ │ │ │ │ 132 │ │ │ │ │ 134 [[nodiscard]] _o_i_d column_table(size_type col_num) const; │ │ │ │ │ 135 │ │ │ │ │ -_1_3_7 [[nodiscard]] _o_i_d _c_o_l_u_m_n___t_a_b_l_e(_z_v_i_e_w col_name) const │ │ │ │ │ +_1_3_7 [[_n_o_d_i_s_c_a_r_d]] _o_i_d _c_o_l_u_m_n___t_a_b_l_e(_z_v_i_e_w _c_o_l___n_a_m_e) const │ │ │ │ │ 138 { │ │ │ │ │ -139 return column_table(column_number(col_name)); │ │ │ │ │ +139 return column_table(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ 140 } │ │ │ │ │ 141 │ │ │ │ │ 143 │ │ │ │ │ 150 [[nodiscard]] size_type table_column(size_type) const; │ │ │ │ │ 151 │ │ │ │ │ -_1_5_3 [[nodiscard]] size_type _t_a_b_l_e___c_o_l_u_m_n(_z_v_i_e_w col_name) const │ │ │ │ │ +_1_5_3 [[_n_o_d_i_s_c_a_r_d]] size_type _t_a_b_l_e___c_o_l_u_m_n(_z_v_i_e_w _c_o_l___n_a_m_e) const │ │ │ │ │ 154 { │ │ │ │ │ -155 return table_column(column_number(col_name)); │ │ │ │ │ +155 return table_column(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ 156 } │ │ │ │ │ 158 │ │ │ │ │ 159 [[nodiscard]] constexpr result::size_type num() const noexcept │ │ │ │ │ 160 { │ │ │ │ │ 161 return rownumber(); │ │ │ │ │ 162 } │ │ │ │ │ 163 │ │ │ │ │ 165 │ │ │ │ │ -_1_7_3 template void _t_o(Tuple &t) const │ │ │ │ │ +_1_7_3 template void _t_o(_T_u_p_l_e &_t) const │ │ │ │ │ 174 { │ │ │ │ │ 175 check_size(std::tuple_size_v); │ │ │ │ │ -176 convert(t); │ │ │ │ │ +176 convert(_t); │ │ │ │ │ 177 } │ │ │ │ │ 178 │ │ │ │ │ 180 │ │ │ │ │ -_1_8_8 template std::tuple _a_s() const │ │ │ │ │ +_1_8_8 template std::tuple<_T_Y_P_E...> _a_s() const │ │ │ │ │ 189 { │ │ │ │ │ -190 check_size(sizeof...(TYPE)); │ │ │ │ │ -191 using seq = std::make_index_sequence; │ │ │ │ │ -192 return get_tuple>(seq{}); │ │ │ │ │ +190 check_size(sizeof...(_T_Y_P_E)); │ │ │ │ │ +191 using _s_e_q = std::make_index_sequence; │ │ │ │ │ +192 return get_tuple>(_s_e_q{}); │ │ │ │ │ 193 } │ │ │ │ │ 194 │ │ │ │ │ 195 [[deprecated("Swap iterators, not rows.")]] void swap(_r_o_w &) noexcept; │ │ │ │ │ 196 │ │ │ │ │ 208 [[deprecated("Row slicing is going away. File a bug if you need it.")]] _r_o_w │ │ │ │ │ 209 slice(size_type sbegin, size_type send) const; │ │ │ │ │ 210 │ │ │ │ │ @@ -146,51 +146,51 @@ │ │ │ │ │ 213 empty() const noexcept; │ │ │ │ │ 214 │ │ │ │ │ 215protected: │ │ │ │ │ 216 friend class _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r; │ │ │ │ │ 217 friend class _r_e_s_u_l_t; │ │ │ │ │ 218 _r_o_w(_r_e_s_u_l_t r, _r_e_s_u_l_t___s_i_z_e___t_y_p_e index, size_type cols) noexcept; │ │ │ │ │ 219 │ │ │ │ │ -_2_2_1 void check_size(size_type expected) const │ │ │ │ │ +_2_2_1 void check_size(size_type _e_x_p_e_c_t_e_d) const │ │ │ │ │ 222 { │ │ │ │ │ -223 if (size() != expected) │ │ │ │ │ +223 if (size() != _e_x_p_e_c_t_e_d) │ │ │ │ │ 224 throw _u_s_a_g_e___e_r_r_o_r{internal::concat( │ │ │ │ │ -225 "Tried to extract ", expected, " field(s) from a row of ", size(), │ │ │ │ │ +225 "Tried to extract ", _e_x_p_e_c_t_e_d, " field(s) from a row of ", size(), │ │ │ │ │ 226 ".")}; │ │ │ │ │ 227 } │ │ │ │ │ 228 │ │ │ │ │ 230 │ │ │ │ │ -_2_3_3 template TUPLE _a_s___t_u_p_l_e() const │ │ │ │ │ +_2_3_3 template _T_U_P_L_E _a_s___t_u_p_l_e() const │ │ │ │ │ 234 { │ │ │ │ │ -235 using seq = std::make_index_sequence>; │ │ │ │ │ -236 return get_tuple(seq{}); │ │ │ │ │ +235 using _s_e_q = std::make_index_sequence>; │ │ │ │ │ +236 return _g_e_t___t_u_p_l_e_<_T_U_P_L_E_>(_s_e_q{}); │ │ │ │ │ 237 } │ │ │ │ │ 238 │ │ │ │ │ 239 template friend class _p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_r_e_s_u_l_t___i_t_e_r; │ │ │ │ │ -_2_4_1 template void _c_o_n_v_e_r_t(Tuple &t) const │ │ │ │ │ +_2_4_1 template void _c_o_n_v_e_r_t(_T_u_p_l_e &_t) const │ │ │ │ │ 242 { │ │ │ │ │ -243 extract_fields(t, std::make_index_sequence>{}); │ │ │ │ │ +243 extract_fields(_t, std::make_index_sequence>{}); │ │ │ │ │ 244 } │ │ │ │ │ 245 │ │ │ │ │ 246 friend class _f_i_e_l_d; │ │ │ │ │ 247 │ │ │ │ │ _2_4_9 _r_e_s_u_l_t _m___r_e_s_u_l_t; │ │ │ │ │ 250 │ │ │ │ │ 252 │ │ │ │ │ _2_5_6 result::size_type m_index = 0; │ │ │ │ │ 257 │ │ │ │ │ 258 // TODO: Remove m_begin and (if possible) m_end when we remove slice(). │ │ │ │ │ _2_6_0 size_type m_begin = 0; │ │ │ │ │ _2_6_2 size_type m_end = 0; │ │ │ │ │ 263 │ │ │ │ │ 264private: │ │ │ │ │ -265 template │ │ │ │ │ -266 void extract_fields(Tuple &t, std::index_sequence) const │ │ │ │ │ +265 template │ │ │ │ │ +266 void extract_fields(_T_u_p_l_e &_t, std::index_sequence) const │ │ │ │ │ 267 { │ │ │ │ │ -268 (extract_value(t), ...); │ │ │ │ │ +268 (_e_x_t_r_a_c_t___v_a_l_u_e_<_T_u_p_l_e_,_ _i_n_d_e_x_e_s_>(_t), ...); │ │ │ │ │ 269 } │ │ │ │ │ 270 │ │ │ │ │ 271 template │ │ │ │ │ 272 void extract_value(Tuple &t) const; │ │ │ │ │ 273 │ │ │ │ │ 275 template │ │ │ │ │ 276 auto get_tuple(std::index_sequence) const │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_0.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['a_20new_20type_0', ['Supporting a new type', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ - ['a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ - ['a_20special_20prepared_20statement_2', ['A special prepared statement', ['../prepared.html#autotoc_md22', 1, '']]], │ │ │ │ │ - ['a_20statement_3', ['Preparing a statement', ['../prepared.html#autotoc_md20', 1, '']]], │ │ │ │ │ - ['a_20table_20em_4', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['a_20new_20type_0', ['Supporting a new type', ['../datatypes.html#autotoc_md5', 1, '']]], │ │ │ │ │ + ['a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ + ['a_20special_20prepared_20statement_2', ['A special prepared statement', ['../prepared.html#autotoc_md30', 1, '']]], │ │ │ │ │ + ['a_20statement_3', ['Preparing a statement', ['../prepared.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['a_20table_20em_4', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ ['abort_5', ['abort', ['../group__transactions.html#a955f2497216d9eae268ac662b46d5a45', 1, 'pqxx::transaction_base']]], │ │ │ │ │ ['access_5fpolicy_6', ['access_policy', ['../classpqxx_1_1cursor__base.html#ab2dbdc503c97b0200dd3eca6ae22f0a2', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['accessing_20results_20and_20result_20rows_7', ['Accessing results and result rows', ['../accessing-results.html', 1, '']]], │ │ │ │ │ ['additional_20data_20types_8', ['Supporting additional data types', ['../datatypes.html', 1, '']]], │ │ │ │ │ ['adorn_5fname_9', ['adorn_name', ['../classpqxx_1_1connection.html#ab4cbd2e2d30694fcaf0969c33fbeaa8f', 1, 'pqxx::connection']]], │ │ │ │ │ ['affected_5frows_10', ['affected_rows', ['../classpqxx_1_1result.html#af73d036566ef69618f8b22ba9a220a2e', 1, 'pqxx::result']]], │ │ │ │ │ ['all_11', ['all', ['../classpqxx_1_1cursor__base.html#a8ce6273da334bfd0a571c47a7eece137', 1, 'pqxx::cursor_base']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_1.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -36,13 +36,13 @@ │ │ │ │ │ ['../classpqxx_1_1blob.html#a3c1c5fcc157476dfe938c6901059502f', 1, 'pqxx::blob::blob()=default'], │ │ │ │ │ ['../classpqxx_1_1blob.html#aafa3ce93f6401c592f8985217be1d416', 1, 'pqxx::blob::blob(blob &&)'] │ │ │ │ │ ]], │ │ │ │ │ ['broken_5fconnection_16', ['broken_connection', ['../group__exception.html#structpqxx_1_1broken__connection', 1, 'pqxx']]], │ │ │ │ │ ['byte_5fchar_5ftraits_17', ['byte_char_traits', ['../structpqxx_1_1byte__char__traits.html', 1, 'pqxx']]], │ │ │ │ │ ['bytes_18', ['bytes', ['../group__escaping-functions.html#a9c32ded06d7701f6aec265699b09a3d7', 1, 'pqxx::binarystring::bytes()'], │ │ │ │ │ ['../namespacepqxx.html#ac5e2f3e80ccc3a5f58bab7d699c9be05', 1, 'pqxx::bytes'], │ │ │ │ │ - ['../prepared.html#autotoc_md24', 1, 'Zero bytes'] │ │ │ │ │ + ['../prepared.html#autotoc_md32', 1, 'Zero bytes'] │ │ │ │ │ ]], │ │ │ │ │ ['bytes_5fview_19', ['bytes_view', ['../group__escaping-functions.html#a896578493ce8e0a82e1b2de5fc786c17', 1, 'pqxx::binarystring::bytes_view()'], │ │ │ │ │ ['../namespacepqxx.html#adf98e8b2ed585c586f9575928421e07d', 1, 'pqxx::bytes_view'] │ │ │ │ │ ]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_10.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -46,15 +46,15 @@ │ │ │ │ │ ['results_20with_20metadata_29', ['Results with metadata', ['../accessing-results.html#autotoc_md2', 1, '']]], │ │ │ │ │ ['resume_30', ['resume', ['../classpqxx_1_1pipeline.html#a06667e2e73b597586e61cae8533a2874', 1, 'pqxx::pipeline']]], │ │ │ │ │ ['retain_31', ['retain', ['../classpqxx_1_1pipeline.html#a5de968e394d7d9b68cfd84f9ae93f5bb', 1, 'pqxx::pipeline']]], │ │ │ │ │ ['retrieve_32', ['retrieve', ['../classpqxx_1_1pipeline.html#a5f8dfe951c18c19f24dd2e7a30ef276d', 1, 'pqxx::pipeline::retrieve()'], │ │ │ │ │ ['../classpqxx_1_1pipeline.html#a19c508710d0025993e41512f23de56be', 1, 'pqxx::pipeline::retrieve(query_id qid)'], │ │ │ │ │ ['../classpqxx_1_1stateless__cursor.html#a97046479f709ae621473c48ed7a0932d', 1, 'pqxx::stateless_cursor::retrieve()'] │ │ │ │ │ ]], │ │ │ │ │ - ['right_20for_20my_20query_33', ['Is streaming right for my query?', ['../streams.html#autotoc_md27', 1, '']]], │ │ │ │ │ + ['right_20for_20my_20query_33', ['Is streaming right for my query?', ['../streams.html#autotoc_md22', 1, '']]], │ │ │ │ │ ['row_34', ['row', ['../classpqxx_1_1row.html#a5bd8864f453d45f83984ed858fb68880', 1, 'pqxx::row::row()'], │ │ │ │ │ ['../classpqxx_1_1row.html', 1, 'pqxx::row'] │ │ │ │ │ ]], │ │ │ │ │ ['row_5fdifference_5ftype_35', ['row_difference_type', ['../namespacepqxx.html#a3269cdd94e1966b5d9e5d175f27741db', 1, 'pqxx']]], │ │ │ │ │ ['row_5fend_36', ['row_end', ['../classpqxx_1_1array__parser.html#a039577d83d313a6daf35fd7c273e189eab11c3eff6dd36f1f7136020d32b38051', 1, 'pqxx::array_parser']]], │ │ │ │ │ ['row_5fsize_5ftype_37', ['row_size_type', ['../namespacepqxx.html#a2dedde27863671a16a59f2625bf03d03', 1, 'pqxx']]], │ │ │ │ │ ['row_5fstart_38', ['row_start', ['../classpqxx_1_1array__parser.html#a039577d83d313a6daf35fd7c273e189ea776234b9f0a5c0e802f2790824042092', 1, 'pqxx::array_parser']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -6,117 +6,117 @@ │ │ │ │ │ ['scan_5funquoted_5fstring_4', ['scan_unquoted_string', ['../namespacepqxx_1_1internal.html#aa04370763622b6a3a101c9f3a9094f31', 1, 'pqxx::internal']]], │ │ │ │ │ ['seek_5', ['seek', ['../classpqxx_1_1largeobjectaccess.html#ae74922e23584d6410cf37f89f10c1a53', 1, 'pqxx::largeobjectaccess']]], │ │ │ │ │ ['seek_5fabs_6', ['seek_abs', ['../classpqxx_1_1blob.html#aca130d3433032b610ea94136968d16e5', 1, 'pqxx::blob']]], │ │ │ │ │ ['seek_5fend_7', ['seek_end', ['../classpqxx_1_1blob.html#aff777e2a1736d1a24b07e410e846181e', 1, 'pqxx::blob']]], │ │ │ │ │ ['seek_5frel_8', ['seek_rel', ['../classpqxx_1_1blob.html#ac95d070901a97d46659806edd6687f53', 1, 'pqxx::blob']]], │ │ │ │ │ ['seekdir_9', ['seekdir', ['../classpqxx_1_1largeobjectaccess.html#a9230026566fa1f7c32d2abcc2a5571eb', 1, 'pqxx::largeobjectaccess']]], │ │ │ │ │ ['seize_5fraw_5fconnection_10', ['seize_raw_connection', ['../classpqxx_1_1connection.html#a9636dca79690132730383a663aab52c8', 1, 'pqxx::connection']]], │ │ │ │ │ - ['sensitivity_11', ['Case sensitivity', ['../classpqxx_1_1connection.html#autotoc_md29', 1, '']]], │ │ │ │ │ - ['separated_5flist_12', ['separated_list', ['../namespacepqxx.html#a2645d7a8c25d93e6b573cb4055dbb7a4', 1, 'pqxx::separated_list(std::string_view, TUPLE const &t, ACCESS const &access)'], │ │ │ │ │ - ['../namespacepqxx.html#a6923c65ab691ca5039a5f391119e63ae', 1, 'pqxx::separated_list(std::string_view sep, CONTAINER const &c) -> typename std::enable_if<(not std::is_void< decltype(std::begin(c))>::value and not std::is_void< decltype(std::end(c))>::value), std::string >::type'], │ │ │ │ │ + ['sensitivity_11', ['Case sensitivity', ['../classpqxx_1_1connection.html#autotoc_md24', 1, '']]], │ │ │ │ │ + ['separated_5flist_12', ['separated_list', ['../namespacepqxx.html#a20d624ee29b5c66c68a515da3a56d5e8', 1, 'pqxx::separated_list(std::string_view sep, ITER begin, ITER end, ACCESS access)'], │ │ │ │ │ ['../namespacepqxx.html#a043b0acb60e5e805b5d6af403da4fafc', 1, 'pqxx::separated_list(std::string_view sep, ITER begin, ITER end)'], │ │ │ │ │ - ['../namespacepqxx.html#a20d624ee29b5c66c68a515da3a56d5e8', 1, 'pqxx::separated_list(std::string_view sep, ITER begin, ITER end, ACCESS access)'] │ │ │ │ │ + ['../namespacepqxx.html#a6923c65ab691ca5039a5f391119e63ae', 1, 'pqxx::separated_list(std::string_view sep, CONTAINER const &c) -> typename std::enable_if<(not std::is_void< decltype(std::begin(c))>::value and not std::is_void< decltype(std::end(c))>::value), std::string >::type'], │ │ │ │ │ + ['../namespacepqxx.html#a2645d7a8c25d93e6b573cb4055dbb7a4', 1, 'pqxx::separated_list(std::string_view, TUPLE const &t, ACCESS const &access)'] │ │ │ │ │ ]], │ │ │ │ │ ['serialization_5ffailure_13', ['serialization_failure', ['../group__exception.html#structpqxx_1_1serialization__failure', 1, 'pqxx']]], │ │ │ │ │ ['server_5fversion_14', ['server_version', ['../classpqxx_1_1connection.html#ae217a0eb7197724be22beeb01b841a5a', 1, 'pqxx::connection']]], │ │ │ │ │ - ['set_5fclient_5fencoding_15', ['set_client_encoding', ['../classpqxx_1_1connection.html#a2da006fb42b49b72f1261b774aaf6e10', 1, 'pqxx::connection::set_client_encoding(char const encoding[]) &'], │ │ │ │ │ - ['../classpqxx_1_1connection.html#a3b8266efbb47eb4be0acae9ba198459d', 1, 'pqxx::connection::set_client_encoding(zview encoding) &'] │ │ │ │ │ + ['set_5fclient_5fencoding_15', ['set_client_encoding', ['../classpqxx_1_1connection.html#a3b8266efbb47eb4be0acae9ba198459d', 1, 'pqxx::connection::set_client_encoding(zview encoding) &'], │ │ │ │ │ + ['../classpqxx_1_1connection.html#a2da006fb42b49b72f1261b774aaf6e10', 1, 'pqxx::connection::set_client_encoding(char const encoding[]) &'] │ │ │ │ │ ]], │ │ │ │ │ ['set_5fnotice_5fhandler_16', ['set_notice_handler', ['../classpqxx_1_1connection.html#a3eb2374848e1ddf85fe8dfa5f58826f3', 1, 'pqxx::connection']]], │ │ │ │ │ ['set_5frollback_5fcmd_17', ['set_rollback_cmd', ['../group__transactions.html#a35e81ec0048df68ba4a5e1c0a2ece777', 1, 'pqxx::transaction_base']]], │ │ │ │ │ ['set_5fsession_5fvar_18', ['set_session_var', ['../classpqxx_1_1connection.html#ae23a5c19af62349c1924ec26d93c81d5', 1, 'pqxx::connection']]], │ │ │ │ │ - ['set_5fvariable_19', ['set_variable', ['../group__transactions.html#ae3983af92a76767c75b9889ac9c52a8b', 1, 'pqxx::transaction_base::set_variable()'], │ │ │ │ │ - ['../classpqxx_1_1connection.html#a59295a47049b03ab949b3781dd60ed42', 1, 'pqxx::connection::set_variable(std::string_view var, std::string_view value) &'] │ │ │ │ │ + ['set_5fvariable_19', ['set_variable', ['../classpqxx_1_1connection.html#a59295a47049b03ab949b3781dd60ed42', 1, 'pqxx::connection::set_variable()'], │ │ │ │ │ + ['../group__transactions.html#ae3983af92a76767c75b9889ac9c52a8b', 1, 'pqxx::transaction_base::set_variable()'] │ │ │ │ │ ]], │ │ │ │ │ ['set_5fverbosity_20', ['set_verbosity', ['../classpqxx_1_1connection.html#a024851ed6f2ee32fa00e0fcf53cf37ac', 1, 'pqxx::connection']]], │ │ │ │ │ ['size_21', ['size', ['../group__escaping-functions.html#afa6be7a52ce16a143ce6ebf640ff3aea', 1, 'pqxx::binarystring::size()'], │ │ │ │ │ - ['../classpqxx_1_1params.html#a1a3ca8939fbeec4db4f7d69c8014a937', 1, 'pqxx::params::size()'], │ │ │ │ │ + ['../classpqxx_1_1stateless__cursor.html#ae278f24bab98d3946061934a48992067', 1, 'pqxx::stateless_cursor::size()'], │ │ │ │ │ ['../classpqxx_1_1field.html#a20ceb9e1dd63c481e412af866e88ccaa', 1, 'pqxx::field::size()'], │ │ │ │ │ - ['../classpqxx_1_1array.html#a592afe2ec16fbb793501e84d805c87eb', 1, 'pqxx::array::size()'], │ │ │ │ │ - ['../classpqxx_1_1stateless__cursor.html#ae278f24bab98d3946061934a48992067', 1, 'pqxx::stateless_cursor::size()'] │ │ │ │ │ + ['../classpqxx_1_1params.html#a1a3ca8939fbeec4db4f7d69c8014a937', 1, 'pqxx::params::size()'], │ │ │ │ │ + ['../classpqxx_1_1array.html#a592afe2ec16fbb793501e84d805c87eb', 1, 'pqxx::array::size()'] │ │ │ │ │ ]], │ │ │ │ │ ['size_5fbuffer_22', ['size_buffer', ['../structpqxx_1_1string__traits.html#a16b9aef87d46bafdcfcfdaca42f2f73f', 1, 'pqxx::string_traits']]], │ │ │ │ │ - ['size_5fbuffer_20tt_23', ['<tt>size_buffer</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ + ['size_5fbuffer_20tt_23', ['<tt>size_buffer</tt>', ['../datatypes.html#autotoc_md13', 1, '']]], │ │ │ │ │ ['size_5fcomposite_5ffield_5fbuffer_24', ['size_composite_field_buffer', ['../namespacepqxx_1_1internal.html#a28ae4ea69fdef1f1eba5a771ccd1dc2f', 1, 'pqxx::internal']]], │ │ │ │ │ ['size_5fesc_5fbin_25', ['size_esc_bin', ['../namespacepqxx_1_1internal.html#a297e2d7f026b9baf4b8a57872ea345fc', 1, 'pqxx::internal']]], │ │ │ │ │ ['size_5funesc_5fbin_26', ['size_unesc_bin', ['../namespacepqxx_1_1internal.html#aff5de6ade6ae7234093bac118bf7ab8c', 1, 'pqxx::internal']]], │ │ │ │ │ ['sizes_27', ['sizes', ['../classpqxx_1_1array.html#ad0bf0e010691f056bebaa506f9e034dc', 1, 'pqxx::array']]], │ │ │ │ │ ['skip_5finit_28', ['skip_init', ['../namespacepqxx.html#adabe80e8385e85d663acc6e44332070d', 1, 'pqxx']]], │ │ │ │ │ ['skip_5finit_5fssl_29', ['skip_init_ssl', ['../namespacepqxx_1_1internal.html#a2ff078037fe1e6ca2b76fd9e0ac94b87', 1, 'pqxx::internal::skip_init_ssl()'], │ │ │ │ │ ['../namespacepqxx.html#a71f4fd3d06b6e0a849c58a8160380a86', 1, 'pqxx::skip_init_ssl()'] │ │ │ │ │ ]], │ │ │ │ │ ['slice_30', ['slice', ['../classpqxx_1_1row.html#a4195a594e4f11829637820cd89e39c7b', 1, 'pqxx::row']]], │ │ │ │ │ - ['sock_31', ['sock', ['../classpqxx_1_1connection.html#af312d26f21b1cfd4d063e3b591fb7579', 1, 'pqxx::connection::sock()'], │ │ │ │ │ - ['../classpqxx_1_1connecting.html#a26fe754177b77ce5d62a7de871d79b7b', 1, 'pqxx::connecting::sock()'] │ │ │ │ │ + ['sock_31', ['sock', ['../classpqxx_1_1connecting.html#a26fe754177b77ce5d62a7de871d79b7b', 1, 'pqxx::connecting::sock()'], │ │ │ │ │ + ['../classpqxx_1_1connection.html#af312d26f21b1cfd4d063e3b591fb7579', 1, 'pqxx::connection::sock()'] │ │ │ │ │ ]], │ │ │ │ │ - ['special_20prepared_20statement_32', ['A special prepared statement', ['../prepared.html#autotoc_md22', 1, '']]], │ │ │ │ │ - ['specialise_20tt_20is_5funquoted_5fsafe_20tt_33', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md16', 1, '']]], │ │ │ │ │ - ['specialise_20tt_20nullness_20tt_34', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md10', 1, '']]], │ │ │ │ │ - ['specialise_20tt_20param_5fformat_20tt_35', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md17', 1, '']]], │ │ │ │ │ - ['specialise_20tt_20string_5ftraits_20tt_36', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md11', 1, '']]], │ │ │ │ │ - ['specialise_20tt_20type_5fname_20tt_37', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ + ['special_20prepared_20statement_32', ['A special prepared statement', ['../prepared.html#autotoc_md30', 1, '']]], │ │ │ │ │ + ['specialise_20tt_20is_5funquoted_5fsafe_20tt_33', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['specialise_20tt_20nullness_20tt_34', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['specialise_20tt_20param_5fformat_20tt_35', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ + ['specialise_20tt_20string_5ftraits_20tt_36', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ + ['specialise_20tt_20type_5fname_20tt_37', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ ['specialize_5fparse_5fcomposite_5ffield_38', ['specialize_parse_composite_field', ['../namespacepqxx_1_1internal.html#ab1007038de5942f048d5da32e49b6b07', 1, 'pqxx::internal']]], │ │ │ │ │ - ['sql_20injection_39', ['SQL injection', ['../escaping.html#autotoc_md4', 1, '']]], │ │ │ │ │ + ['sql_20injection_39', ['SQL injection', ['../escaping.html#autotoc_md16', 1, '']]], │ │ │ │ │ ['sql_5fcursor_40', ['sql_cursor', ['../classpqxx_1_1internal_1_1sql__cursor.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['sql_5ferror_41', ['sql_error', ['../group__exception.html#classpqxx_1_1sql__error', 1, 'pqxx']]], │ │ │ │ │ ['sqlstate_42', ['sqlstate', ['../group__exception.html#a31ffc7a42e9a388eb2b7cb46647e4282', 1, 'pqxx::sql_error']]], │ │ │ │ │ - ['ssize_43', ['ssize', ['../namespacepqxx_1_1internal.html#af21d8461eaf6d185ed98ab88b2edac6e', 1, 'pqxx::internal::ssize()'], │ │ │ │ │ + ['ssize_43', ['ssize', ['../classpqxx_1_1array.html#a707b514df7835fa198a29ae68897efd8', 1, 'pqxx::array::ssize()'], │ │ │ │ │ ['../classpqxx_1_1params.html#ab23b2a3b2a58bfd03fca36022ebce8b4', 1, 'pqxx::params::ssize()'], │ │ │ │ │ - ['../classpqxx_1_1array.html#a707b514df7835fa198a29ae68897efd8', 1, 'pqxx::array::ssize()'] │ │ │ │ │ + ['../namespacepqxx_1_1internal.html#af21d8461eaf6d185ed98ab88b2edac6e', 1, 'pqxx::internal::ssize()'] │ │ │ │ │ ]], │ │ │ │ │ ['started_44', ['Getting started', ['../getting-started.html', 1, '']]], │ │ │ │ │ ['state_5fbuffer_5foverrun_45', ['state_buffer_overrun', ['../namespacepqxx_1_1internal.html#ac32dacb4b6c712d3d7b1de9ebad0e1d5', 1, 'pqxx::internal']]], │ │ │ │ │ - ['stateless_5fcursor_46', ['stateless_cursor', ['../classpqxx_1_1stateless__cursor.html#afe5492d726a1765647985874d17f4149', 1, 'pqxx::stateless_cursor::stateless_cursor(transaction_base &tx, std::string_view adopted_cursor)'], │ │ │ │ │ - ['../classpqxx_1_1stateless__cursor.html#ad77d68832afb8572fd976fc816bec89a', 1, 'pqxx::stateless_cursor::stateless_cursor(transaction_base &tx, std::string_view query, std::string_view cname, bool hold)'], │ │ │ │ │ + ['stateless_5fcursor_46', ['stateless_cursor', ['../classpqxx_1_1stateless__cursor.html#ad77d68832afb8572fd976fc816bec89a', 1, 'pqxx::stateless_cursor::stateless_cursor(transaction_base &tx, std::string_view query, std::string_view cname, bool hold)'], │ │ │ │ │ + ['../classpqxx_1_1stateless__cursor.html#afe5492d726a1765647985874d17f4149', 1, 'pqxx::stateless_cursor::stateless_cursor(transaction_base &tx, std::string_view adopted_cursor)'], │ │ │ │ │ ['../classpqxx_1_1stateless__cursor.html', 1, 'pqxx::stateless_cursor< up, op >'] │ │ │ │ │ ]], │ │ │ │ │ - ['statement_47', ['statement', ['../prepared.html#autotoc_md22', 1, 'A special prepared statement'], │ │ │ │ │ - ['../prepared.html#autotoc_md20', 1, 'Preparing a statement'] │ │ │ │ │ + ['statement_47', ['statement', ['../prepared.html#autotoc_md30', 1, 'A special prepared statement'], │ │ │ │ │ + ['../prepared.html#autotoc_md28', 1, 'Preparing a statement'] │ │ │ │ │ ]], │ │ │ │ │ ['statement_20parameters_48', ['Statement parameters', ['../parameters.html', 1, '']]], │ │ │ │ │ ['statement_5fcompletion_5funknown_49', ['statement_completion_unknown', ['../group__exception.html#structpqxx_1_1statement__completion__unknown', 1, 'pqxx']]], │ │ │ │ │ ['statements_50', ['Prepared statements', ['../prepared.html', 1, '']]], │ │ │ │ │ ['str_51', ['str', ['../group__escaping-functions.html#a9686dbe184806d5e115d9842aa3484dd', 1, 'pqxx::binarystring']]], │ │ │ │ │ ['stream_52', ['stream', ['../group__transactions.html#a742319e1c35632e9e3b14b91b64d5b4b', 1, 'pqxx::transaction_base::stream(std::string_view query, params parms) &'], │ │ │ │ │ ['../group__transactions.html#aec4d0f102c2c0fab8fa1a48f452abc0f', 1, 'pqxx::transaction_base::stream(std::string_view query) &'] │ │ │ │ │ ]], │ │ │ │ │ - ['stream_5ffrom_53', ['stream_from', ['../classpqxx_1_1stream__from.html#a832fe2b217cf7e1a5496d35f75dcd15c', 1, 'pqxx::stream_from::stream_from(transaction_base &tx, from_table_t, std::string_view table, Columns const &columns)'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#a11a6e30a28260f10fa9bfbd6f7ea36c4', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_query_t, std::string_view query)'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#a3c4cd42c50e3e90282ea5570ddb19e70', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_table_t, std::string_view table)'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#a0f32402331d7f2b8ed73419f1eed22ba', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_table_t, std::string_view table, Iter columns_begin, Iter columns_end)'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#abcfe96b18d9e2c4177799248fe143807', 1, 'pqxx::stream_from::stream_from(transaction_base &tx, std::string_view table)'], │ │ │ │ │ + ['stream_5ffrom_53', ['stream_from', ['../classpqxx_1_1stream__from.html#a6afe5f8cdb8f158b46fa9c616c7864bf', 1, 'pqxx::stream_from::stream_from(transaction_base &, std::string_view table, Iter columns_begin, Iter columns_end)'], │ │ │ │ │ ['../classpqxx_1_1stream__from.html#a38b17b7198ed153d01e42d5873cdf070', 1, 'pqxx::stream_from::stream_from(transaction_base &tx, std::string_view table, Columns const &columns)'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#a6afe5f8cdb8f158b46fa9c616c7864bf', 1, 'pqxx::stream_from::stream_from(transaction_base &, std::string_view table, Iter columns_begin, Iter columns_end)'], │ │ │ │ │ + ['../classpqxx_1_1stream__from.html#abcfe96b18d9e2c4177799248fe143807', 1, 'pqxx::stream_from::stream_from(transaction_base &tx, std::string_view table)'], │ │ │ │ │ + ['../classpqxx_1_1stream__from.html#a832fe2b217cf7e1a5496d35f75dcd15c', 1, 'pqxx::stream_from::stream_from(transaction_base &tx, from_table_t, std::string_view table, Columns const &columns)'], │ │ │ │ │ + ['../classpqxx_1_1stream__from.html#a0f32402331d7f2b8ed73419f1eed22ba', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_table_t, std::string_view table, Iter columns_begin, Iter columns_end)'], │ │ │ │ │ + ['../classpqxx_1_1stream__from.html#a3c4cd42c50e3e90282ea5570ddb19e70', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_table_t, std::string_view table)'], │ │ │ │ │ + ['../classpqxx_1_1stream__from.html#a11a6e30a28260f10fa9bfbd6f7ea36c4', 1, 'pqxx::stream_from::stream_from(transaction_base &, from_query_t, std::string_view query)'], │ │ │ │ │ ['../classpqxx_1_1stream__from.html', 1, 'pqxx::stream_from'] │ │ │ │ │ ]], │ │ │ │ │ ['stream_5ffrom_5finput_5fiterator_54', ['stream_from_input_iterator', ['../classpqxx_1_1internal_1_1stream__from__input__iterator.html', 1, 'pqxx::internal::stream_from_input_iterator< TYPE >'], │ │ │ │ │ ['../classpqxx_1_1internal_1_1stream__from__input__iterator.html#a6ee371294bb42b9e604d7313d0878a61', 1, 'pqxx::internal::stream_from_input_iterator::stream_from_input_iterator()'] │ │ │ │ │ ]], │ │ │ │ │ ['stream_5finput_5fiteration_55', ['stream_input_iteration', ['../classpqxx_1_1internal_1_1stream__input__iteration.html', 1, 'pqxx::internal']]], │ │ │ │ │ - ['stream_5fquery_56', ['stream_query', ['../namespacepqxx.html#classpqxx_1_1stream__query', 1, 'pqxx::stream_query< TYPE >'], │ │ │ │ │ - ['../classpqxx_1_1internal_1_1stream__query.html', 1, 'pqxx::internal::stream_query< TYPE >'], │ │ │ │ │ + ['stream_5fquery_56', ['stream_query', ['../classpqxx_1_1internal_1_1stream__query.html', 1, 'pqxx::internal::stream_query< TYPE >'], │ │ │ │ │ + ['../namespacepqxx.html#classpqxx_1_1stream__query', 1, 'pqxx::stream_query< TYPE >'], │ │ │ │ │ ['../classpqxx_1_1internal_1_1stream__query.html#ab7226acb2456b26777af0dd772e94bc9', 1, 'pqxx::internal::stream_query::stream_query(transaction_base &tx, std::string_view query, params const &)'], │ │ │ │ │ ['../classpqxx_1_1internal_1_1stream__query.html#a82a1a8435b756b9cb075f4a9a2fc6c09', 1, 'pqxx::internal::stream_query::stream_query(transaction_base &tx, std::string_view query)'] │ │ │ │ │ ]], │ │ │ │ │ ['stream_5fquery_5fend_5fiterator_57', ['stream_query_end_iterator', ['../namespacepqxx_1_1internal.html#classpqxx_1_1internal_1_1stream__query__end__iterator', 1, 'pqxx::internal']]], │ │ │ │ │ ['stream_5fquery_5finput_5fiterator_58', ['stream_query_input_iterator', ['../classpqxx_1_1internal_1_1stream__query__input__iterator.html', 1, 'pqxx::internal']]], │ │ │ │ │ - ['stream_5fto_59', ['stream_to', ['../classpqxx_1_1stream__to.html', 1, 'pqxx::stream_to'], │ │ │ │ │ - ['../classpqxx_1_1stream__to.html#a3491f56118589adff7b7fc214689ad67', 1, 'pqxx::stream_to::stream_to(transaction_base &, std::string_view table_name, Columns const &columns)'], │ │ │ │ │ - ['../classpqxx_1_1stream__to.html#a726187a18a93a4c5cc2343bcb9e97da8', 1, 'pqxx::stream_to::stream_to(transaction_base &tx, std::string_view table_name)'] │ │ │ │ │ - ]], │ │ │ │ │ - ['streaming_20data_20em_20from_20a_20query_20em_60', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ - ['streaming_20data_20em_20into_20a_20table_20em_61', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ - ['streaming_20right_20for_20my_20query_62', ['Is streaming right for my query?', ['../streams.html#autotoc_md27', 1, '']]], │ │ │ │ │ + ['stream_5fto_59', ['stream_to', ['../classpqxx_1_1stream__to.html#a3491f56118589adff7b7fc214689ad67', 1, 'pqxx::stream_to::stream_to(transaction_base &, std::string_view table_name, Columns const &columns)'], │ │ │ │ │ + ['../classpqxx_1_1stream__to.html#a726187a18a93a4c5cc2343bcb9e97da8', 1, 'pqxx::stream_to::stream_to(transaction_base &tx, std::string_view table_name)'], │ │ │ │ │ + ['../classpqxx_1_1stream__to.html', 1, 'pqxx::stream_to'] │ │ │ │ │ + ]], │ │ │ │ │ + ['streaming_20data_20em_20from_20a_20query_20em_60', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ + ['streaming_20data_20em_20into_20a_20table_20em_61', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ + ['streaming_20right_20for_20my_20query_62', ['Is streaming right for my query?', ['../streams.html#autotoc_md22', 1, '']]], │ │ │ │ │ ['streaming_20rows_63', ['Streaming rows', ['../accessing-results.html#autotoc_md1', 1, '']]], │ │ │ │ │ ['streams_64', ['Streams', ['../streams.html', 1, '']]], │ │ │ │ │ ['string_20conversion_65', ['String conversion', ['../group__stringconversion.html', 1, '']]], │ │ │ │ │ ['string_20escaping_66', ['String escaping', ['../escaping.html', 1, '']]], │ │ │ │ │ ['string_20escaping_20functions_67', ['String-escaping functions', ['../group__escaping-functions.html', 1, '']]], │ │ │ │ │ ['string_5ftraits_68', ['string_traits', ['../structpqxx_1_1string__traits.html', 1, 'pqxx']]], │ │ │ │ │ - ['string_5ftraits_20tt_69', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md11', 1, '']]], │ │ │ │ │ + ['string_5ftraits_20tt_69', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ ['string_5ftraits_3c_20binarystring_20_3e_70', ['string_traits< binarystring >', ['../structpqxx_1_1string__traits_3_01binarystring_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20bool_20_3e_71', ['string_traits< bool >', ['../structpqxx_1_1string__traits_3_01bool_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20bytes_20_3e_72', ['string_traits< bytes >', ['../structpqxx_1_1string__traits_3_01bytes_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20bytes_5fview_20_3e_73', ['string_traits< bytes_view >', ['../structpqxx_1_1string__traits_3_01bytes__view_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20char_20_2a_20_3e_74', ['string_traits< char * >', ['../structpqxx_1_1string__traits_3_01char_01_5_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20char_20_3e_75', ['string_traits< char >', ['../structpqxx_1_1string__traits_3_01char_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20char_20const_20_2a_20_3e_76', ['string_traits< char const * >', ['../structpqxx_1_1string__traits_3_01char_01const_01_5_01_4.html', 1, 'pqxx']]], │ │ │ │ │ @@ -150,20 +150,20 @@ │ │ │ │ │ ['string_5ftraits_3c_20unsigned_20long_20long_20_3e_104', ['string_traits< unsigned long long >', ['../structpqxx_1_1string__traits_3_01unsigned_01long_01long_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20unsigned_20short_20_3e_105', ['string_traits< unsigned short >', ['../structpqxx_1_1string__traits_3_01unsigned_01short_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5ftraits_3c_20zview_20_3e_106', ['string_traits< zview >', ['../structpqxx_1_1string__traits_3_01zview_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['string_5fvalue_107', ['string_value', ['../classpqxx_1_1array__parser.html#a039577d83d313a6daf35fd7c273e189ea863a85b49df560a48bb166fcbf59f8b4', 1, 'pqxx::array_parser']]], │ │ │ │ │ ['strip_5ft_108', ['strip_t', ['../namespacepqxx.html#a316a1521470224aad07d24109ff0043d', 1, 'pqxx']]], │ │ │ │ │ ['strip_5ftypes_109', ['strip_types', ['../namespacepqxx_1_1internal.html#a9b4647a83a27f2d3adc9add80c55dec3', 1, 'pqxx::internal']]], │ │ │ │ │ ['strip_5ftypes_5ft_110', ['strip_types_t', ['../namespacepqxx_1_1internal.html#a8e0a910c85d42eaa8d5948fae092cf16', 1, 'pqxx::internal']]], │ │ │ │ │ - ['subtransaction_111', ['subtransaction', ['../group__transactions.html#aa351325206ada1be7f3db4fa69145c4d', 1, 'pqxx::subtransaction::subtransaction()'], │ │ │ │ │ - ['../group__transactions.html#classpqxx_1_1subtransaction', 1, 'pqxx::subtransaction'], │ │ │ │ │ - ['../group__transactions.html#abec3848ca61ae755fab531e791ce89d8', 1, 'pqxx::subtransaction::subtransaction()'] │ │ │ │ │ + ['subtransaction_111', ['subtransaction', ['../group__transactions.html#abec3848ca61ae755fab531e791ce89d8', 1, 'pqxx::subtransaction::subtransaction(dbtransaction &t, std::string_view tname=""sv)'], │ │ │ │ │ + ['../group__transactions.html#aa351325206ada1be7f3db4fa69145c4d', 1, 'pqxx::subtransaction::subtransaction(subtransaction &t, std::string_view name=""sv)'], │ │ │ │ │ + ['../group__transactions.html#classpqxx_1_1subtransaction', 1, 'pqxx::subtransaction'] │ │ │ │ │ ]], │ │ │ │ │ ['super_112', ['super', ['../classpqxx_1_1internal_1_1callgate.html#afb620090453fc901f4fa147ee60bde36', 1, 'pqxx::internal::callgate']]], │ │ │ │ │ - ['supporting_20a_20new_20type_113', ['Supporting a new type', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ + ['supporting_20a_20new_20type_113', ['Supporting a new type', ['../datatypes.html#autotoc_md5', 1, '']]], │ │ │ │ │ ['supporting_20additional_20data_20types_114', ['Supporting additional data types', ['../datatypes.html', 1, '']]], │ │ │ │ │ - ['swap_115', ['swap', ['../group__escaping-functions.html#ad6e5000885dd6f0b7bdf1f5d7f365dd9', 1, 'pqxx::binarystring::swap()'], │ │ │ │ │ - ['../classpqxx_1_1result.html#ad1d929a8c555ef0e4e84d4dbcf56c05e', 1, 'pqxx::result::swap()'], │ │ │ │ │ - ['../classpqxx_1_1const__result__iterator.html#a3a7cd99d4e801fca6a538dbad3c7bba6', 1, 'pqxx::const_result_iterator::swap()'] │ │ │ │ │ + ['swap_115', ['swap', ['../classpqxx_1_1result.html#ad1d929a8c555ef0e4e84d4dbcf56c05e', 1, 'pqxx::result::swap()'], │ │ │ │ │ + ['../classpqxx_1_1const__result__iterator.html#a3a7cd99d4e801fca6a538dbad3c7bba6', 1, 'pqxx::const_result_iterator::swap()'], │ │ │ │ │ + ['../group__escaping-functions.html#ad6e5000885dd6f0b7bdf1f5d7f365dd9', 1, 'pqxx::binarystring::swap()'] │ │ │ │ │ ]], │ │ │ │ │ ['syntax_5ferror_116', ['syntax_error', ['../group__exception.html#structpqxx_1_1syntax__error', 1, 'pqxx']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,39 +1,39 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ ['table_0', ['table', ['../classpqxx_1_1field.html#aee9267454dca1a3457fb86e2f0046feb', 1, 'pqxx::field::table()'], │ │ │ │ │ ['../classpqxx_1_1stream__from.html#a8bd03db93560766414f74258202f86fd', 1, 'pqxx::stream_from::table()'], │ │ │ │ │ ['../classpqxx_1_1stream__to.html#a34d7ca93963c0b5733a9ebcc10f2429b', 1, 'pqxx::stream_to::table()'] │ │ │ │ │ ]], │ │ │ │ │ - ['table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ ['table_5fcolumn_2', ['table_column', ['../classpqxx_1_1field.html#a884880e40a43bad2733a167340896192', 1, 'pqxx::field::table_column()'], │ │ │ │ │ ['../classpqxx_1_1result.html#ae65c4fb3934978bba367ab61811aabec', 1, 'pqxx::result::table_column(row_size_type col_num) const'], │ │ │ │ │ ['../classpqxx_1_1result.html#a22161b4bebb52ef85a51509302b5a8a9', 1, 'pqxx::result::table_column(zview col_name) const'], │ │ │ │ │ ['../classpqxx_1_1row.html#a0cc2133611f007e7390988f6110245c8', 1, 'pqxx::row::table_column(size_type) const'], │ │ │ │ │ ['../classpqxx_1_1row.html#add6bd3b28ccb8178a072e8d3d19b9616', 1, 'pqxx::row::table_column(zview col_name) const'] │ │ │ │ │ ]], │ │ │ │ │ ['table_5fpath_3', ['table_path', ['../namespacepqxx.html#a7f913d1e427c805856ac303db75c1e57', 1, 'pqxx']]], │ │ │ │ │ ['tell_4', ['tell', ['../classpqxx_1_1largeobjectaccess.html#a972d8559cae789984a194c98a88b943b', 1, 'pqxx::largeobjectaccess::tell()'], │ │ │ │ │ ['../classpqxx_1_1blob.html#a88f116eb30c662386e02a1a47fd859b8', 1, 'pqxx::blob::tell()'] │ │ │ │ │ ]], │ │ │ │ │ - ['the_20esc_20functions_5', ['Using the esc functions', ['../escaping.html#autotoc_md5', 1, '']]], │ │ │ │ │ + ['the_20esc_20functions_5', ['Using the esc functions', ['../escaping.html#autotoc_md17', 1, '']]], │ │ │ │ │ ['thread_20safety_6', ['Thread safety', ['../thread-safety.html', 1, '']]], │ │ │ │ │ ['thread_5fsafety_5fmodel_7', ['thread_safety_model', ['../namespacepqxx.html#structpqxx_1_1thread__safety__model', 1, 'pqxx']]], │ │ │ │ │ ['throw_5fnull_5fconversion_8', ['throw_null_conversion', ['../namespacepqxx_1_1internal.html#ab228c862d33c75405472dccf8a34dfa3', 1, 'pqxx::internal::throw_null_conversion(std::string_view type)'], │ │ │ │ │ ['../namespacepqxx_1_1internal.html#a14aec6b418ba2b5867987eb22bd867ce', 1, 'pqxx::internal::throw_null_conversion(std::string const &type)'] │ │ │ │ │ ]], │ │ │ │ │ ['to_9', ['to', ['../classpqxx_1_1field.html#a31433b3a426646a23e1d11f3242a3885', 1, 'pqxx::field::to(T &obj, T const &default_value) const -> typename std::enable_if_t<(not std::is_pointer< T >::value or std::is_same< T, char const * >::value), bool >'], │ │ │ │ │ ['../classpqxx_1_1field.html#a1e87e9981c60d37516326e7ab6b26da6', 1, 'pqxx::field::to(char const *&obj) const'], │ │ │ │ │ ['../classpqxx_1_1row.html#ac478a252d2bac75e1fe0d65fd99f9042', 1, 'pqxx::row::to()'], │ │ │ │ │ ['../classpqxx_1_1field.html#a5c13391d9f288b83419cca7865b5be62', 1, 'pqxx::field::to()'] │ │ │ │ │ ]], │ │ │ │ │ ['to_5fbuf_10', ['to_buf', ['../classpqxx_1_1blob.html#abfc3b8c4faeab1f394422d474114e121', 1, 'pqxx::blob::to_buf()'], │ │ │ │ │ ['../structpqxx_1_1internal_1_1float__traits.html#ad1728a05cf18dfe9e200b54b9d8fb38d', 1, 'pqxx::internal::float_traits::to_buf()'], │ │ │ │ │ ['../structpqxx_1_1string__traits.html#a81b2526f70d7191c37e36fb78530b977', 1, 'pqxx::string_traits::to_buf()'] │ │ │ │ │ ]], │ │ │ │ │ - ['to_5fbuf_20tt_11', ['<tt>to_buf</tt>', ['../datatypes.html#autotoc_md13', 1, '']]], │ │ │ │ │ + ['to_5fbuf_20tt_11', ['<tt>to_buf</tt>', ['../datatypes.html#autotoc_md11', 1, '']]], │ │ │ │ │ ['to_5ffile_12', ['to_file', ['../classpqxx_1_1blob.html#a373c4d3df0068d18e75f8bdbf619ac90', 1, 'pqxx::blob::to_file()'], │ │ │ │ │ ['../classpqxx_1_1largeobject.html#a4fb862c252771c8ad4449f8badf2b26f', 1, 'pqxx::largeobject::to_file()'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#acdbc859cf3afd0ddcc4aa555ef36c35a', 1, 'pqxx::largeobjectaccess::to_file(std::string_view file) const'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#a4fb862c252771c8ad4449f8badf2b26f', 1, 'pqxx::largeobjectaccess::to_file(dbtransaction &t, std::string_view file) const'] │ │ │ │ │ ]], │ │ │ │ │ ['to_5fstring_13', ['to_string', ['../namespacepqxx.html#accab0ae142ee4c6789f5252578d0d478', 1, 'pqxx']]], │ │ │ │ │ ['to_5fstring_5ffloat_14', ['to_string_float', ['../namespacepqxx_1_1internal.html#acc9749f398f41d29c41e5b4475735f3d', 1, 'pqxx::internal::to_string_float(T)'], │ │ │ │ │ @@ -48,28 +48,28 @@ │ │ │ │ │ ['../group__transactions.html#classpqxx_1_1transaction__base', 1, 'pqxx::transaction_base'] │ │ │ │ │ ]], │ │ │ │ │ ['transaction_5fbase_3a_3aquery_5fvalue_3c_20std_3a_3astring_5fview_20_3e_19', ['query_value< std::string_view >', ['../namespacepqxx.html#a8f5d10354025255ae20e29fa024d22b3', 1, 'pqxx']]], │ │ │ │ │ ['transaction_5ffocus_20', ['transaction_focus', ['../classpqxx_1_1transaction__focus.html', 1, 'pqxx']]], │ │ │ │ │ ['transaction_5frollback_21', ['transaction_rollback', ['../group__exception.html#structpqxx_1_1transaction__rollback', 1, 'pqxx']]], │ │ │ │ │ ['transaction_5fsql_5fcursor_22', ['transaction_sql_cursor', ['../classpqxx_1_1internal_1_1gate_1_1transaction__sql__cursor.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['transaction_5ftransaction_5ffocus_23', ['transaction_transaction_focus', ['../classpqxx_1_1internal_1_1gate_1_1transaction__transaction__focus.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ - ['transactions_24', ['Transactions', ['../classpqxx_1_1connection.html#autotoc_md30', 1, '']]], │ │ │ │ │ + ['transactions_24', ['Transactions', ['../classpqxx_1_1connection.html#autotoc_md25', 1, '']]], │ │ │ │ │ ['transactor_20framework_25', ['Transactor framework', ['../group__transactor.html', 1, '']]], │ │ │ │ │ - ['tt_20from_5fstring_20tt_26', ['<tt>from_string</tt>', ['../datatypes.html#autotoc_md12', 1, '']]], │ │ │ │ │ - ['tt_20into_5fbuf_20tt_27', ['<tt>into_buf</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ - ['tt_20is_5funquoted_5fsafe_20tt_28', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md16', 1, '']]], │ │ │ │ │ - ['tt_20nullness_20tt_29', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md10', 1, '']]], │ │ │ │ │ - ['tt_20param_5fformat_20tt_30', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md17', 1, '']]], │ │ │ │ │ - ['tt_20size_5fbuffer_20tt_31', ['<tt>size_buffer</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ - ['tt_20string_5ftraits_20tt_32', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md11', 1, '']]], │ │ │ │ │ - ['tt_20to_5fbuf_20tt_33', ['<tt>to_buf</tt>', ['../datatypes.html#autotoc_md13', 1, '']]], │ │ │ │ │ - ['tt_20type_5fname_20tt_34', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ - ['type_35', ['type', ['../datatypes.html#autotoc_md7', 1, 'Supporting a new type'], │ │ │ │ │ + ['tt_20from_5fstring_20tt_26', ['<tt>from_string</tt>', ['../datatypes.html#autotoc_md10', 1, '']]], │ │ │ │ │ + ['tt_20into_5fbuf_20tt_27', ['<tt>into_buf</tt>', ['../datatypes.html#autotoc_md12', 1, '']]], │ │ │ │ │ + ['tt_20is_5funquoted_5fsafe_20tt_28', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['tt_20nullness_20tt_29', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['tt_20param_5fformat_20tt_30', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ + ['tt_20size_5fbuffer_20tt_31', ['<tt>size_buffer</tt>', ['../datatypes.html#autotoc_md13', 1, '']]], │ │ │ │ │ + ['tt_20string_5ftraits_20tt_32', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ + ['tt_20to_5fbuf_20tt_33', ['<tt>to_buf</tt>', ['../datatypes.html#autotoc_md11', 1, '']]], │ │ │ │ │ + ['tt_20type_5fname_20tt_34', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ + ['type_35', ['type', ['../datatypes.html#autotoc_md5', 1, 'Supporting a new type'], │ │ │ │ │ ['../classpqxx_1_1field.html#ad2da9b613fdf2b38a36e92eafd9b223a', 1, 'pqxx::field::type()'], │ │ │ │ │ - ['../datatypes.html#autotoc_md8', 1, 'Your type'] │ │ │ │ │ + ['../datatypes.html#autotoc_md6', 1, 'Your type'] │ │ │ │ │ ]], │ │ │ │ │ ['type_5fname_36', ['type_name', ['../namespacepqxx.html#a03b51dc175989959be170596670dafa4', 1, 'pqxx']]], │ │ │ │ │ - ['type_5fname_20tt_37', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md9', 1, '']]], │ │ │ │ │ - ['types_38', ['types', ['../datatypes.html#autotoc_md6', 1, 'Converting types'], │ │ │ │ │ + ['type_5fname_20tt_37', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ + ['types_38', ['types', ['../datatypes.html#autotoc_md4', 1, 'Converting types'], │ │ │ │ │ ['../datatypes.html', 1, 'Supporting additional data types'] │ │ │ │ │ ]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_13.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -18,10 +18,10 @@ │ │ │ │ │ ['unexpected_5frows_7', ['unexpected_rows', ['../group__exception.html#structpqxx_1_1unexpected__rows', 1, 'pqxx']]], │ │ │ │ │ ['unique_5fviolation_8', ['unique_violation', ['../group__exception.html#structpqxx_1_1unique__violation', 1, 'pqxx']]], │ │ │ │ │ ['unprepare_9', ['unprepare', ['../classpqxx_1_1connection.html#a5cbd8240e3c74b595ccb535c941433ae', 1, 'pqxx::connection']]], │ │ │ │ │ ['update_10', ['update', ['../classpqxx_1_1cursor__base.html#ace67894e61fba0ce9f9f6e5b9dd33083a12fa229ee3e760f1ca86d66304554b63', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['update_5fpolicy_11', ['update_policy', ['../classpqxx_1_1cursor__base.html#ace67894e61fba0ce9f9f6e5b9dd33083', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['usage_5ferror_12', ['usage_error', ['../group__exception.html#structpqxx_1_1usage__error', 1, 'pqxx']]], │ │ │ │ │ ['username_13', ['username', ['../classpqxx_1_1connection.html#a9d7c7ab0c54a258ac4fab0d562fdbacd', 1, 'pqxx::connection']]], │ │ │ │ │ - ['using_20the_20esc_20functions_14', ['Using the esc functions', ['../escaping.html#autotoc_md5', 1, '']]], │ │ │ │ │ + ['using_20the_20esc_20functions_14', ['Using the esc functions', ['../escaping.html#autotoc_md17', 1, '']]], │ │ │ │ │ ['utility_20functions_15', ['Utility functions', ['../group__utility.html', 1, '']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_14.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,11 +1,11 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ ['value_0', ['value', ['../classpqxx_1_1range__bound.html#a76d25b17ed6af78070b888f5effe70ba', 1, 'pqxx::range_bound']]], │ │ │ │ │ ['value_5ftype_1', ['value_type', ['../namespacepqxx.html#a934fca7aa1250b4c488ac2f09ac2bf1b', 1, 'pqxx']]], │ │ │ │ │ - ['values_2', ['values', ['../streams.html#autotoc_md25', 1, 'Interlude: null values'], │ │ │ │ │ + ['values_2', ['values', ['../streams.html#autotoc_md20', 1, 'Interlude: null values'], │ │ │ │ │ ['../structpqxx_1_1internal_1_1c__params.html#aad4eb2f440fe907fcf11467effbbff15', 1, 'pqxx::internal::c_params::values'] │ │ │ │ │ ]], │ │ │ │ │ ['variable_5fset_5fto_5fnull_3', ['variable_set_to_null', ['../group__exception.html#structpqxx_1_1variable__set__to__null', 1, 'pqxx']]], │ │ │ │ │ ['view_4', ['view', ['../group__escaping-functions.html#a882b8988b2b48a9d3d254a25c559871e', 1, 'pqxx::binarystring::view()'], │ │ │ │ │ ['../classpqxx_1_1field.html#aa05908e8ed320fac8c96b9eb4cf46813', 1, 'pqxx::field::view()'], │ │ │ │ │ ['../classpqxx_1_1placeholders.html#a92d006575732b3ead81cbaf4892197ae', 1, 'pqxx::placeholders::view()'] │ │ │ │ │ ]] │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_16.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,3 +1,3 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['your_20type_0', ['Your type', ['../datatypes.html#autotoc_md8', 1, '']]] │ │ │ │ │ + ['your_20type_0', ['Your type', ['../datatypes.html#autotoc_md6', 1, '']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_17.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,9 +1,9 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['zero_20bytes_0', ['Zero bytes', ['../prepared.html#autotoc_md24', 1, '']]], │ │ │ │ │ + ['zero_20bytes_0', ['Zero bytes', ['../prepared.html#autotoc_md32', 1, '']]], │ │ │ │ │ ['zview_1', ['zview', ['../classpqxx_1_1zview.html', 1, 'pqxx::zview'], │ │ │ │ │ ['../classpqxx_1_1zview.html#a766cc45a178d43b1471fdc025f01535d', 1, 'pqxx::zview::zview(char const text[], std::ptrdiff_t len) noexcept(noexcept(std::string_view{text, static_cast< std::size_t >(len)}))'], │ │ │ │ │ ['../classpqxx_1_1zview.html#a581b8c75e8c2c0de579debfca37cd725', 1, 'pqxx::zview::zview(char text[], std::ptrdiff_t len) noexcept(noexcept(std::string_view{text, static_cast< std::size_t >(len)}))'], │ │ │ │ │ ['../classpqxx_1_1zview.html#aa713ad5896e247699dcb5be68528b0e8', 1, 'pqxx::zview::zview(std::string_view other) noexcept'], │ │ │ │ │ ['../classpqxx_1_1zview.html#a3ddf4e0ff127e96f8f68361088f96d2e', 1, 'pqxx::zview::zview(Args &&...args)'], │ │ │ │ │ ['../classpqxx_1_1zview.html#ad5928543720ef457a1ca229920f33de6', 1, 'pqxx::zview::zview(std::string const &str) noexcept'], │ │ │ │ │ ['../classpqxx_1_1zview.html#a9297b1b431ea593ea2ec6c8f0beaefa9', 1, 'pqxx::zview::zview(char const str[]) noexcept(noexcept(std::string_view{str}))'], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_2.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -12,15 +12,15 @@ │ │ │ │ │ ['callgate_3c_20errorhandler_20_3e_6', ['callgate< errorhandler >', ['../classpqxx_1_1internal_1_1callgate.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['callgate_3c_20icursor_5fiterator_20_3e_7', ['callgate< icursor_iterator >', ['../classpqxx_1_1internal_1_1callgate.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['callgate_3c_20icursorstream_20_3e_8', ['callgate< icursorstream >', ['../classpqxx_1_1internal_1_1callgate.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['callgate_3c_20result_20const_20_3e_9', ['callgate< result const >', ['../classpqxx_1_1internal_1_1callgate.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['callgate_3c_20transaction_5fbase_20_3e_10', ['callgate< transaction_base >', ['../classpqxx_1_1internal_1_1callgate.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['cancel_11', ['cancel', ['../classpqxx_1_1pipeline.html#ab375b0b4e02c7f1a48602c4186fbbbd7', 1, 'pqxx::pipeline']]], │ │ │ │ │ ['cancel_5fquery_12', ['cancel_query', ['../classpqxx_1_1connection.html#ad1719d51a24c5aa6bd58f03a328a3833', 1, 'pqxx::connection']]], │ │ │ │ │ - ['case_20sensitivity_13', ['Case sensitivity', ['../classpqxx_1_1connection.html#autotoc_md29', 1, '']]], │ │ │ │ │ + ['case_20sensitivity_13', ['Case sensitivity', ['../classpqxx_1_1connection.html#autotoc_md24', 1, '']]], │ │ │ │ │ ['cat2_14', ['cat2', ['../namespacepqxx_1_1internal.html#ae3d8bb14c1d7c63c57c59b61cf63ff09', 1, 'pqxx::internal']]], │ │ │ │ │ ['caveats_15', ['Caveats', ['../binary.html#autotoc_md3', 1, '']]], │ │ │ │ │ ['cbegin_16', ['cbegin', ['../classpqxx_1_1array.html#aa091e8641639a3802f44b565194d1119', 1, 'pqxx::array']]], │ │ │ │ │ ['cend_17', ['cend', ['../classpqxx_1_1array.html#a14d57111c8af2324a8e9e8e3df162d9d', 1, 'pqxx::array']]], │ │ │ │ │ ['channel_18', ['channel', ['../classpqxx_1_1notification__receiver.html#a57732bae437844782bdfe6314f829d9a', 1, 'pqxx::notification_receiver::channel()'], │ │ │ │ │ ['../namespacepqxx.html#adb60a62bb5ba0afac027989fe3f0869b', 1, 'pqxx::notification::channel'] │ │ │ │ │ ]], │ │ │ │ │ @@ -115,15 +115,15 @@ │ │ │ │ │ ['contains_70', ['contains', ['../classpqxx_1_1range.html#a3f5071556ce9c0b77e6e4a006b6c51fe', 1, 'pqxx::range::contains(range< TYPE > const &other) const noexcept(noexcept((*this &other)==other))'], │ │ │ │ │ ['../classpqxx_1_1range.html#a2fa03d4ad40c545610bdc382e2aff187', 1, 'pqxx::range::contains(TYPE value) const noexcept(noexcept(m_lower.extends_down_to(value)) and noexcept(m_upper.extends_up_to(value)))'] │ │ │ │ │ ]], │ │ │ │ │ ['conversion_71', ['String conversion', ['../group__stringconversion.html', 1, '']]], │ │ │ │ │ ['conversion_5ferror_72', ['conversion_error', ['../group__exception.html#structpqxx_1_1conversion__error', 1, 'pqxx']]], │ │ │ │ │ ['conversion_5foverrun_73', ['conversion_overrun', ['../group__exception.html#structpqxx_1_1conversion__overrun', 1, 'pqxx']]], │ │ │ │ │ ['convert_74', ['convert', ['../classpqxx_1_1row.html#af81dc44f173ab151bd052f339c10521f', 1, 'pqxx::row']]], │ │ │ │ │ - ['converting_20types_75', ['Converting types', ['../datatypes.html#autotoc_md6', 1, '']]], │ │ │ │ │ + ['converting_20types_75', ['Converting types', ['../datatypes.html#autotoc_md4', 1, '']]], │ │ │ │ │ ['converts_5ffrom_5fstring_76', ['converts_from_string', ['../structpqxx_1_1string__traits.html#afc7783fd1fd1020f8d400b318f1a0c10', 1, 'pqxx::string_traits']]], │ │ │ │ │ ['converts_5fto_5fstring_77', ['converts_to_string', ['../structpqxx_1_1string__traits.html#ac537955384e39377e84fd71ad6c80bfd', 1, 'pqxx::string_traits']]], │ │ │ │ │ ['count_78', ['count', ['../classpqxx_1_1placeholders.html#a254b9519ce26aee58826afcd4dadb778', 1, 'pqxx::placeholders']]], │ │ │ │ │ ['crbegin_79', ['crbegin', ['../classpqxx_1_1array.html#a2499a20fcc7d9da7e7f303b6e16fb254', 1, 'pqxx::array']]], │ │ │ │ │ ['cread_80', ['cread', ['../classpqxx_1_1largeobjectaccess.html#ac43433ab08b3ccb34fc72ea4975bcda2', 1, 'pqxx::largeobjectaccess']]], │ │ │ │ │ ['create_81', ['create', ['../classpqxx_1_1blob.html#a008264c527d6806ea2b190dd8b75dc11', 1, 'pqxx::blob']]], │ │ │ │ │ ['crend_82', ['crend', ['../classpqxx_1_1array.html#ac2f300e0917b8e0afbc9d77bbc26534a', 1, 'pqxx::array']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_3.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,14 +1,14 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ ['data_0', ['data', ['../binary.html', 1, 'Binary data'], │ │ │ │ │ ['../group__escaping-functions.html#aa8e2854a33324620fb8ba3bb0176fa51', 1, 'pqxx::binarystring::data()'], │ │ │ │ │ ['../accessing-results.html#autotoc_md0', 1, 'Querying rows of data'] │ │ │ │ │ ]], │ │ │ │ │ - ['data_20em_20from_20a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ - ['data_20em_20into_20a_20table_20em_2', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['data_20em_20from_20a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ + ['data_20em_20into_20a_20table_20em_2', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ ['data_20types_3', ['Supporting additional data types', ['../datatypes.html', 1, '']]], │ │ │ │ │ ['data_5fexception_4', ['data_exception', ['../group__exception.html#structpqxx_1_1data__exception', 1, 'pqxx']]], │ │ │ │ │ ['dbname_5', ['dbname', ['../classpqxx_1_1connection.html#a286e275a7701a8ac96f839cbf8205258', 1, 'pqxx::connection']]], │ │ │ │ │ ['dbtransaction_6', ['dbtransaction', ['../group__transactions.html#classpqxx_1_1dbtransaction', 1, 'pqxx::dbtransaction'], │ │ │ │ │ ['../group__transactions.html#a1a93f046a44aa6018495a537ee06e0db', 1, 'pqxx::dbtransaction::dbtransaction(connection &cx, std::string_view tname, std::shared_ptr< std::string > rollback_cmd)'], │ │ │ │ │ ['../group__transactions.html#ae58d1c6a70b3d5c87ae066c49b2cd671', 1, 'pqxx::dbtransaction::dbtransaction(connection &cx, std::string_view tname)'], │ │ │ │ │ ['../group__transactions.html#a1d75492f91f1e0de3d970af6e6127a05', 1, 'pqxx::dbtransaction::dbtransaction(connection &cx)'] │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_4.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,18 +1,18 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['em_20from_20a_20query_20em_0', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ - ['em_20into_20a_20table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['em_20from_20a_20query_20em_0', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ + ['em_20into_20a_20table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ ['empty_2', ['empty', ['../classpqxx_1_1row.html#a05994def0b6c7b426bb13a7a95e9e035', 1, 'pqxx::row::empty()'], │ │ │ │ │ ['../classpqxx_1_1range.html#ac91cd0e74ae28042d8f887107f0aef76', 1, 'pqxx::range::empty()'] │ │ │ │ │ ]], │ │ │ │ │ ['empty_5fresult_3', ['empty_result', ['../classpqxx_1_1internal_1_1sql__cursor.html#aa081894fff9516d7dc26a8f724db21aa', 1, 'pqxx::internal::sql_cursor']]], │ │ │ │ │ ['enc_5fgroup_4', ['enc_group', ['../namespacepqxx_1_1internal.html#a6a4fef10718297b22be8627e18e20fe0', 1, 'pqxx::internal::enc_group(std::string_view encoding_name)'], │ │ │ │ │ ['../namespacepqxx_1_1internal.html#aef85ea1bf0ba64165cf2719dc25b0424', 1, 'pqxx::internal::enc_group(int)'] │ │ │ │ │ ]], │ │ │ │ │ - ['encoding_5', ['Encoding', ['../classpqxx_1_1connection.html#autotoc_md32', 1, '']]], │ │ │ │ │ + ['encoding_5', ['Encoding', ['../classpqxx_1_1connection.html#autotoc_md27', 1, '']]], │ │ │ │ │ ['encoding_5fid_6', ['encoding_id', ['../classpqxx_1_1connection.html#a975747afe8d451004680741492b76ae5', 1, 'pqxx::connection']]], │ │ │ │ │ ['encrypt_5fpassword_7', ['encrypt_password', ['../namespacepqxx.html#a204a7f521845d2fa16035b60eab9ddbb', 1, 'pqxx::encrypt_password()'], │ │ │ │ │ ['../classpqxx_1_1connection.html#a0724de6ed0e9b65267967adaa34c4f78', 1, 'pqxx::connection::encrypt_password(zview user, zview password, zview algorithm)'], │ │ │ │ │ ['../classpqxx_1_1connection.html#aecfa98ec5ec1e783ed8e8737b587a9f0', 1, 'pqxx::connection::encrypt_password(char const user[], char const password[], char const *algorithm=nullptr)'], │ │ │ │ │ ['../namespacepqxx.html#abb5e089e78f78ecb49a5da2c802113bd', 1, 'pqxx::encrypt_password()'] │ │ │ │ │ ]], │ │ │ │ │ ['end_8', ['end', ['../classpqxx_1_1internal_1_1stream__query.html#afccfe3b559c68913f5161f3a8ee0ad80', 1, 'pqxx::internal::stream_query']]], │ │ │ │ │ @@ -30,29 +30,29 @@ │ │ │ │ │ ]], │ │ │ │ │ ['errorhandler_5fconnection_18', ['errorhandler_connection', ['../classpqxx_1_1internal_1_1gate_1_1errorhandler__connection.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['esc_19', ['esc', ['../classpqxx_1_1connection.html#a6e6bc476091af546f880c9c572f05375', 1, 'pqxx::connection::esc(std::string_view text) const'], │ │ │ │ │ ['../classpqxx_1_1connection.html#aa29f2e36001c4715e898f2c1a2ca9d5a', 1, 'pqxx::connection::esc(char const text[]) const'], │ │ │ │ │ ['../classpqxx_1_1connection.html#ab2fd28a1d384854642cc84dcd54cd450', 1, 'pqxx::connection::esc(char const text[], std::size_t maxlen) const'], │ │ │ │ │ ['../group__escaping-functions.html#ga6710c7298c40ae41b5d8326cbf2ad20e', 1, 'pqxx::transaction_base::esc()'] │ │ │ │ │ ]], │ │ │ │ │ - ['esc_20functions_20', ['Using the esc functions', ['../escaping.html#autotoc_md5', 1, '']]], │ │ │ │ │ + ['esc_20functions_20', ['Using the esc functions', ['../escaping.html#autotoc_md17', 1, '']]], │ │ │ │ │ ['esc_5fbin_21', ['esc_bin', ['../namespacepqxx_1_1internal.html#a842929aed32b7ff0f3178a7539b595d9', 1, 'pqxx::internal::esc_bin(bytes_view binary_data)'], │ │ │ │ │ ['../namespacepqxx_1_1internal.html#a89a78387ec5faabb426e0f519cad2b56', 1, 'pqxx::internal::esc_bin(bytes_view binary_data, char buffer[]) noexcept'] │ │ │ │ │ ]], │ │ │ │ │ ['esc_5flike_22', ['esc_like', ['../classpqxx_1_1connection.html#a7e8f054f91d4e61879039bfdff9b2889', 1, 'pqxx::connection::esc_like()'], │ │ │ │ │ ['../group__transactions.html#abb28d39ae66b1f36f7297b1e9d1c4e1a', 1, 'pqxx::transaction_base::esc_like(std::string_view bin, char escape_char='\\') const'] │ │ │ │ │ ]], │ │ │ │ │ ['esc_5fraw_23', ['esc_raw', ['../group__transactions.html#a7a64a944468f732eb1a78301ec940e29', 1, 'pqxx::transaction_base::esc_raw()'], │ │ │ │ │ ['../classpqxx_1_1connection.html#a72b6b843cbeb8555ade27ab831e6d6e9', 1, 'pqxx::connection::esc_raw(bytes_view) const'], │ │ │ │ │ ['../classpqxx_1_1connection.html#a22d2c852a4e1c159c021b04efc04f8e1', 1, 'pqxx::connection::esc_raw(unsigned char const bin[], std::size_t len) const'] │ │ │ │ │ ]], │ │ │ │ │ ['escaping_24', ['String escaping', ['../escaping.html', 1, '']]], │ │ │ │ │ ['escaping_20functions_25', ['String-escaping functions', ['../group__escaping-functions.html', 1, '']]], │ │ │ │ │ ['exception_20classes_26', ['Exception classes', ['../group__exception.html', 1, '']]], │ │ │ │ │ - ['exceptions_27', ['Exceptions', ['../classpqxx_1_1connection.html#autotoc_md31', 1, '']]], │ │ │ │ │ + ['exceptions_27', ['Exceptions', ['../classpqxx_1_1connection.html#autotoc_md26', 1, '']]], │ │ │ │ │ ['exclusive_5fbound_28', ['exclusive_bound', ['../classpqxx_1_1exclusive__bound.html', 1, 'pqxx']]], │ │ │ │ │ ['exec_29', ['exec', ['../group__transactions.html#a85f787b49568288912c3af52e29277dd', 1, 'pqxx::transaction_base::exec(std::stringstream const &query, std::string_view desc)'], │ │ │ │ │ ['../group__transactions.html#adae522da46299d4cd7c48128403e7c93', 1, 'pqxx::transaction_base::exec(std::string_view query, std::string_view desc)'], │ │ │ │ │ ['../group__transactions.html#ad453aadd28bda097281b15e1a7f6053f', 1, 'pqxx::transaction_base::exec(std::string_view query)'], │ │ │ │ │ ['../group__transactions.html#a0a8f8f741d218e84360a5d05e32d0358', 1, 'pqxx::transaction_base::exec(prepped statement)'], │ │ │ │ │ ['../group__transactions.html#ae64996a5e022cda4c9107fb70d05687f', 1, 'pqxx::transaction_base::exec(prepped statement, params const &parms)'] │ │ │ │ │ ]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_5.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -15,15 +15,15 @@ │ │ │ │ │ ['find_5fchar_8', ['find_char', ['../namespacepqxx_1_1internal.html#ac7f47e680c4aba12c395e1a854966a8e', 1, 'pqxx::internal']]], │ │ │ │ │ ['find_5fs_5fascii_5fchar_9', ['find_s_ascii_char', ['../namespacepqxx_1_1internal.html#a47911290f09c40ca080108ea376ffca9', 1, 'pqxx::internal']]], │ │ │ │ │ ['float_5ftraits_10', ['float_traits', ['../structpqxx_1_1internal_1_1float__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['float_5ftraits_3c_20double_20_3e_11', ['float_traits< double >', ['../structpqxx_1_1internal_1_1float__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['float_5ftraits_3c_20float_20_3e_12', ['float_traits< float >', ['../structpqxx_1_1internal_1_1float__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['float_5ftraits_3c_20long_20double_20_3e_13', ['float_traits< long double >', ['../structpqxx_1_1internal_1_1float__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['flush_14', ['flush', ['../classpqxx_1_1pipeline.html#a33a890c64efc37d76f3c649f145ff950', 1, 'pqxx::pipeline']]], │ │ │ │ │ - ['for_20my_20query_15', ['Is streaming right for my query?', ['../streams.html#autotoc_md27', 1, '']]], │ │ │ │ │ + ['for_20my_20query_15', ['Is streaming right for my query?', ['../streams.html#autotoc_md22', 1, '']]], │ │ │ │ │ ['for_5feach_16', ['for_each', ['../classpqxx_1_1result.html#a9302f9b61826f8b7b213f13b30453c0b', 1, 'pqxx::result']]], │ │ │ │ │ ['for_5fglyphs_17', ['for_glyphs', ['../namespacepqxx_1_1internal.html#a6d813d2723b73f1e674a9aa3229ab060', 1, 'pqxx::internal']]], │ │ │ │ │ ['for_5fquery_18', ['for_query', ['../group__transactions.html#aed05d9bf4a4d29e8f13ef92174489d86', 1, 'pqxx::transaction_base::for_query(zview query, CALLABLE &&func)'], │ │ │ │ │ ['../group__transactions.html#a2b72c8c8dec3714ba9bda0c4546e9c2f', 1, 'pqxx::transaction_base::for_query(zview query, CALLABLE &&func, params const &parms)'], │ │ │ │ │ ['../group__transactions.html#a08e4d94abccb520af509c2923d113c96', 1, 'pqxx::transaction_base::for_query(prepped statement, CALLABLE &&func, params const &parms={})'] │ │ │ │ │ ]], │ │ │ │ │ ['for_5fstream_19', ['for_stream', ['../group__transactions.html#aaf86f83eff8c7ca945c9921bddb75b14', 1, 'pqxx::transaction_base']]], │ │ │ │ │ @@ -33,32 +33,32 @@ │ │ │ │ │ ['forbidden_5fconversion_3c_20std_3a_3abyte_20_3e_23', ['forbidden_conversion< std::byte >', ['../structpqxx_1_1forbidden__conversion.html', 1, 'pqxx']]], │ │ │ │ │ ['forbidden_5fconversion_3c_20unsigned_20char_20_3e_24', ['forbidden_conversion< unsigned char >', ['../structpqxx_1_1forbidden__conversion.html', 1, 'pqxx']]], │ │ │ │ │ ['foreign_5fkey_5fviolation_25', ['foreign_key_violation', ['../group__exception.html#structpqxx_1_1foreign__key__violation', 1, 'pqxx']]], │ │ │ │ │ ['format_26', ['format', ['../namespacepqxx.html#afac7ada3a82bcd0e70131f9aede360ce', 1, 'pqxx']]], │ │ │ │ │ ['formats_27', ['formats', ['../structpqxx_1_1internal_1_1c__params.html#a9a6d51da90f51c90d3044ad9261616b8', 1, 'pqxx::internal::c_params']]], │ │ │ │ │ ['forward_5fonly_28', ['forward_only', ['../classpqxx_1_1cursor__base.html#ab2dbdc503c97b0200dd3eca6ae22f0a2af440221f717464c87f043899cc117cbf', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['framework_29', ['Transactor framework', ['../group__transactor.html', 1, '']]], │ │ │ │ │ - ['from_20a_20query_20em_30', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ + ['from_20a_20query_20em_30', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ ['from_5fbuf_31', ['from_buf', ['../classpqxx_1_1blob.html#ab1f3e5e083f3c69ecc32cc87aa4d8f90', 1, 'pqxx::blob']]], │ │ │ │ │ ['from_5ffile_32', ['from_file', ['../classpqxx_1_1blob.html#a41ea99b2f59cf0946986c14371915980', 1, 'pqxx::blob::from_file(dbtransaction &, char const path[])'], │ │ │ │ │ ['../classpqxx_1_1blob.html#acd468aa64cdd17c3dec34cb059721842', 1, 'pqxx::blob::from_file(dbtransaction &, char const path[], oid)'] │ │ │ │ │ ]], │ │ │ │ │ ['from_5fquery_33', ['from_query', ['../namespacepqxx.html#a31fff381823ee2bc5af1f47139b3b48c', 1, 'pqxx']]], │ │ │ │ │ ['from_5fquery_5ft_34', ['from_query_t', ['../namespacepqxx.html#structpqxx_1_1from__query__t', 1, 'pqxx']]], │ │ │ │ │ ['from_5fstring_35', ['from_string', ['../structpqxx_1_1string__traits.html#a09bce703d8e0234e84605038189381e8', 1, 'pqxx::string_traits::from_string()'], │ │ │ │ │ ['../structpqxx_1_1string__traits_3_01zview_01_4.html#a3b78a0d0dfbd5bf56c18d02e8a2ae184', 1, 'pqxx::string_traits< zview >::from_string()'], │ │ │ │ │ ['../structpqxx_1_1string__traits_3_01std_1_1string__view_01_4.html#a98acdd0a20f834be7670763ae0f93bcb', 1, 'pqxx::string_traits< std::string_view >::from_string()'], │ │ │ │ │ ['../namespacepqxx.html#ae3697fd4a0fc1fcdb40937e16e1ec878', 1, 'pqxx::from_string()'], │ │ │ │ │ ['../structpqxx_1_1string__traits_3_01char_0fN_0e_4.html#a45384953864d4858e8fa8549e4eeabf7', 1, 'pqxx::string_traits< char[N]>::from_string()'], │ │ │ │ │ ['../structpqxx_1_1string__traits_3_01char_01_5_01_4.html#af0ea80b9d8301a1a3211a1a5891521ea', 1, 'pqxx::string_traits< char * >::from_string()'], │ │ │ │ │ ['../structpqxx_1_1string__traits_3_01std_1_1variant_3_01T_8_8_8_01_4_01_4.html#a2672f0ae1c9d445d7c63929d8278b727', 1, 'pqxx::string_traits< std::variant< T... > >::from_string()'] │ │ │ │ │ ]], │ │ │ │ │ - ['from_5fstring_20tt_36', ['<tt>from_string</tt>', ['../datatypes.html#autotoc_md12', 1, '']]], │ │ │ │ │ + ['from_5fstring_20tt_36', ['<tt>from_string</tt>', ['../datatypes.html#autotoc_md10', 1, '']]], │ │ │ │ │ ['from_5fstring_3c_20std_3a_3anullptr_5ft_20_3e_37', ['from_string< std::nullptr_t >', ['../namespacepqxx.html#ac676a8d392370a92f0a2ef0f0bbf2043', 1, 'pqxx']]], │ │ │ │ │ ['from_5ftable_38', ['from_table', ['../namespacepqxx.html#a66648ed503eb162846c41247daa32660', 1, 'pqxx']]], │ │ │ │ │ ['from_5ftable_5ft_39', ['from_table_t', ['../namespacepqxx.html#structpqxx_1_1from__table__t', 1, 'pqxx']]], │ │ │ │ │ ['front_40', ['front', ['../classpqxx_1_1array.html#af0f6cbf8e3621dc46e59b9563ed436b1', 1, 'pqxx::array']]], │ │ │ │ │ ['functions_41', ['functions', ['../group__escaping-functions.html', 1, 'String-escaping functions'], │ │ │ │ │ - ['../escaping.html#autotoc_md5', 1, 'Using the esc functions'], │ │ │ │ │ + ['../escaping.html#autotoc_md17', 1, 'Using the esc functions'], │ │ │ │ │ ['../group__utility.html', 1, 'Utility functions'] │ │ │ │ │ ]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -3,47 +3,47 @@ │ │ │ │ │ ['icursorstream_5ficursor_5fiterator_1', ['icursorstream_icursor_iterator', ['../classpqxx_1_1internal_1_1gate_1_1icursorstream__icursor__iterator.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['id_2', ['id', ['../classpqxx_1_1largeobjectaccess.html#af210c3d0b39442a5ce9b3b1508d96c84', 1, 'pqxx::largeobjectaccess::id()'], │ │ │ │ │ ['../classpqxx_1_1largeobject.html#af210c3d0b39442a5ce9b3b1508d96c84', 1, 'pqxx::largeobject::id()'] │ │ │ │ │ ]], │ │ │ │ │ ['ignore_5funused_3', ['ignore_unused', ['../namespacepqxx.html#a9dd8124be2fccf97ece84ae958c175a0', 1, 'pqxx']]], │ │ │ │ │ ['in_5fdoubt_5ferror_4', ['in_doubt_error', ['../group__exception.html#structpqxx_1_1in__doubt__error', 1, 'pqxx']]], │ │ │ │ │ ['inclusive_5fbound_5', ['inclusive_bound', ['../classpqxx_1_1inclusive__bound.html', 1, 'pqxx']]], │ │ │ │ │ - ['injection_6', ['SQL injection', ['../escaping.html#autotoc_md4', 1, '']]], │ │ │ │ │ + ['injection_6', ['SQL injection', ['../escaping.html#autotoc_md16', 1, '']]], │ │ │ │ │ ['insert_7', ['insert', ['../classpqxx_1_1pipeline.html#a808f4fc39c77e490171d54a5554b337d', 1, 'pqxx::pipeline']]], │ │ │ │ │ ['inserted_5foid_8', ['inserted_oid', ['../classpqxx_1_1result.html#a5094a7be5f02f0f4c641fbd5ccb1a4da', 1, 'pqxx::result']]], │ │ │ │ │ ['insufficient_5fprivilege_9', ['insufficient_privilege', ['../group__exception.html#structpqxx_1_1insufficient__privilege', 1, 'pqxx']]], │ │ │ │ │ ['insufficient_5fresources_10', ['insufficient_resources', ['../group__exception.html#structpqxx_1_1insufficient__resources', 1, 'pqxx']]], │ │ │ │ │ ['integral_5ftraits_11', ['integral_traits', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20int_20_3e_12', ['integral_traits< int >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20long_20_3e_13', ['integral_traits< long >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20long_20long_20_3e_14', ['integral_traits< long long >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20short_20_3e_15', ['integral_traits< short >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20unsigned_20_3e_16', ['integral_traits< unsigned >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20unsigned_20long_20_3e_17', ['integral_traits< unsigned long >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20unsigned_20long_20long_20_3e_18', ['integral_traits< unsigned long long >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integral_5ftraits_3c_20unsigned_20short_20_3e_19', ['integral_traits< unsigned short >', ['../structpqxx_1_1internal_1_1integral__traits.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['integrity_5fconstraint_5fviolation_20', ['integrity_constraint_violation', ['../group__exception.html#structpqxx_1_1integrity__constraint__violation', 1, 'pqxx']]], │ │ │ │ │ - ['interlude_3a_20null_20values_21', ['Interlude: null values', ['../streams.html#autotoc_md25', 1, '']]], │ │ │ │ │ + ['interlude_3a_20null_20values_21', ['Interlude: null values', ['../streams.html#autotoc_md20', 1, '']]], │ │ │ │ │ ['internal_5ferror_22', ['internal_error', ['../group__exception.html#structpqxx_1_1internal__error', 1, 'pqxx']]], │ │ │ │ │ - ['into_20a_20table_20em_23', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md28', 1, '']]], │ │ │ │ │ + ['into_20a_20table_20em_23', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md23', 1, '']]], │ │ │ │ │ ['into_5fbuf_24', ['into_buf', ['../structpqxx_1_1string__traits.html#ad0fa1a3d75ba56a58c39822d25c14a0c', 1, 'pqxx::string_traits']]], │ │ │ │ │ - ['into_5fbuf_20tt_25', ['<tt>into_buf</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['into_5fbuf_20tt_25', ['<tt>into_buf</tt>', ['../datatypes.html#autotoc_md12', 1, '']]], │ │ │ │ │ ['invalid_5fcursor_5fname_26', ['invalid_cursor_name', ['../group__exception.html#structpqxx_1_1invalid__cursor__name', 1, 'pqxx']]], │ │ │ │ │ ['invalid_5fcursor_5fstate_27', ['invalid_cursor_state', ['../group__exception.html#structpqxx_1_1invalid__cursor__state', 1, 'pqxx']]], │ │ │ │ │ ['invalid_5fsql_5fstatement_5fname_28', ['invalid_sql_statement_name', ['../group__exception.html#structpqxx_1_1invalid__sql__statement__name', 1, 'pqxx']]], │ │ │ │ │ - ['is_20streaming_20right_20for_20my_20query_29', ['Is streaming right for my query?', ['../streams.html#autotoc_md27', 1, '']]], │ │ │ │ │ + ['is_20streaming_20right_20for_20my_20query_29', ['Is streaming right for my query?', ['../streams.html#autotoc_md22', 1, '']]], │ │ │ │ │ ['is_5fdigit_30', ['is_digit', ['../namespacepqxx_1_1internal.html#ace1c90d8dab0dafc4764c89ff09fa938', 1, 'pqxx::internal']]], │ │ │ │ │ ['is_5fexclusive_31', ['is_exclusive', ['../classpqxx_1_1range__bound.html#a5e36faad60586213187bbe1735f00c5b', 1, 'pqxx::range_bound']]], │ │ │ │ │ ['is_5ffinished_32', ['is_finished', ['../classpqxx_1_1pipeline.html#adb318eea9147fb82d67c43a430722283', 1, 'pqxx::pipeline']]], │ │ │ │ │ ['is_5finclusive_33', ['is_inclusive', ['../classpqxx_1_1range__bound.html#abe993384f178fe7ac1143e88a3dbcaeb', 1, 'pqxx::range_bound']]], │ │ │ │ │ ['is_5flimited_34', ['is_limited', ['../classpqxx_1_1range__bound.html#a62434321bfbc5f66bf3921ea2fb31274', 1, 'pqxx::range_bound']]], │ │ │ │ │ ['is_5fnull_35', ['is_null', ['../structpqxx_1_1no__null.html#ab53a311556c321a9dd10229b5b64773b', 1, 'pqxx::no_null::is_null()'], │ │ │ │ │ ['../structpqxx_1_1nullness.html#a309fcad467f815a9fbccbea0c2a6608a', 1, 'pqxx::nullness::is_null()'], │ │ │ │ │ ['../classpqxx_1_1field.html#ad3f84cc67637ba99b7128db75603d03c', 1, 'pqxx::field::is_null()'] │ │ │ │ │ ]], │ │ │ │ │ ['is_5fopen_36', ['is_open', ['../classpqxx_1_1connection.html#a1e401dd0dbd1be80176a691a864f652b', 1, 'pqxx::connection']]], │ │ │ │ │ - ['is_5funquoted_5fsafe_20tt_37', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md16', 1, '']]], │ │ │ │ │ + ['is_5funquoted_5fsafe_20tt_37', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ ['isolation_5flevel_38', ['isolation_level', ['../namespacepqxx.html#a8f05a60f9e1f7dc4e4af5dce6b987c8c', 1, 'pqxx']]], │ │ │ │ │ ['iter_39', ['iter', ['../classpqxx_1_1stream__from.html#acb595a8190351f2a8b594518351c40f3', 1, 'pqxx::stream_from::iter()'], │ │ │ │ │ ['../classpqxx_1_1result.html#afb672c73ca193aaf2fc5ba4d5c8a96f8', 1, 'pqxx::result::iter()'] │ │ │ │ │ ]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_b.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -6,9 +6,9 @@ │ │ │ │ │ ['m_5fresult_4', ['m_result', ['../classpqxx_1_1row.html#a83a21b69ee9c581fc449d24dc33d8e65', 1, 'pqxx::row']]], │ │ │ │ │ ['make_5fc_5fparams_5', ['make_c_params', ['../classpqxx_1_1params.html#a6ecf59a6ac483fe23e051ae654abc2b0', 1, 'pqxx::params']]], │ │ │ │ │ ['map_5fascii_5fsearch_5fgroup_6', ['map_ascii_search_group', ['../namespacepqxx_1_1internal.html#ae26a85861af19d77bcc12ae448531d32', 1, 'pqxx::internal']]], │ │ │ │ │ ['max_5fparams_7', ['max_params', ['../classpqxx_1_1placeholders.html#a066068da0d7ca3d0b38ee47ce0098843', 1, 'pqxx::placeholders']]], │ │ │ │ │ ['member_5fargs_5ff_8', ['member_args_f', ['../namespacepqxx_1_1internal.html#a70ec299b53c60d248d0766cc11faacf1', 1, 'pqxx::internal']]], │ │ │ │ │ ['metadata_9', ['Results with metadata', ['../accessing-results.html#autotoc_md2', 1, '']]], │ │ │ │ │ ['multiple_20parameters_10', ['Multiple parameters', ['../parameters.html#autotoc_md18', 1, '']]], │ │ │ │ │ - ['my_20query_11', ['Is streaming right for my query?', ['../streams.html#autotoc_md27', 1, '']]] │ │ │ │ │ + ['my_20query_11', ['Is streaming right for my query?', ['../streams.html#autotoc_md22', 1, '']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -2,15 +2,15 @@ │ │ │ │ │ ['name_0', ['name', ['../classpqxx_1_1cursor__base.html#a580405381178880d7804180c0c396fe5', 1, 'pqxx::cursor_base::name()'], │ │ │ │ │ ['../classpqxx_1_1stateless__cursor.html#a0be6e4435c96296ab1f91f4769235dae', 1, 'pqxx::stateless_cursor::name()'], │ │ │ │ │ ['../classpqxx_1_1field.html#accb1b29590adaf1c265279fc410b2e59', 1, 'pqxx::field::name()'], │ │ │ │ │ ['../group__transactions.html#ae59455e1e8da50f0cb5901c1f72ff66e', 1, 'pqxx::transaction_base::name()'], │ │ │ │ │ ['../classpqxx_1_1transaction__focus.html#a4ccffff2688e9e7757acc385be1d781c', 1, 'pqxx::transaction_focus::name()'] │ │ │ │ │ ]], │ │ │ │ │ ['name_5fencoding_1', ['name_encoding', ['../namespacepqxx_1_1internal.html#a51e0c4e1a45c85a3b625dc3d764684f5', 1, 'pqxx::internal']]], │ │ │ │ │ - ['new_20type_2', ['Supporting a new type', ['../datatypes.html#autotoc_md7', 1, '']]], │ │ │ │ │ + ['new_20type_2', ['Supporting a new type', ['../datatypes.html#autotoc_md5', 1, '']]], │ │ │ │ │ ['next_3', ['next', ['../classpqxx_1_1cursor__base.html#a8084649c4f6be54a3c688908c1b9edf9', 1, 'pqxx::cursor_base::next()'], │ │ │ │ │ ['../classpqxx_1_1placeholders.html#aef09cd2fcb858917f33752a85e063bde', 1, 'pqxx::placeholders::next()'] │ │ │ │ │ ]], │ │ │ │ │ ['no_5fbound_4', ['no_bound', ['../structpqxx_1_1no__bound.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_5', ['no_null', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20binarystring_20_3e_6', ['no_null< binarystring >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20bytes_20_3e_7', ['no_null< bytes >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ @@ -22,37 +22,37 @@ │ │ │ │ │ ['no_5fnull_3c_20std_3a_3astring_20_3e_13', ['no_null< std::string >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20std_3a_3astring_5fview_20_3e_14', ['no_null< std::string_view >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20std_3a_3astringstream_20_3e_15', ['no_null< std::stringstream >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20std_3a_3avector_3c_20t_20_3e_20_3e_16', ['no_null< std::vector< T > >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20t_20_3e_17', ['no_null< T >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5fnull_3c_20zview_20_3e_18', ['no_null< zview >', ['../structpqxx_1_1no__null.html', 1, 'pqxx']]], │ │ │ │ │ ['no_5frows_19', ['no_rows', ['../classpqxx_1_1result.html#aee29dae44071175c8c6dd4a046a060c5', 1, 'pqxx::result']]], │ │ │ │ │ - ['nontransaction_20', ['nontransaction', ['../group__transactions.html#classpqxx_1_1nontransaction', 1, 'pqxx::nontransaction'], │ │ │ │ │ - ['../group__transactions.html#ab9cf41ee092dff1c6f1e07df23ba0cfd', 1, 'pqxx::nontransaction::nontransaction()'] │ │ │ │ │ + ['nontransaction_20', ['nontransaction', ['../group__transactions.html#ab9cf41ee092dff1c6f1e07df23ba0cfd', 1, 'pqxx::nontransaction::nontransaction()'], │ │ │ │ │ + ['../group__transactions.html#classpqxx_1_1nontransaction', 1, 'pqxx::nontransaction'] │ │ │ │ │ ]], │ │ │ │ │ ['not_5feof_21', ['not_eof', ['../structpqxx_1_1byte__char__traits.html#a7c89d44e821a11f8336b70dc7891d7ac', 1, 'pqxx::byte_char_traits']]], │ │ │ │ │ ['not_5fnull_5fviolation_22', ['not_null_violation', ['../group__exception.html#structpqxx_1_1not__null__violation', 1, 'pqxx']]], │ │ │ │ │ - ['note_23', ['Performance note', ['../prepared.html#autotoc_md23', 1, '']]], │ │ │ │ │ + ['note_23', ['Performance note', ['../prepared.html#autotoc_md31', 1, '']]], │ │ │ │ │ ['nothing_24', ['nothing', ['../namespacepqxx.html#adabe80e8385e85d663acc6e44332070da867e5843857acbeb150fcaf025825a6f', 1, 'pqxx']]], │ │ │ │ │ ['notice_5fwaiters_25', ['notice_waiters', ['../structpqxx_1_1internal_1_1notice__waiters.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['notification_26', ['notification', ['../namespacepqxx.html#structpqxx_1_1notification', 1, 'pqxx']]], │ │ │ │ │ ['notification_5fhandler_27', ['notification_handler', ['../classpqxx_1_1connection.html#a5c68dd44c2a9e64eb2022623659ebc09', 1, 'pqxx::connection']]], │ │ │ │ │ - ['notification_5freceiver_28', ['notification_receiver', ['../classpqxx_1_1notification__receiver.html#a44ffe1ed8ec8020f4106ef8427e09d17', 1, 'pqxx::notification_receiver::notification_receiver(notification_receiver const &)=delete'], │ │ │ │ │ - ['../classpqxx_1_1notification__receiver.html#a4779f6b712bf7a1d5ab3253b8d274db9', 1, 'pqxx::notification_receiver::notification_receiver(connection &cx, std::string_view channel)'], │ │ │ │ │ - ['../classpqxx_1_1notification__receiver.html', 1, 'pqxx::notification_receiver'] │ │ │ │ │ + ['notification_5freceiver_28', ['notification_receiver', ['../classpqxx_1_1notification__receiver.html#a4779f6b712bf7a1d5ab3253b8d274db9', 1, 'pqxx::notification_receiver::notification_receiver()'], │ │ │ │ │ + ['../classpqxx_1_1notification__receiver.html', 1, 'pqxx::notification_receiver'], │ │ │ │ │ + ['../classpqxx_1_1notification__receiver.html#a44ffe1ed8ec8020f4106ef8427e09d17', 1, 'pqxx::notification_receiver::notification_receiver()'] │ │ │ │ │ ]], │ │ │ │ │ ['notifications_20and_20receivers_29', ['Notifications and Receivers', ['../group__notification.html', 1, '']]], │ │ │ │ │ ['notify_30', ['notify', ['../group__transactions.html#aff9f3e6d1e0479d8c6774db391bf9b8a', 1, 'pqxx::transaction_base']]], │ │ │ │ │ ['null_31', ['null', ['../structpqxx_1_1nullness.html#a475f5e490aabd4934aa63a621ecfd0ab', 1, 'pqxx::nullness::null()'], │ │ │ │ │ ['../structpqxx_1_1nullness_3_01std_1_1variant_3_01T_8_8_8_01_4_01_4.html#a62b23c197cb393e146d9720ed4aed004', 1, 'pqxx::nullness< std::variant< T... > >::null()'] │ │ │ │ │ ]], │ │ │ │ │ - ['null_20values_32', ['Interlude: null values', ['../streams.html#autotoc_md25', 1, '']]], │ │ │ │ │ + ['null_20values_32', ['Interlude: null values', ['../streams.html#autotoc_md20', 1, '']]], │ │ │ │ │ ['null_5fvalue_33', ['null_value', ['../classpqxx_1_1array__parser.html#a039577d83d313a6daf35fd7c273e189ea9e374dadbd88854fd5b2631a6b83a295', 1, 'pqxx::array_parser']]], │ │ │ │ │ ['nullness_34', ['nullness', ['../structpqxx_1_1nullness.html', 1, 'pqxx']]], │ │ │ │ │ - ['nullness_20tt_35', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md10', 1, '']]], │ │ │ │ │ + ['nullness_20tt_35', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md8', 1, '']]], │ │ │ │ │ ['nullness_3c_20binarystring_20_3e_36', ['nullness< binarystring >', ['../structpqxx_1_1nullness_3_01binarystring_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20bytes_20_3e_37', ['nullness< bytes >', ['../structpqxx_1_1nullness_3_01bytes_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20bytes_5fview_20_3e_38', ['nullness< bytes_view >', ['../structpqxx_1_1nullness_3_01bytes__view_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20char_20_2a_20_3e_39', ['nullness< char * >', ['../structpqxx_1_1nullness_3_01char_01_5_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20char_20const_20_2a_20_3e_40', ['nullness< char const * >', ['../structpqxx_1_1nullness_3_01char_01const_01_5_01_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20char_5bn_5d_3e_41', ['nullness< char[N]>', ['../structpqxx_1_1nullness_3_01char_0fN_0e_4.html', 1, 'pqxx']]], │ │ │ │ │ ['nullness_3c_20enum_2c_20std_3a_3aenable_5fif_5ft_3c_20std_3a_3ais_5fenum_5fv_3c_20enum_20_3e_20_3e_20_3e_42', ['nullness< ENUM, std::enable_if_t< std::is_enum_v< ENUM > > >', ['../structpqxx_1_1nullness_3_01ENUM_00_01std_1_1enable__if__t_3_01std_1_1is__enum__v_3_01ENUM_01_4_01_4_01_4.html', 1, 'pqxx']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_d.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -74,13 +74,13 @@ │ │ │ │ │ ['../classpqxx_1_1stream__from.html#a0ea468c0d02f2a2c9c2c7ff41dbece3c', 1, 'pqxx::stream_from::operator>>(std::variant< Vs... > &)=delete'] │ │ │ │ │ ]], │ │ │ │ │ ['operator_5b_5d_28', ['operator[]', ['../classpqxx_1_1result.html#a501bfb79335ea4c51bc55f9c0aa6c75f', 1, 'pqxx::result::operator[]()'], │ │ │ │ │ ['../classpqxx_1_1row.html#aee26781d8c0000bdc1d80c1624b17c81', 1, 'pqxx::row::operator[]()'], │ │ │ │ │ ['../classpqxx_1_1array.html#a36d27b1f7e366a07944115a382aa4087', 1, 'pqxx::array::operator[]()'] │ │ │ │ │ ]], │ │ │ │ │ ['opt_5frow_29', ['opt_row', ['../classpqxx_1_1result.html#a5d0d4d8714ea814f1d80d11578976098', 1, 'pqxx::result']]], │ │ │ │ │ - ['optional_3a_20specialise_20tt_20is_5funquoted_5fsafe_20tt_30', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md16', 1, '']]], │ │ │ │ │ - ['optional_3a_20specialise_20tt_20param_5fformat_20tt_31', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md17', 1, '']]], │ │ │ │ │ + ['optional_3a_20specialise_20tt_20is_5funquoted_5fsafe_20tt_30', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['optional_3a_20specialise_20tt_20param_5fformat_20tt_31', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ ['out_5fof_5fmemory_32', ['out_of_memory', ['../group__exception.html#structpqxx_1_1out__of__memory', 1, 'pqxx']]], │ │ │ │ │ ['owned_33', ['owned', ['../classpqxx_1_1cursor__base.html#ac06b19ea7f07f4e251560f49bee2e490a3ace6a7a5ca4ec3b486f2f35fd2420b0', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['ownership_5fpolicy_34', ['ownership_policy', ['../classpqxx_1_1cursor__base.html#ac06b19ea7f07f4e251560f49bee2e490', 1, 'pqxx::cursor_base']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_e.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,16 +1,16 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ ['param_5fformat_0', ['param_format', ['../namespacepqxx.html#a9a3f3a97fd46497a008aaca323cc1958', 1, 'pqxx::param_format(std::vector< T, Args... > const &)'], │ │ │ │ │ ['../namespacepqxx.html#a194db2bb59425a2ff10187d2e81189d3', 1, 'pqxx::param_format(std::vector< std::byte, Args... > const &)'], │ │ │ │ │ ['../namespacepqxx.html#a5a183a730292cabcf9e64fdc6eb0faa5', 1, 'pqxx::param_format(std::array< T, args... > const &)'], │ │ │ │ │ ['../namespacepqxx.html#a0eaf71a6f4744e3d401d2f179d477e4a', 1, 'pqxx::param_format(std::array< std::byte, args... > const &)'] │ │ │ │ │ ]], │ │ │ │ │ - ['param_5fformat_20tt_1', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md17', 1, '']]], │ │ │ │ │ + ['param_5fformat_20tt_1', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md15', 1, '']]], │ │ │ │ │ ['parameters_2', ['parameters', ['../parameters.html#autotoc_md18', 1, 'Multiple parameters'], │ │ │ │ │ - ['../prepared.html#autotoc_md21', 1, 'Parameters'], │ │ │ │ │ + ['../prepared.html#autotoc_md29', 1, 'Parameters'], │ │ │ │ │ ['../parameters.html', 1, 'Statement parameters'] │ │ │ │ │ ]], │ │ │ │ │ ['params_3', ['params', ['../classpqxx_1_1params.html', 1, 'pqxx::params'], │ │ │ │ │ ['../classpqxx_1_1params.html#ad15fdabb428bc93cdb0a6c4354a9069c', 1, 'pqxx::params::params()'] │ │ │ │ │ ]], │ │ │ │ │ ['parse_5fcomposite_4', ['parse_composite', ['../namespacepqxx.html#a0cd702e0c9b6172bf07f0253b238506b', 1, 'pqxx::parse_composite(std::string_view text, T &...fields)'], │ │ │ │ │ ['../namespacepqxx.html#ac634686eb086118eade113cd71c7d5a4', 1, 'pqxx::parse_composite(pqxx::internal::encoding_group enc, std::string_view text, T &...fields)'] │ │ │ │ │ @@ -18,15 +18,15 @@ │ │ │ │ │ ['parse_5fcomposite_5ffield_5', ['parse_composite_field', ['../namespacepqxx_1_1internal.html#a1689cd1502106403a998bd0b2a283432', 1, 'pqxx::internal']]], │ │ │ │ │ ['parse_5fdouble_5fquoted_5fstring_6', ['parse_double_quoted_string', ['../namespacepqxx_1_1internal.html#ad24fb98e5aa3beaecd91d4631321fd4d', 1, 'pqxx::internal']]], │ │ │ │ │ ['parse_5fline_7', ['parse_line', ['../classpqxx_1_1internal_1_1stream__query.html#aad5061fd7b06c89a98e317ce6901ab58', 1, 'pqxx::internal::stream_query']]], │ │ │ │ │ ['parse_5funquoted_5fstring_8', ['parse_unquoted_string', ['../namespacepqxx_1_1internal.html#a93188da7c79d025bae155202f2facb18', 1, 'pqxx::internal']]], │ │ │ │ │ ['payload_9', ['payload', ['../namespacepqxx.html#af4420ee3d9ce36513a5b026903d4b191', 1, 'pqxx::notification']]], │ │ │ │ │ ['perform_10', ['perform', ['../namespacepqxx.html#a9c2faadd143f7c48353eb23b2aa24134', 1, 'pqxx']]], │ │ │ │ │ ['performance_20features_11', ['Performance features', ['../performance.html', 1, '']]], │ │ │ │ │ - ['performance_20note_12', ['Performance note', ['../prepared.html#autotoc_md23', 1, '']]], │ │ │ │ │ + ['performance_20note_12', ['Performance note', ['../prepared.html#autotoc_md31', 1, '']]], │ │ │ │ │ ['pipeline_13', ['pipeline', ['../classpqxx_1_1pipeline.html', 1, 'pqxx::pipeline'], │ │ │ │ │ ['../classpqxx_1_1pipeline.html#a0c80a5e68052b2c35089e384e3c842ce', 1, 'pqxx::pipeline::pipeline(transaction_base &t)'], │ │ │ │ │ ['../classpqxx_1_1pipeline.html#a92463b4b599f681a372016d5dbbe016d', 1, 'pqxx::pipeline::pipeline(transaction_base &t, std::string_view tname)'] │ │ │ │ │ ]], │ │ │ │ │ ['placeholders_14', ['placeholders', ['../parameters.html#autotoc_md19', 1, 'Generating placeholders'], │ │ │ │ │ ['../classpqxx_1_1placeholders.html', 1, 'pqxx::placeholders< COUNTER >'] │ │ │ │ │ ]], │ │ │ │ │ @@ -41,17 +41,17 @@ │ │ │ │ │ ['pqxx_3a_3ainternal_23', ['internal', ['../namespacepqxx_1_1internal.html', 1, 'pqxx']]], │ │ │ │ │ ['pqxx_3a_3ainternal_3a_3apq_24', ['pq', ['../namespacepqxx_1_1internal_1_1pq.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['pqxx_3a_3aprepare_25', ['prepare', ['../namespacepqxx_1_1prepare.html', 1, 'pqxx']]], │ │ │ │ │ ['prepare_26', ['prepare', ['../classpqxx_1_1connection.html#ac6888103e47fc344e18d17878cdc2bc7', 1, 'pqxx::connection::prepare(char const name[], char const definition[]) &'], │ │ │ │ │ ['../classpqxx_1_1connection.html#a140337eada7fe60e15d8b113b8599f0d', 1, 'pqxx::connection::prepare(char const definition[]) &'], │ │ │ │ │ ['../classpqxx_1_1connection.html#add8ab06057cfd57e509c1e4e1f26e944', 1, 'pqxx::connection::prepare(zview name, zview definition) &'] │ │ │ │ │ ]], │ │ │ │ │ - ['prepared_20statement_27', ['A special prepared statement', ['../prepared.html#autotoc_md22', 1, '']]], │ │ │ │ │ + ['prepared_20statement_27', ['A special prepared statement', ['../prepared.html#autotoc_md30', 1, '']]], │ │ │ │ │ ['prepared_20statements_28', ['Prepared statements', ['../prepared.html', 1, '']]], │ │ │ │ │ - ['preparing_20a_20statement_29', ['Preparing a statement', ['../prepared.html#autotoc_md20', 1, '']]], │ │ │ │ │ + ['preparing_20a_20statement_29', ['Preparing a statement', ['../prepared.html#autotoc_md28', 1, '']]], │ │ │ │ │ ['prepped_30', ['prepped', ['../classpqxx_1_1prepped.html', 1, 'pqxx']]], │ │ │ │ │ ['prior_31', ['prior', ['../classpqxx_1_1cursor__base.html#a94899901ead639033a816cb4aa0fdcd4', 1, 'pqxx::cursor_base']]], │ │ │ │ │ ['process_32', ['process', ['../classpqxx_1_1connecting.html#a58084f41892e19eb2a603a95de4f7dd9', 1, 'pqxx::connecting']]], │ │ │ │ │ ['process_5fnotice_33', ['process_notice', ['../group__transactions.html#a319425c4f02975fa2d5807963ba3dc08', 1, 'pqxx::transaction_base::process_notice(zview msg) const'], │ │ │ │ │ ['../group__transactions.html#afecae4ed72e50dd2a14fbc9c7d365297', 1, 'pqxx::transaction_base::process_notice(char const msg[]) const'], │ │ │ │ │ ['../classpqxx_1_1largeobject__streambuf.html#a9c9d53a14e148dec15f632fcb8f51366', 1, 'pqxx::largeobject_streambuf::process_notice()'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#ad539bb1d48ea71532455f56bf118a3ff', 1, 'pqxx::largeobjectaccess::process_notice()'], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_f.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,17 +1,17 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['query_0', ['query', ['../streams.html#autotoc_md27', 1, 'Is streaming right for my query?'], │ │ │ │ │ + ['query_0', ['query', ['../streams.html#autotoc_md22', 1, 'Is streaming right for my query?'], │ │ │ │ │ ['../group__exception.html#af011efdf2ba4459774e1e146a50c398d', 1, 'pqxx::sql_error::query()'], │ │ │ │ │ ['../group__transactions.html#a41080a9f7c8cbf27a888c3cbf3e9c974', 1, 'pqxx::transaction_base::query(prepped statement, params const &parms={})'], │ │ │ │ │ ['../group__transactions.html#ad765133f6133ea8de8255af804e8f81b', 1, 'pqxx::transaction_base::query(zview query, params const &parms)'], │ │ │ │ │ ['../classpqxx_1_1stream__from.html#a062c20b73f6c9d019bfc35806c432ec0', 1, 'pqxx::stream_from::query()'], │ │ │ │ │ ['../classpqxx_1_1result.html#a9d28f84628b9e8a8fecf7849f31bf1a0', 1, 'pqxx::result::query()'], │ │ │ │ │ ['../group__transactions.html#a2b8b6bcc152f542e8cbe8e227db2ef62', 1, 'pqxx::transaction_base::query()'] │ │ │ │ │ ]], │ │ │ │ │ - ['query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md26', 1, '']]], │ │ │ │ │ + ['query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md21', 1, '']]], │ │ │ │ │ ['query01_2', ['query01', ['../group__transactions.html#aa5929c0f9068f6569c246063a6428c99', 1, 'pqxx::transaction_base::query01(zview query)'], │ │ │ │ │ ['../group__transactions.html#a40ddd8e96d1dbd58b8e1355d24de5898', 1, 'pqxx::transaction_base::query01(zview query, params const &parms)'] │ │ │ │ │ ]], │ │ │ │ │ ['query1_3', ['query1', ['../group__transactions.html#ad2e069e118bd8b5332e37fecf6648020', 1, 'pqxx::transaction_base::query1(zview query)'], │ │ │ │ │ ['../group__transactions.html#a551bbeaed97a9c3797257dc127e2c3ab', 1, 'pqxx::transaction_base::query1(zview query, params const &parms)'] │ │ │ │ │ ]], │ │ │ │ │ ['query_5fid_4', ['query_id', ['../classpqxx_1_1pipeline.html#af21cf61fd1c13a6729f48a241cbeba37', 1, 'pqxx::pipeline']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/streams.html │ │ │ │ @@ -92,48 +92,48 @@ │ │ │ │
│ │ │ │
Streams
│ │ │ │
│ │ │ │
│ │ │ │

Most of the time it's fine to retrieve data from the database using SELECT queries, and store data using INSERT. But for those cases where efficiency matters, there are two data streaming mechanisms to help you do this more efficiently: "streaming queries," for reading query results from the database; and the pqxx::stream_to class, for writing data from the client into a table.

│ │ │ │

These are less flexible than SQL queries. Also, depending on your needs, it may be a problem to lose your connection while you're in mid-stream, not knowing that the query may not complete. But, you get some scalability and memory efficiencies in return.

│ │ │ │

Just like regular querying, these streaming mechanisms do data conversion for you. You deal with the C++ data types, and the database deals with the SQL data types.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Interlude: null values

│ │ │ │

So how do you deal with nulls? It depends on the C++ type you're using. Some types may have a built-in null value. For instance, if you have a char const * value and you convert it to an SQL string, then converting a nullptr will produce a NULL SQL value.

│ │ │ │

But what do you do about C++ types which don't have a built-in null value, such as int? The trick is to wrap it in std::optional. The difference between int and std::optional<int> is that the former always has an int value, and the latter doesn't have to.

│ │ │ │

Actually it's not just std::optional. You can do the same thing with std::unique_ptr or std::shared_ptr. A smart pointer is less efficient than std::optional in most situations because they allocate their value on the heap, but sometimes that's what you want in order to save moving or copying large values around.

│ │ │ │

This part is not generic though. It won't work with just any smart-pointer type, just the ones which are explicitly supported: shared_ptr and unique_ptr. If you really need to, you can build support for additional wrappers and smart pointers by copying the implementation patterns from the existing smart-pointer support.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Streaming data <em>from a query</em>

│ │ │ │

Use transaction_base::stream to read large amounts of data directly from the database. In terms of API it works just like transaction_base::query, but it's faster than the exec and query functions For larger data sets. Also, you won't need to keep your full result set in memory. That can really matter with larger data sets.

│ │ │ │

Another performance advantage is that with a streaming query, you can start processing your data right after the first row of data comes in from the server. With exec() or query() you need to wait to receive all data, and only then can you begin processing. With streaming queries you can be processing data on the client side while the server is still sending you the rest.

│ │ │ │

Not all kinds of queries will work in a stream. Internally the streams make use of PostgreSQL's COPY command, so see the PostgreSQL documentation for COPY for the exact limitations. Basic SELECT and UPDATE ... RETURNING queries will just work, but fancier constructs may not.

│ │ │ │

As you read a row, the stream converts its fields to a tuple type containing the value types you ask for:

│ │ │ │
for (auto [name, score] :
│ │ │ │
tx.stream<std::string_view, int>("SELECT name, points FROM score")
│ │ │ │
)
│ │ │ │
process(name, score);
│ │ │ │

On each iteration, the stream gives you a std::tuple of the column types you specify. It converts the row's fields (which internally arrive at the client in text format) to your chosen types.

│ │ │ │

The auto [name, score] in the example is a structured binding which unpacks the tuple's fields into separate variables. If you prefer, you can choose to receive the tuple instead: for (std::tuple<int, std::string_view> :.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Is streaming right for my query?

│ │ │ │

Here are the things you need to be aware of when deciding whether to stream a query, or just execute it normally.

│ │ │ │

First, when you stream a query, there is no metadata describing how many rows it returned, what the columns are called, and so on. With a regular query you get a result object which contains this metadata as well as the data itself. If you absolutely need this metadata for a particular query, then that means you can't stream the query.

│ │ │ │

Second, under the bonnet, streaming from a query uses a PostgreSQL-specific SQL command COPY (...) TO STDOUT. There are some limitations on what kinds of queries this command can handle. These limitations may change over time, so I won't describe them here. Instead, see PostgreSQL's COPY documentation for the details. (Look for the TO variant, with a query as the data source.)

│ │ │ │

Third: when you stream a query, you start receiving and processing data before you even know whether you will receive all of the data. If you lose your connection to the database halfway through, you will have processed half your data, unaware that the query may never execute to completion. If this is a problem for your application, don't stream that query!

│ │ │ │

The fourth and final factor is performance. If you're interested in streaming, obviously you care about this one.

│ │ │ │

I can't tell you a priori whether streaming will make your query faster. It depends on how many rows you're retrieving, how much data there is in those rows, the speed of your network connection to the database, your client encoding, how much processing you do per row, and the details of the client-side system: hardware speed, CPU load, and available memory.

│ │ │ │

Ultimately, no amount of theory beats real-world measurement for your specific situation so... if it really matters, measure. (And as per Knuth's Law: if it doesn't really matter, don't optimise.)

│ │ │ │

That said, here are a few data points from some toy benchmarks:

│ │ │ │

If your query returns e.g. a hundred small rows, it's not likely to make up a significant portion of your application's run time. Streaming is likely to be slower than regular querying, but most likely the difference just won't amtter.

│ │ │ │

If your query returns a thousand small rows, streaming is probably still going to be a bit slower than regular querying, though "your mileage may vary."

│ │ │ │

If you're querying ten thousand small rows, however, it becomes more likely that streaming will speed it up. The advantage increases as the number of rows increases.

│ │ │ │

That's for small rows, based on a test where each row consisted of just one integer number. If your query returns larger rows, with more columns, I find that streaming seems to become more attractive. In a simple test with 4 columns (two integers and two strings), streaming even just a thousand rows was considerably faster than a regular query.

│ │ │ │

If your network connection to the database is slow, however, that may make streaming a bit less effcient. There is a bit more communication back and forth between the client and the database to set up a stream. This overhead takes a more or less constant amount of time, so for larger data sets it will tend to become insignificant compared to the other performance costs.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Streaming data <em>into a table</em>

│ │ │ │

Use stream_to to write data directly to a database table. This saves you having to perform an INSERT for every row, and so it can be significantly faster if you want to insert more than just one or two rows at a time.

│ │ │ │

As with stream_from, you can specify the table and the columns, and not much else. You insert tuple-like objects of your choice:

│ │ │ │
pqxx::stream_to stream{
│ │ │ │
tx,
│ │ │ │
"score",
│ │ │ │
std::vector<std::string>{"name", "points"}};