--- /srv/reproducible-results/rbuild-debian/r-b-build.uVB4keKe/b1/libpqxx_7.10.0-2_i386.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.uVB4keKe/b2/libpqxx_7.10.0-2_i386.changes ├── Files │ @@ -1,5 +1,5 @@ │ │ a8771feb18135ae69f9622fe038f47bb 2500384 debug optional libpqxx-7.10-dbgsym_7.10.0-2_i386.deb │ 0df1e475cd1bd16429382fc791162892 212944 libs optional libpqxx-7.10_7.10.0-2_i386.deb │ 560470298a4378f004cdc2f186dfbf9f 387848 libdevel optional libpqxx-dev_7.10.0-2_i386.deb │ - dfcf3211fc4c6e5aa6ecf4d99b977eaa 2639304 doc optional libpqxx-doc_7.10.0-2_all.deb │ + 5c9473986d068c3ec9ec7d2a2c6066a7 2637400 doc optional libpqxx-doc_7.10.0-2_all.deb ├── libpqxx-doc_7.10.0-2_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2025-01-23 16:15:05.000000 debian-binary │ │ --rw-r--r-- 0 0 0 32408 2025-01-23 16:15:05.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 2606704 2025-01-23 16:15:05.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 32436 2025-01-23 16:15:05.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 2604772 2025-01-23 16:15:05.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: libpqxx-doc │ │ │ │ Source: libpqxx │ │ │ │ Version: 7.10.0-2 │ │ │ │ Architecture: all │ │ │ │ Maintainer: Debian PostgreSQL team │ │ │ │ -Installed-Size: 13597 │ │ │ │ +Installed-Size: 13547 │ │ │ │ Suggests: libpqxx-dev (>= 7.10.0-2) │ │ │ │ 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 │ │ │ │ @@ -2,15 +2,15 @@ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/share/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/share/doc/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1322 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/changelog.Debian.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2807 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/copyright │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 18206 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/accessing-results.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 18203 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/accessing-results.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 81499 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/annotated.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 22300 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/annotated_dup.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 63073 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/array-composite_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 87535 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/array_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 674 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/bc_s.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 634 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/bc_sd.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8304 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/binary.html │ │ │ │ @@ -57,22 +57,22 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 7476 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 16227 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 678 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connecting.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 28289 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 125398 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5809 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1connection.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 29774 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 75445 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 62524 2025-01-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 37137 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__reverse__result__iterator.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 31662 2025-01-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range-members.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 22538 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 643 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 10254 2025-01-23 16:15:05.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-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range__bound.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 618 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1range__bound.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 21619 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 73620 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 62809 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2802 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1result.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19721 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row-members.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 60407 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 51358 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1893 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1row.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 421 2025-01-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.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-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1sql__error__coll__graph.png │ │ │ │ @@ -829,71 +829,71 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 168 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/nav_fd.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 95 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/nav_g.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 98 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/nav_h.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 111 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/nav_hd.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2167 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtree.css │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15935 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtree.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5968 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreedata.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 19107 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex0.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 19104 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex0.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 21285 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex1.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19510 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex2.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15193 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex3.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 17784 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex4.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 18016 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex5.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 18019 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex5.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2477 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/navtreeindex6.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 13256 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/nontransaction_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 16353 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/notification_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 122 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/open.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6420 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/pages.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12962 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/parameters.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 52695 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/params_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5810 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/performance.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 29855 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/pipeline_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 696 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/plus.svg │ │ │ │ -rw-r--r-- 0 root (0) root (0) 696 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/plusd.svg │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8893 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/pqxx-source_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 14802 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/prepared.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 14801 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/prepared.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9364 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/prepared__statement_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 101844 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/range_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5685 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/resize.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8660 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-connection_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11425 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-creation_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8756 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-pipeline_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 8591 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result-sql__cursor_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 67049 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 31512 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iter_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 65381 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iterator_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 63743 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 29407 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iter_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 62185 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/result__iterator_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19467 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/robusttransaction_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 98297 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/row_8hxx_source.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 91997 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/row_8hxx_source.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 7543 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_0.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 7545 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_0.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4729 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_1.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 6980 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_10.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 21618 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 7536 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 6978 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_10.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 21620 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 7537 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2857 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_13.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 905 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_14.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1395 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_15.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 906 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_14.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1394 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_15.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 95 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_16.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1207 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_17.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 319 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_18.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15545 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_2.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 4602 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_3.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 9407 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_4.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 7169 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_5.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 4603 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_3.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 9409 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_4.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 7171 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_5.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5454 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_6.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1038 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_7.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 5818 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 5821 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 147 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_9.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2895 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_a.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1393 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_b.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 9602 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 9163 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_d.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 6429 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_e.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 4651 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_f.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 9603 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 9162 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_d.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 6428 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_e.js │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 4663 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_f.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 875 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_0.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1086 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_1.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 975 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_10.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 835 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_11.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 157 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_12.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 85 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_13.js │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3820 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/search/classes_2.js │ │ │ │ @@ -1014,15 +1014,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 22632 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/statement__parameters_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 69161 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/strconv_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 55559 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/stream__from_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 22603 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/stream__iterator_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 49763 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/stream__query_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 48948 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/stream__query__impl_8hxx_source.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 57527 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/stream__to_8hxx_source.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 14467 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/streams.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 14471 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/streams.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 389 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1argument__error__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4983 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1argument__error__coll__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 389 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1argument__error__inherit__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4983 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1argument__error__inherit__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 697 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1broken__connection__coll__graph.map │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6235 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1broken__connection__coll__graph.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1267 2025-01-23 16:15:05.000000 ./usr/share/doc/libpqxx-doc/doxygen-html/structpqxx_1_1broken__connection__inherit__graph.map │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/accessing-results.html │ │ │ │ @@ -93,38 +93,38 @@ │ │ │ │
Accessing results and result rows
│ │ │ │ │ │ │ │
│ │ │ │

A query produces a result set consisting of rows, and each row consists of fields. There are several ways to receive this data.

│ │ │ │

The fields are "untyped." That is to say, libpqxx has no opinion on what their types are. The database sends the data in a very flexible textual format. When you read a field, you specify what type you want it to be, and libpqxx converts the text format to that type for you.

│ │ │ │

If a value does not conform to the format for the type you specify, the conversion fails. For example, if you have strings that all happen to contain numbers, you can read them as int. But if any of the values is empty, or it's null (for a type that doesn't support null), or it's some string that does not look like an integer, or it's too large, you can't convert it to int.

│ │ │ │

So usually, reading result data from the database means not just retrieving the data; it also means converting it to some target type.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Querying rows of data

│ │ │ │

The simplest way to query rows of data is to call one of a transaction's "query" functions, passing as template arguments the types of columns you want to get back (e.g. int, std::string, double, and so on) and as a regular argument the query itself.

│ │ │ │

You can then iterate over the result to go over the rows of data:

│ │ │ │
for (auto [id, value] :
│ │ │ │
tx.query<int, std::string>("SELECT id, name FROM item"))
│ │ │ │
{
│ │ │ │
std::cout << id << '\t' << value << '\n';
│ │ │ │
}
│ │ │ │

The "query" functions execute your query, load the complete result data from the database, and then as you iterate, convert each row it received to a tuple of C++ types that you indicated.

│ │ │ │

There are different query functions for querying any number of rows (query()); querying just one row of data as a std::tuple and throwing an error if there's more than one row (query1()); or querying

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Streaming rows

│ │ │ │

There's another way to go through the rows coming out of a query. It's usually easier and faster if there are a lot of rows, but there are drawbacks.

│ │ │ │

One, you start getting rows before all the data has come in from the database. That speeds things up, but what happens if you lose your network connection while transferring the data? Your application may already have processed some of the data before finding out that the rest isn't coming. If that is a problem for your application, streaming may not be the right choice.

│ │ │ │

Two, streaming only works for some types of query. The stream() function wraps your query in a PostgreSQL COPY command, and COPY only supports a few commands: SELECT, VALUES, or an INSERT, UPDATE, or DELETE with a RETURNING clause. See the COPY documentation here: [ https://www.postgresql.org/docs/current/sql-copy.html ](https://www.postgresql.org/docs/current/sql-copy.html).

│ │ │ │

Three, when you convert a field to a "view" type (such as std::string_view or pqxx::bytes_view), the view points to underlying data which only stays valid until you iterate to the next row or exit the loop. So if you want to use that data for longer than a single iteration of the streaming loop, you'll have to store it somewhere yourself.

│ │ │ │

Now for the good news. Streaming does make it very easy to query data and loop over it, and often faster than with the "query" or "exec" functions:

│ │ │ │
for (auto [id, name, x, y] :
│ │ │ │
tx.stream<int, std::string_view, float, float>(
│ │ │ │
"SELECT id, name, x, y FROM point"))
│ │ │ │
process(id + 1, "point-" + name, x * 10.0, y * 10.0);
│ │ │ │

The conversion to C++ types (here int, std::string_view, and two floats) is built into the function. You never even see row objects, field objects, iterators, or conversion methods. You just put in your query and you receive your data.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Results with metadata

│ │ │ │

Sometimes you want more from a query result than just rows of data. You may need to know right away how many rows of result data you received, or how many rows your UPDATE statement has affected, or the names of the columns, etc.

│ │ │ │

For that, use the transaction's "exec" query execution functions. Apart from a few exceptions, these return a pqxx::result object. A result is a container of pqxx::row objects, so you can iterate them as normal, or index them like you would index an array. Each row in turn is a container of pqxx::field, Each field holds a value, but doesn't know its type. You specify the type when you read the value.

│ │ │ │

For example, your code might do:

│ │ │ │
pqxx::result r = tx.exec("SELECT * FROM mytable");
│ │ │ │
for (auto const &row: r)
│ │ │ │
{
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/binary.html │ │ │ │ @@ -103,15 +103,15 @@ │ │ │ │
std::string hi{"Hello binary world"};
│ │ │ │
my_blob.write(pqxx::binary_cast(hi);
│ │ │ │
pqxx::binary_cast
bytes_view binary_cast(TYPE const &data)
Cast binary data to a type that libpqxx will recognise as binary.
Definition util.hxx:409
│ │ │ │

The other takes a pointer and a size:

│ │ │ │
char const greeting[] = "Hello binary world";
│ │ │ │
char const *hi = greeting;
│ │ │ │
my_blob.write(pqxx::binary_cast(hi, sizeof(greeting)));
│ │ │ │ -

│ │ │ │ +

│ │ │ │ Caveats

│ │ │ │

There are some restrictions on binary_cast that you must be aware of.

│ │ │ │

First, your data must of a type that gives us bytes. So: char, unsigned char, signed char, int8_t, uint8_t, or of course std::byte. You can't feed in a vector of double, or anything like that.

│ │ │ │

Second, the data must be laid out as a contiguous block in memory. If there's no std::data() implementation for your type, it's not suitable.

│ │ │ │

Third, binary_cast only constructs something like a std::string_view. It does not make a copy of your actual data. So, make sure that your data remains alive and in the same place while you're using it.

│ │ │ │
│ │ │ │ │ │ │ ├── ./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 │ │ │ │ @@ -788,15 +788,15 @@ │ │ │ │ std::vector< pqxx::errorhandler * > pqxx::connection::get_errorhandlers │ │ │ │ ( │ │ │ │ ) │ │ │ │ const │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ -
Deprecated:
Return pointers to the active errorhandlers.
│ │ │ │ +
Deprecated:
Return pointers to the active errorhandlers.
│ │ │ │

The entries are ordered from oldest to newest handler.

│ │ │ │

The pointers point to the real errorhandlers. The container it returns however is a copy of the one internal to the connection, not a reference.

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

◆ get_notifs()

│ │ │ │ @@ -1528,15 +1528,15 @@ │ │ │ │ ) │ │ │ │ & │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Set session variable, using SQL's SET command.

│ │ │ │ -
Deprecated:
To set a session variable, use set_session_var. To set a transaction-local variable, execute an SQL SET command.
│ │ │ │ +
Deprecated:
To set a session variable, use set_session_var. To set a transaction-local variable, execute an SQL SET command.
│ │ │ │
Warning
When setting a string value, you must escape and quote it first. Use the quote() function to do that.
│ │ │ │
│ │ │ │ This executes an SQL query, so do not get or set variables while a table stream or pipeline is active on the same connection.
│ │ │ │
Parameters
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/classpqxx_1_1const__result__iterator.html │ │ │ │ @@ -128,298 +128,298 @@ │ │ │ │ │ │ │ │ │ │ │ │
[legend]
│ │ │ │
varVariable to set.
valueNew value for Var. This can be any SQL expression. If it's a string, be sure that it's properly escaped and quoted.
│ │ │ │ │ │ │ │ │ │ │ │ +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<typename Tuple > │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── 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 │ │ │ │ │ -_u_s_i_n_g  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │ +using  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  vvaalluuee__ttyyppee = _r_o_w _c_o_n_s_t │ │ │ │ │ +using  vvaalluuee__ttyyppee = _r_o_w const │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ppooiinntteerr = _r_o_w _c_o_n_s_t * │ │ │ │ │ +using  ppooiinntteerr = _r_o_w const * │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  rreeffeerreennccee = _r_o_w │ │ │ │ │ +using  rreeffeerreennccee = _r_o_w │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │ +using  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_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  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 │ │ │ │ │ -_u_s_i_n_g  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │ +using  ssiizzee__ttyyppee = _r_o_w___s_i_z_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  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +using  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___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  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │ +using  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +using  ppooiinntteerr = _c_o_n_s_t___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  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  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___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 │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   ccoonnsstt__rreessuulltt__iitteerraattoorr () _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ +   ccoonnsstt__rreessuulltt__iitteerraattoorr () noexcept=default │ │ │ │ │   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 _c_o_n_s_t │ │ │ │ │ - &) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ +   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 │ │ │ │ │   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 &&) │ │ │ │ │ - _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ + noexcept=default │ │ │ │ │   Move an iterator. │ │ │ │ │   │ │ │ │ │ -   ccoonnsstt__rreessuulltt__iitteerraattoorr (_r_o_w _c_o_n_s_t &_t) _n_o_e_x_c_e_p_t │ │ │ │ │ +   ccoonnsstt__rreessuulltt__iitteerraattoorr (_r_o_w const &t) noexcept │ │ │ │ │   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. │ │ │ │ │ - _p_o_i_n_t_e_r  ooppeerraattoorr-->> () _c_o_n_s_t │ │ │ │ │ + pointer  ooppeerraattoorr-->> () const │ │ │ │ │   Dereference the iterator. │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () _c_o_n_s_t │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () const │ │ │ │ │   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 _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 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 &&_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++++ (_i_n_t) & │ │ │ │ │ + _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++++ () │ │ │ │ │   │ │ │ │ │ - _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---- (int) & │ │ │ │ │   │ │ │ │ │ _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) │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + void  sswwaapp (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r &other) noexcept │ │ │ │ │   Interchange two iterators in an exception-safe │ │ │ │ │ manner. │ │ │ │ │   │ │ │ │ │ Comparisons │ │ │ │ │ - _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 │ │ │ │ │ + bool  ooppeerraattoorr>>== (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &i) const │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _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  bbaacckk () 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  ffrroonntt () const noexcept │ │ │ │ │   │ │ │ │ │ - _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  aatt (size_type) 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 │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │   │ │ │ │ │ -_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 │ │ │ │ │ +constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │   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 &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ +   rrooww (_r_o_w &&) 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 │ │ │ │ │ +   rrooww (_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 const &) noexcept=default │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w &&) noexcept=default │ │ │ │ │   │ │ │ │ │ - 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 │ │ │ │ │ + PQXX_PURE bool  ooppeerraattoorr==== (_r_o_w const &) 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 │ │ │ │ │ + bool  ooppeerraattoorr!!== (_r_o_w const &rhs) 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  bbeeggiinn () 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  ccbbeeggiinn () 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  eenndd () 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 │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () 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  ffrroonntt () 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  bbaacckk () 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  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  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  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  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  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  ccrreenndd () _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 │ │ │ │ │   │ │ │ │ │ - _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  ooppeerraattoorr[[]] (size_type) const noexcept │ │ │ │ │   │ │ │ │ │ - _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  _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  aatt (size_type) _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  _a_t (_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  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │   │ │ │ │ │ - _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 size_type  ssiizzee () 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 │ │ │ │ │ +constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │   Row number, assuming this is a real row and not │ │ │ │ │ end()/rend(). │ │ │ │ │   │ │ │ │ │ - size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w col_name) const │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (size_type) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (size_type) const │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (size_type _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (size_type col_num) const │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) _c_o_n_s_t │ │ │ │ │ + size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) const │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ - size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ -_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 │ │ │ │ │ +constexpr result::size_type  nnuumm () const noexcept │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + void  _t_o (Tuple &t) const │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - std::tuple< TYPE... >  _a_s () _c_o_n_s_t │ │ │ │ │ + std::tuple< TYPE... >  _a_s () const │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  sswwaapp (_r_o_w &) _n_o_e_x_c_e_p_t │ │ │ │ │ + void  sswwaapp (_r_o_w &) noexcept │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + _r_o_w  _s_l_i_c_e (size_type sbegin, size_type send) const │ │ │ │ │   │ │ │ │ │ - PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ + PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │   Is this a row without fields? Can only happen to a │ │ │ │ │ slice. │ │ │ │ │   │ │ │ │ │ ********** AArriitthhmmeettiicc ooppeerraattoorrss ********** │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::rreessuulltt │ │ │ │ │ + class  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 _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, _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 │ │ │ │ │ +_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 │ │ │ │ │   │ │ │ │ │ - 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 │ │ │ │ │ + difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) const │ │ │ │ │   │ │ │ │ │ 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 _c_o_l_s) │ │ │ │ │ - _n_o_e_x_c_e_p_t │ │ │ │ │ +   _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 │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  cchheecckk__ssiizzee (size_type _e_x_p_e_c_t_e_d) _c_o_n_s_t │ │ │ │ │ + void  cchheecckk__ssiizzee (size_type expected) const │ │ │ │ │   Throw _u_s_a_g_e___e_r_r_o_r if row size is not expected. │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + TUPLE  _a_s___t_u_p_l_e () const │ │ │ │ │   Convert to a given tuple of values, don't check sizes. │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + void  ccoonnvveerrtt (Tuple &t) const │ │ │ │ │   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 │ │ │ │ │ -_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  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  iitteerraattoorr__ttyyppee = _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  vvaalluuee__ttyyppee = _i_t_e_r_a_t_o_r___t_y_p_e_:_:_v_a_l_u_e___t_y_p_e │ │ │ │ │ +using  vvaalluuee__ttyyppee = iterator_type::value_type │ │ │ │ │   │ │ │ │ │ -_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  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  ddiiffffeerreennccee__ttyyppee = _r_e_s_u_l_t___d_i_f_f_e_r_e_n_c_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  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │ +using  iitteerraattoorr__ccaatteeggoorryy = std::bidirectional_iterator_tag │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ppooiinntteerr = _r_o_w _c_o_n_s_t * │ │ │ │ │ +using  ppooiinntteerr = _r_o_w const * │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr ()=_d_e_f_a_u_l_t │ │ │ │ │ +   ccoonnsstt__rreevveerrssee__rreessuulltt__iitteerraattoorr ()=default │ │ │ │ │   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 _c_o_n_s_t │ │ │ │ │ - &_r_h_s)=_d_e_f_a_u_l_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 const │ │ │ │ │ + &rhs)=default │ │ │ │ │   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 _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 const &rhs) │ │ │ │ │   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 _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 const &&rhs) │ │ │ │ │   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 () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ +PQXX_PURE _c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r  bbaassee () const noexcept │ │ │ │ │   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 _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 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 &&_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++++ (_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++++ (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---- () │ │ │ │ │   │ │ │ │ │ - _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---- (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++== (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) │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + 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 │ │ │ │ │   │ │ │ │ │ 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) _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) 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___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 _c_o_n_s_t │ │ │ │ │ - &_r_h_s) _c_o_n_s_t │ │ │ │ │ + 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 │ │ │ │ │   │ │ │ │ │ Comparisons │ │ │ │ │ - _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 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 │ │ │ │ │ + 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 │ │ │ │ │   │ │ │ │ │ Dereferencing operators │ │ │ │ │ - _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 │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ - 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 │ │ │ │ │ + difference_type  ooppeerraattoorr-- (_c_o_n_s_t___r_e_s_u_l_t___i_t_e_r_a_t_o_r const &) │ │ │ │ │ + const │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ - _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () _c_o_n_s_t │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  ooppeerraattoorr** () const │ │ │ │ │   Dereference iterator. │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _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  bbaacckk () 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  ffrroonntt () const noexcept │ │ │ │ │   │ │ │ │ │ - _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  aatt (size_type) 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 │ │ │ │ │ + _r_e_f_e_r_e_n_c_e  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │   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_1internal_1_1dynamic__params.html │ │ │ │ @@ -123,15 +123,15 @@ │ │ │ │   │ │ │ │ │ │ │ │ constexpr auto access (decltype(*std::declval< IT >()) value) const -> decltype(std::declval< ACCESSOR >()(value)) │ │ │ │   │ │ │ │ │ │ │ │

Detailed Description

│ │ │ │
template<typename IT, typename ACCESSOR = decltype(iterator_identity<IT>)>
│ │ │ │ -class pqxx::internal::dynamic_params< IT, ACCESSOR >
Deprecated:
Use params instead.
│ │ │ │ +class pqxx::internal::dynamic_params< IT, ACCESSOR >
Deprecated:
Use params instead.
│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ │ │ │ │

◆ dynamic_params() [1/2]

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ ├── ./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_1params.html │ │ │ │ @@ -181,15 +181,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
(binarystring const & value) &
│ │ │ │
│ │ │ │ -
Deprecated:
Append binarystring parameter.
│ │ │ │ +
Deprecated:
Append binarystring parameter.
│ │ │ │

The binarystring must stay valid for as long as the params remains active.

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

◆ append() [2/6]

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

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  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +char const *  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +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]);
│ │ │ │ -
pqxx::const_reverse_result_iterator
Reverse iterator for result. Use as result::const_reverse_iterator.
Definition result_iterator.hxx:196
│ │ │ │ +
for (result::size_type i=0; i < std::size(R); ++i) Process(R[i]);
│ │ │ │

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()

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

◆ column_storage()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
int pqxx::result::column_storage int pqxx::result::column_storage (row_size_type number) const
│ │ │ │
│ │ │ │ @@ -394,15 +393,15 @@ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -494,23 +493,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
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -520,17 +519,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.
│ │ │ │ │ │ │ │ @@ -567,15 +566,15 @@ │ │ │ │
│ │ │ │ template<typename... TYPE>
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
auto pqxx::result::iter auto pqxx::result::iter () const
│ │ │ │ 		│ │ │ │ @@ -652,15 +651,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -735,15 +734,15 @@ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
result & pqxx::result::operator= (result const & result const & rhs)
│ │ │ │ 		│ │ │ │ defaultnoexcept
│ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -3,201 +3,198 @@ │ │ │ │ │ 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 │ │ │ │ │ -_u_s_i_n_g  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_e___t_y_p_e │ │ │ │ │ +using  ssiizzee__ttyyppee = _r_e_s_u_l_t___s_i_z_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  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  rreeffeerreennccee = _r_o_w │ │ │ │ │ +using  rreeffeerreennccee = _r_o_w │ │ │ │ │   │ │ │ │ │ -_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  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  ppooiinntteerr = _c_o_n_s_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  iitteerraattoorr = _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  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  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  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___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 │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   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 const &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 │ │ │ │ │ +   rreessuulltt (_r_e_s_u_l_t &&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 │ │ │ │ │ + _r_e_s_u_l_t &  _o_p_e_r_a_t_o_r_= (_r_e_s_u_l_t const &rhs) noexcept=default │ │ │ │ │   Assign one result to another. │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + _r_e_s_u_l_t &  ooppeerraattoorr== (_r_e_s_u_l_t &&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. │ │ │ │ │ - _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 │ │ │ │ │ + bool  ooppeerraattoorr==== (_r_e_s_u_l_t const &) const noexcept │ │ │ │ │   Compare two results for equality. │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + bool  ooppeerraattoorr!!== (_r_e_s_u_l_t const &rhs) const noexcept │ │ │ │ │   Compare two results for inequality. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - _a_u_t_o  _i_t_e_r () _c_o_n_s_t │ │ │ │ │ + auto  _i_t_e_r () const │ │ │ │ │   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 () _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  rrbbeeggiinn () 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  ccrrbbeeggiinn () 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  rreenndd () 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___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r  ccrreenndd () const │ │ │ │ │   │ │ │ │ │ - _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  bbeeggiinn () 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  ccbbeeggiinn () 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  eenndd () 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 │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () 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  ffrroonntt () 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  bbaacckk () const noexcept │ │ │ │ │   │ │ │ │ │ - PQXX_PURE size_type  ssiizzee () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ + PQXX_PURE size_type  ssiizzee () const noexcept │ │ │ │ │   │ │ │ │ │ - PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ + PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │   │ │ │ │ │ - size_type  ccaappaacciittyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ + size_type  ccaappaacciittyy () const noexcept │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  _s_w_a_p (_r_e_s_u_l_t &) _n_o_e_x_c_e_p_t │ │ │ │ │ + void  _s_w_a_p (_r_e_s_u_l_t &) noexcept │ │ │ │ │   Exchange two result values in an exception-safe manner. │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + _r_o_w  _o_p_e_r_a_t_o_r_[_] (size_type i) const noexcept │ │ │ │ │   Index a row by number. │ │ │ │ │   │ │ │ │ │ - _r_o_w  aatt (size_type) _c_o_n_s_t │ │ │ │ │ + _r_o_w  aatt (size_type) const │ │ │ │ │   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) _c_o_n_s_t │ │ │ │ │ + _f_i_e_l_d  aatt (size_type, _r_o_w___s_i_z_e___t_y_p_e) const │ │ │ │ │   Index a field by row number and column number. │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  _c_l_e_a_r () _n_o_e_x_c_e_p_t │ │ │ │ │ + void  _c_l_e_a_r () noexcept │ │ │ │ │   Let go of the result's data. │ │ │ │ │   │ │ │ │ │ ********** CCoolluummnn iinnffoorrmmaattiioonn ********** │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ppiippeelliinnee │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ppiippeelliinnee │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::ffiieelldd │ │ │ │ │ + class  ppqqxxxx::::ffiieelldd │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccrreeaattiioonn │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccrreeaattiioonn │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccoonnnneeccttiioonn │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ccoonnnneeccttiioonn │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__rrooww │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__rrooww │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ssqqll__ccuurrssoorr │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::ggaattee::::rreessuulltt__ssqqll__ccuurrssoorr │ │ │ │ │   │ │ │ │ │ - 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 │ │ │ │ │ + PQXX_PURE _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnnss () const noexcept │ │ │ │ │   Number of columns in result. │ │ │ │ │   │ │ │ │ │ - _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w name) _c_o_n_s_t │ │ │ │ │ + _r_o_w___s_i_z_e___t_y_p_e  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w name) const │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - _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 & │ │ │ │ │ + char const *  ccoolluummnn__nnaammee (_r_o_w___s_i_z_e___t_y_p_e number) const & │ │ │ │ │   Name of column with this number (throws │ │ │ │ │ exception if it doesn't exist) │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + 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 │ │ │ │ │   Server-side storage size for field of column's │ │ │ │ │ type, in bytes. │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + 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 │ │ │ │ │   Type modifier of the column with this number. │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_r_o_w___s_i_z_e___t_y_p_e col_num) const │ │ │ │ │   Return column's type, as an OID from the system │ │ │ │ │ catalogue. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │   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 _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_r_o_w___s_i_z_e___t_y_p_e col_num) const │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │   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 _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │ + _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 │ │ │ │ │   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 _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _r_o_w___s_i_z_e___t_y_p_e  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │   What column in its table did this column come │ │ │ │ │ from? │ │ │ │ │   │ │ │ │ │ -PQXX_PURE std::string _c_o_n_s_t &  qquueerryy () _c_o_n_s_t &_n_o_e_x_c_e_p_t │ │ │ │ │ +PQXX_PURE std::string const &  qquueerryy () const &noexcept │ │ │ │ │   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 () _c_o_n_s_t │ │ │ │ │ + PQXX_PURE _o_i_d  _i_n_s_e_r_t_e_d___o_i_d () const │ │ │ │ │   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 () _c_o_n_s_t │ │ │ │ │ + PQXX_PURE size_type  _a_f_f_e_c_t_e_d___r_o_w_s () const │ │ │ │ │   If command was INSERT, UPDATE, or DELETE: number │ │ │ │ │ of affected rows. │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + void  _f_o_r___e_a_c_h (CALLABLE &&func) const │ │ │ │ │   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) _c_o_n_s_t │ │ │ │ │ + _r_e_s_u_l_t  _e_x_p_e_c_t___r_o_w_s (size_type n) const │ │ │ │ │   Check that result contains exactly n rows. │ │ │ │ │   │ │ │ │ │ - _r_o_w  _o_n_e___r_o_w () _c_o_n_s_t │ │ │ │ │ + _r_o_w  _o_n_e___r_o_w () const │ │ │ │ │   Check that result contains exactly 1 row, and │ │ │ │ │ return that row. │ │ │ │ │   │ │ │ │ │ - std::optional< _r_o_w >  _o_p_t___r_o_w () _c_o_n_s_t │ │ │ │ │ + std::optional< _r_o_w >  _o_p_t___r_o_w () const │ │ │ │ │   Expect that result contains at moost one row, │ │ │ │ │ and return as optional. │ │ │ │ │   │ │ │ │ │ - _r_e_s_u_l_t  nnoo__rroowwss () _c_o_n_s_t │ │ │ │ │ + _r_e_s_u_l_t  nnoo__rroowwss () const │ │ │ │ │   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 _c_o_l_s) _c_o_n_s_t │ │ │ │ │ + _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 │ │ │ │ │   Expect that result consists of exactly cols │ │ │ │ │ columns. │ │ │ │ │   │ │ │ │ │ - _f_i_e_l_d  _o_n_e___f_i_e_l_d () _c_o_n_s_t │ │ │ │ │ + _f_i_e_l_d  _o_n_e___f_i_e_l_d () const │ │ │ │ │   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) _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 │ │ │ │ │ +for (result::size_type i=0; i < std::size(R); ++i) Process(R[i]); │ │ │ │ │ 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 │ │ │ │ │ @@ -207,29 +204,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(()) ********** │ │ │ │ │ -_v_o_i_d pqxx::result:: ( ) inlinenoexcept │ │ │ │ │ +void 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(()) ********** │ │ │ │ │ -_i_n_t pqxx::result::column_storage ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const │ │ │ │ │ +int 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(()) ********** │ │ │ │ │ -_i_n_t pqxx::result::column_type_modifier ( _r_o_w___s_i_z_e___t_y_p_e  nnuummbbeerr ) const noexcept │ │ │ │ │ +int 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 │ │ │ │ │ @@ -245,16 +242,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<_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 │ │ │ │ │ +template │ │ │ │ │ +void pqxx::result::for_each ( CALLABLE &&  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 │ │ │ │ │ @@ -262,17 +259,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: │ │ │ │ │ -_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"; │ │ │ │ │ +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 │ │ │ │ │ _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 │ │ │ │ │ @@ -281,15 +278,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 │ │ │ │ │ -_a_u_t_o pqxx::result::iter ( ) const inline │ │ │ │ │ +auto 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. │ │ │ │ │ @@ -301,15 +298,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 _c_o_n_s_t &  rrhhss ) defaultnoexcept │ │ │ │ │ +_r_e_s_u_l_t & pqxx::result:: ( _r_e_s_u_l_t const &  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. │ │ │ │ │ @@ -319,15 +316,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(()) ********** │ │ │ │ │ -_v_o_i_d pqxx::result:: ( _r_e_s_u_l_t &  rrhhss ) noexcept │ │ │ │ │ +void 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,81 +250,80 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +oid  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +size_type  │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +constexpr result::size_type  │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +PQXX_PURE bool  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ +void  │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ +template<typename Tuple > │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │

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;
│ │ │ │ -
pqxx::const_reverse_row_iterator
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition row.hxx:411
│ │ │ │ +
cout << row["date"].c_str() << ": " << row["name"].c_str() << endl;
│ │ │ │
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()

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

◆ as_tuple()

│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ -template<typename TUPLE >
│ │ │ │ +template<typename TUPLE >
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
TUPLE pqxx::row::as_tuple TUPLE pqxx::row::as_tuple () const
│ │ │ │ 		│ │ │ │ @@ -498,15 +497,15 @@ │ │ │ │ ) const
│ │ │ │
│ │ │ │

Produce a slice of this row, containing the given range of columns.

│ │ │ │ -
Deprecated:
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.
│ │ │ │ +
Deprecated:
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.
│ │ │ │

The slice runs from the range's starting column to the range's end column, exclusive. It looks just like a normal result row, except slices can be empty.

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

◆ table_column()

│ │ │ │ │ │ │ │ @@ -537,23 +536,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 │ │ │ │ │ -_u_s_i_n_g  ssiizzee__ttyyppee = _r_o_w___s_i_z_e___t_y_p_e │ │ │ │ │ +using  ssiizzee__ttyyppee = _r_o_w___s_i_z_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  ddiiffffeerreennccee__ttyyppee = _r_o_w___d_i_f_f_e_r_e_n_c_e___t_y_p_e │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +using  ccoonnsstt__iitteerraattoorr = _c_o_n_s_t___r_o_w___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  iitteerraattoorr = _c_o_n_s_t___i_t_e_r_a_t_o_r │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │ +using  rreeffeerreennccee = _f_i_e_l_d │ │ │ │ │   │ │ │ │ │ -_u_s_i_n_g  ppooiinntteerr = _c_o_n_s_t___r_o_w___i_t_e_r_a_t_o_r │ │ │ │ │ +using  ppooiinntteerr = _c_o_n_s_t___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  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  rreevveerrssee__iitteerraattoorr = _c_o_n_s_t___r_e_v_e_r_s_e___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 │ │ │ │ │   │ │ │ │ │ PPuubblliicc MMeemmbbeerr FFuunnccttiioonnss │ │ │ │ │ -   rrooww (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ +   rrooww (_r_o_w &&) 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 │ │ │ │ │ +   rrooww (_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 const &) noexcept=default │ │ │ │ │   │ │ │ │ │ - _r_o_w &  ooppeerraattoorr== (_r_o_w &&) _n_o_e_x_c_e_p_t=_d_e_f_a_u_l_t │ │ │ │ │ + _r_o_w &  ooppeerraattoorr== (_r_o_w &&) noexcept=default │ │ │ │ │   │ │ │ │ │ Comparison │ │ │ │ │ - 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 │ │ │ │ │ + PQXX_PURE bool  ooppeerraattoorr==== (_r_o_w const &) 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 │ │ │ │ │ + bool  ooppeerraattoorr!!== (_r_o_w const &rhs) 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  bbeeggiinn () 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  ccbbeeggiinn () 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  eenndd () 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 │ │ │ │ │ + _c_o_n_s_t___i_t_e_r_a_t_o_r  cceenndd () const noexcept │ │ │ │ │   │ │ │ │ │ Field access │ │ │ │ │ - _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  ffrroonntt () 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  bbaacckk () 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  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  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  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  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  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  ccrreenndd () _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 │ │ │ │ │   │ │ │ │ │ - _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  ooppeerraattoorr[[]] (size_type) const noexcept │ │ │ │ │   │ │ │ │ │ - _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  _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  aatt (size_type) _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  _a_t (_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  _a_t (_z_v_i_e_w col_name) const │ │ │ │ │   │ │ │ │ │ - _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 size_type  ssiizzee () 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 │ │ │ │ │ +constexpr result::size_type  rroowwnnuummbbeerr () const noexcept │ │ │ │ │   Row number, assuming this is a real row and not │ │ │ │ │ end()/rend(). │ │ │ │ │   │ │ │ │ │ ********** CCoolluummnn iinnffoorrmmaattiioonn ********** │ │ │ │ │ - _c_l_a_s_s  ccoonnsstt__rrooww__iitteerraattoorr │ │ │ │ │ + class  ccoonnsstt__rrooww__iitteerraattoorr │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  rreessuulltt │ │ │ │ │ + class  rreessuulltt │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - _c_l_a_s_s  ppqqxxxx::::iinntteerrnnaall::::rreessuulltt__iitteerr │ │ │ │ │ + class  ppqqxxxx::::iinntteerrnnaall::::rreessuulltt__iitteerr │ │ │ │ │   │ │ │ │ │ - _c_l_a_s_s  ffiieelldd │ │ │ │ │ + class  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,81 +98,78 @@ │ │ │ │ │   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 _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + size_type  ccoolluummnn__nnuummbbeerr (_z_v_i_e_w col_name) const │ │ │ │ │   Number of given column (throws exception if it │ │ │ │ │ doesn't exist). │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (size_type) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (size_type) const │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttyyppee (_z_v_i_e_w col_name) const │ │ │ │ │   Return a column's type. │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (size_type _c_o_l___n_u_m) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (size_type col_num) const │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + _o_i_d  ccoolluummnn__ttaabbllee (_z_v_i_e_w col_name) const │ │ │ │ │   What table did this column come from? │ │ │ │ │   │ │ │ │ │ - size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) _c_o_n_s_t │ │ │ │ │ + size_type  _t_a_b_l_e___c_o_l_u_m_n (size_type) const │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ - size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w _c_o_l___n_a_m_e) _c_o_n_s_t │ │ │ │ │ + size_type  ttaabbllee__ccoolluummnn (_z_v_i_e_w col_name) const │ │ │ │ │   What column number in its table did this result │ │ │ │ │ column come from? │ │ │ │ │   │ │ │ │ │ -_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 │ │ │ │ │ +constexpr result::size_type  nnuumm () const noexcept │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + void  _t_o (Tuple &t) const │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ template │ │ │ │ │ - std::tuple< TYPE... >  _a_s () _c_o_n_s_t │ │ │ │ │ + std::tuple< TYPE... >  _a_s () const │ │ │ │ │   Extract entire row's values into a tuple. │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  sswwaapp (_r_o_w &) _n_o_e_x_c_e_p_t │ │ │ │ │ + void  sswwaapp (_r_o_w &) noexcept │ │ │ │ │   │ │ │ │ │ - _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 │ │ │ │ │ + _r_o_w  _s_l_i_c_e (size_type sbegin, size_type send) const │ │ │ │ │   │ │ │ │ │ - PQXX_PURE _b_o_o_l  eemmppttyy () _c_o_n_s_t _n_o_e_x_c_e_p_t │ │ │ │ │ + PQXX_PURE bool  eemmppttyy () const noexcept │ │ │ │ │   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 │ │ │ │ │ - _c_o_l_s) _n_o_e_x_c_e_p_t │ │ │ │ │ +   _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 │ │ │ │ │   │ │ │ │ │ - _v_o_i_d  cchheecckk__ssiizzee (size_type _e_x_p_e_c_t_e_d) _c_o_n_s_t │ │ │ │ │ + void  cchheecckk__ssiizzee (size_type expected) const │ │ │ │ │   Throw _u_s_a_g_e___e_r_r_o_r if row size is not expected. │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + TUPLE  _a_s___t_u_p_l_e () const │ │ │ │ │   Convert to a given tuple of values, don't check │ │ │ │ │ sizes. │ │ │ │ │   │ │ │ │ │ -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 │ │ │ │ │ +template │ │ │ │ │ + void  ccoonnvveerrtt (Tuple &t) const │ │ │ │ │   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): │ │ │ │ │ -_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 │ │ │ │ │ +cout << _r_o_w["date"].c_str() << ": " << _r_o_w["name"].c_str() << endl; │ │ │ │ │ _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(()) ********** │ │ │ │ │ @@ -194,16 +191,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<_t_y_p_e_n_a_m_e _T_U_P_L_E > │ │ │ │ │ -_T_U_P_L_E pqxx::row::as_tuple ( ) const inlineprotected │ │ │ │ │ +template │ │ │ │ │ +TUPLE 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 │ │ │ │ │ @@ -232,16 +229,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<_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 │ │ │ │ │ +template │ │ │ │ │ +void pqxx::row::to ( Tuple &  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 │ │ │ │ @@ -209,15 +209,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ - │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
void pqxx::row::to void pqxx::row::to (Tuple & Tuple & t) const
│ │ │ │ 		│ │ │ │ inline
 
static stream_from table (transaction_base &tx, table_path path, std::initializer_list< std::string_view > columns={})
 Factory: Stream data from a given table.
 
│ │ │ │

Detailed Description

│ │ │ │

Stream data from the database.

│ │ │ │ -
Deprecated:
Use transaction_base::stream.
│ │ │ │ +
Deprecated:
Use transaction_base::stream.
│ │ │ │

For larger data sets, retrieving data this way is likely to be faster than executing a query and then iterating and converting the rows fields. You will also be able to start processing before all of the data has come in.

│ │ │ │

There are also downsides. Not all kinds of query will work in a stream. But straightforward SELECT and UPDATE ... RETURNING queries should work. This function makes use of pqxx::stream_from, which in turn uses PostgreSQL's COPY command, so see the documentation for those to get the full details.

│ │ │ │

There are other downsides. If there stream encounters an error, it may leave the entire connection in an unusable state, so you'll have to give the whole thing up. Finally, opening a stream puts the connection in a special state, so you won't be able to do many other things with the connection or the transaction while the stream is open.

│ │ │ │

There are two ways of starting a stream: you stream either all rows in a table (using one of the factories, table() or raw_table()), or the results of a query (using the query() factory).

│ │ │ │

Usually you'll want the stream convenience wrapper in transaction_base, * so you don't need to deal with this class directly.

│ │ │ │
Warning
While a stream is active, you cannot execute queries, open a pipeline, etc. on the same transaction. A transaction can have at most one object of a type derived from pqxx::transaction_focus active on it at a time.
│ │ │ │

Constructor & Destructor Documentation

│ │ │ │ @@ -250,15 +250,15 @@ │ │ │ │
)
│ │ │ │
│ │ │ │ │ │ │ │

Execute query, and stream over the results.

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

◆ stream_from() [2/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/deprecated.html │ │ │ │ @@ -95,85 +95,85 @@ │ │ │ │
│ │ │ │
│ │ │ │
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.
│ │ │ │ -
Class pqxx::basic_lostream< CHAR, TRAITS >
│ │ │ │
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.
│ │ │ │ +
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.
│ │ │ │ +
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.
│ │ │ │ +
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 (char const user[], char const password[])
│ │ │ │ -
Use connection::encrypt_password instead.
│ │ │ │ +
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.
│ │ │ │
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.
│ │ │ │ +
Use transaction_base::stream instead of stream_from.
│ │ │ │
Struct pqxx::from_query_t
│ │ │ │ -
Use stream_from::query() instead.
│ │ │ │ +
Use stream_from::query() instead.
│ │ │ │
Member pqxx::from_table
│ │ │ │ -
Use transaction_base::stream instead of stream_from.
│ │ │ │ +
Use transaction_base::stream instead of stream_from.
│ │ │ │
Struct pqxx::from_table_t
│ │ │ │ -
Use stream_from::table() instead.
│ │ │ │ +
Use stream_from::table() instead.
│ │ │ │
Class pqxx::internal::dynamic_params< IT, ACCESSOR >
│ │ │ │ -
Use params instead.
│ │ │ │ +
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.
│ │ │ │ +
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.
│ │ │ │ +
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_query_t, std::string_view query)
│ │ │ │ -
Use factory function query 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 &tx, std::string_view table, Columns const &columns)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │ -
Member pqxx::stream_from::stream_from (transaction_base &tx, std::string_view table)
│ │ │ │ -
Use factories table or raw_table instead.
│ │ │ │ +
Use transaction_base::stream.
│ │ │ │
Member pqxx::stream_from::stream_from (transaction_base &tx, from_table_t, std::string_view table, Columns const &columns)
│ │ │ │
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.
│ │ │ │
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_to::stream_to (transaction_base &, std::string_view table_name, Columns const &columns)
│ │ │ │ -
Use table or raw_table as a factory.
│ │ │ │ +
Member pqxx::stream_from::stream_from (transaction_base &tx, std::string_view table, Columns const &columns)
│ │ │ │ +
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_query_t, std::string_view query)
│ │ │ │ +
Use factory function query instead.
│ │ │ │
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.
│ │ │ │ +
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 {} │ │ │ │ │ @@ -26,18 +26,18 @@ │ │ │ │ │ Return pointers to the active errorhandlers. │ │ │ │ │ Member _p_q_x_x_:_:_c_o_n_n_e_c_t_i_o_n_:_:_s_e_t___v_a_r_i_a_b_l_e (std::string_view var, std::string_view │ │ │ │ │ value) & │ │ │ │ │ To set a session variable, use _s_e_t___s_e_s_s_i_o_n___v_a_r. To set a transaction- │ │ │ │ │ local variable, execute an SQL SET command. │ │ │ │ │ Member _p_q_x_x_:_:_c_o_n_n_e_c_t_i_o_n___b_a_s_e │ │ │ │ │ Old base class for connection. They are now the same class. │ │ │ │ │ - Member _p_q_x_x_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d (char const user[], char const password[]) │ │ │ │ │ - Use _c_o_n_n_e_c_t_i_o_n_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d instead. │ │ │ │ │ Member _p_q_x_x_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d (zview user, zview password) │ │ │ │ │ Use _c_o_n_n_e_c_t_i_o_n_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d instead. │ │ │ │ │ + Member _p_q_x_x_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d (char const user[], char const password[]) │ │ │ │ │ + Use _c_o_n_n_e_c_t_i_o_n_:_:_e_n_c_r_y_p_t___p_a_s_s_w_o_r_d instead. │ │ │ │ │ Class _p_q_x_x_:_:_e_r_r_o_r_h_a_n_d_l_e_r │ │ │ │ │ Base class for obsolete error-handler callbacks. │ │ │ │ │ Member _p_q_x_x_:_:_f_i_e_l_d_s_t_r_e_a_m │ │ │ │ │ Read a field using _f_i_e_l_d_:_:_a_s<...>() or _f_i_e_l_d_:_:_c___s_t_r_(_). │ │ │ │ │ Member _p_q_x_x_:_:_f_r_o_m___q_u_e_r_y │ │ │ │ │ Use _t_r_a_n_s_a_c_t_i_o_n___b_a_s_e_:_:_s_t_r_e_a_m instead of _s_t_r_e_a_m___f_r_o_m. │ │ │ │ │ Struct _p_q_x_x_:_:_f_r_o_m___q_u_e_r_y___t │ │ │ │ │ @@ -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___q_u_e_r_y___t, │ │ │ │ │ - std::string_view query) │ │ │ │ │ + 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 &, 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, 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 &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, _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 &, _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___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___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___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 &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 │ │ │ │ @@ -920,15 +920,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
struct pqxx::from_query_t
│ │ │ │
│ │ │ │

Marker for stream_from constructors: "stream from query.".

│ │ │ │ -
Deprecated:
Use stream_from::query() instead.
│ │ │ │ +
Deprecated:
Use stream_from::query() instead.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ pqxx::from_table_t

│ │ │ │ │ │ │ │
│ │ │ │ @@ -936,15 +936,15 @@ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
struct pqxx::from_table_t
│ │ │ │
│ │ │ │

Marker for stream_from constructors: "stream from table.".

│ │ │ │ -
Deprecated:
Use stream_from::table() instead.
│ │ │ │ +
Deprecated:
Use stream_from::table() instead.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ pqxx::notification

│ │ │ │ │ │ │ │
│ │ │ │ @@ -1073,15 +1073,15 @@ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
using pqxx::connection_base = typedef connection
│ │ │ │
│ │ │ │ -
Deprecated:
Old base class for connection. They are now the same class.
│ │ │ │ +
Deprecated:
Old base class for connection. They are now the same class.
│ │ │ │ │ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

◆ fieldstream

│ │ │ │ │ │ │ │
│ │ │ │ @@ -1107,15 +1107,15 @@ │ │ │ │ │ │ │ │ using pqxx::strip_t = typedef std::remove_cv_t<std::remove_reference_t<TYPE> > │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Remove any constness, volatile, and reference-ness from a type.

│ │ │ │ -
Deprecated:
In C++20 we'll replace this with std::remove_cvref.
│ │ │ │ +
Deprecated:
In C++20 we'll replace this with std::remove_cvref.
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │

◆ table_path

│ │ │ │ │ │ │ │
│ │ │ │ @@ -1486,15 +1486,15 @@ │ │ │ │ ) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Encrypt a password.

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

◆ encrypt_password() [2/2]

│ │ │ │ │ │ │ │
│ │ │ │ @@ -1525,15 +1525,15 @@ │ │ │ │ │ │ │ │ inline │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Encrypt password.

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

◆ from_string()

│ │ │ │ │ │ │ │
│ │ │ │ @@ -1985,15 +1985,15 @@ │ │ │ │ │ │ │ │ constexpr │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Pass this to a stream_from constructor to stream query results.

│ │ │ │ -
Deprecated:
Use transaction_base::stream instead of stream_from.
│ │ │ │ +
Deprecated:
Use transaction_base::stream instead of stream_from.
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │

◆ from_table

│ │ │ │ │ │ │ │
│ │ │ │ @@ -2010,15 +2010,15 @@ │ │ │ │ │ │ │ │ constexpr │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │

Pass this to a stream_from constructor to stream table contents.

│ │ │ │ -
Deprecated:
Use transaction_base::stream instead of stream_from.
│ │ │ │ +
Deprecated:
Use transaction_base::stream instead of stream_from.
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │

◆ has_generic_bytes_char_traits

│ │ │ │ │ │ │ │
│ │ │ ├── ./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.
│ │ │ │
│ │ │ │
│ │ │ │ │ │ │ │

Inserting the 101 in there is awkward and even dangerous. We'll get to that in a moment. Here's how you do it better, using parameters:

│ │ │ │
pqxx::result r = tx.exec("SELECT name FROM employee WHERE id=$1", {101});
│ │ │ │

That second argument to exec(), the {101}, constructs a pqxx::params object. The exec() call will fill this value in where the query says $1.

│ │ │ │

Doing this saves you work. If you don't use statement parameters, you'll need to quote and escape your values (see connection::quote() and friends) as you insert them into your query as literal values.

│ │ │ │

Or if you forget to do that, you leave yourself open to horrible SQL injection attacks. Trust me, I was born in a town whose name started with an apostrophe!

│ │ │ │

With parameters you can pass your values as they are, and they will go across the wire to the database in a safe format.

│ │ │ │

In some cases it may even be faster! When a parameter represents binary data (as in the SQL BYTEA type), libpqxx will send it directly as binary, which is a bit more efficient than the standard textual format in which the data normally gets sent to the database. If you insert the binary data directly in your query text, your CPU will have some extra work to do, converting the data into a text format, escaping it, and adding quotes; and the data will take up more bytes, which take time to transmit.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Multiple parameters

│ │ │ │

The pqxx::params class is quite fleixble. It can contain any number of parameter values, of many different types.

│ │ │ │

You can pass them in while constructing the params object:

│ │ │ │
pqxx::params{23, "acceptance", 3.14159}
│ │ │ │
pqxx::params
Build a parameter list for a parameterised or prepared statement.
Definition params.hxx:33
│ │ │ │

Or you can add them one by one:

│ │ │ │
pqxx::params p;
│ │ │ │ @@ -117,15 +117,15 @@ │ │ │ │
p.append("acceptance");
│ │ │ │
p.append(3.14159);
│ │ │ │
pqxx::params::append
void append() &
Append a null value.
Definition params.cxx:32
│ │ │ │

You can also combine the two, passing some values int the constructor and adding the rest later. You can even insert a params into a params:

│ │ │ │
pqxx::params p{23};
│ │ │ │
p.append(params{"acceptance", 3.14159});
│ │ │ │

Each of these examples will produce the same list of parameters.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Generating placeholders

│ │ │ │

If your code gets particularly complex, it may sometimes happen that it becomes hard to track which parameter value belongs with which placeholder. Did you intend to pass this numeric value as $7, or as $8? The answer may depend on an if that happened earlier in a different function.

│ │ │ │

(Generally if things get that complex, it's a good idea to look for simpler solutions. But especially when performance matters, sometimes you can't avoid complexity like that.)

│ │ │ │

There's a little helper class called placeholders. You can use it as a counter which produces those placeholder strings, $1, $2, $3, et cetera. When you start generating a complex statement, you can create both a params and a placeholders:

│ │ │ │
pqxx::params values;
│ │ │ │
pqxx::placeholders name;
│ │ │ │
pqxx::placeholders
Generate parameter placeholders for use in an SQL statement.
Definition params.hxx:206
│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/prepared.html │ │ │ │ @@ -91,15 +91,15 @@ │ │ │ │ │ │ │ │
│ │ │ │
Prepared statements
│ │ │ │
│ │ │ │
│ │ │ │

Prepared statements are SQL queries that you define once and then invoke as many times as you like, typically with varying parameters. It's a lot like a function that you can define ad hoc, within the scope of one connection.

│ │ │ │

If you have an SQL statement that you're going to execute many times in quick succession, it may (but see below!) be more efficient to prepare it once and reuse it. This saves the database backend the effort of parsing the SQL and figuring out an efficient execution plan.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Preparing a statement

│ │ │ │

You create a prepared statement by preparing it on the connection (using the pqxx::connection::prepare functions), passing an identifying name for the statement, and its SQL text.

│ │ │ │

The statement's name should consist of ASCII letters, digits, and underscores only, and start with an ASCII letter. The name is case-sensitive.

│ │ │ │
void prepare_my_statement(pqxx::connection &cx)
│ │ │ │
{
│ │ │ │
cx.prepare(
│ │ │ │
"my_statement",
│ │ │ │ @@ -112,15 +112,15 @@ │ │ │ │
{
│ │ │ │
return t.exec(pqxx::prepped{"my_statement"});
│ │ │ │
}
│ │ │ │
pqxx::prepped
A string that is the name of a prepared statement.
Definition prepared_statement.hxx:70
│ │ │ │
pqxx::result
Result set containing data returned by a query or command.
Definition result.hxx:92
│ │ │ │
pqxx::transaction_base::exec
result exec(std::string_view query, std::string_view desc)
Execute a command.
Definition transaction_base.cxx:249
│ │ │ │
pqxx::transaction_base
Interface definition (and common code) for "transaction" classes.
Definition transaction_base.hxx:151
│ │ │ │ -

│ │ │ │ +

│ │ │ │ Parameters

│ │ │ │

You can pass parameters to a prepared statemet, just like you can with a regular statement. The query text can contain $1, $2 etc. as placeholders for parameter values that you will provide when you invoke the prepared satement.

│ │ │ │

See Statement parameters for more about this. And here's a simple example of preparing a statement and invoking it with parameters:

│ │ │ │
void prepare_find(pqxx::connection &cx)
│ │ │ │
{
│ │ │ │
// Prepare a statement called "find" that looks for employees with a
│ │ │ │
// given name (parameter 1) whose salary exceeds a given number
│ │ │ │ @@ -131,24 +131,24 @@ │ │ │ │
}
│ │ │ │

This example looks up the prepared statement "find," passes name and min_salary as parameters, and invokes the statement with those values:

│ │ │ │
pqxx::result execute_find(
│ │ │ │
pqxx::transaction_base &tx, std::string name, int min_salary)
│ │ │ │
{
│ │ │ │
return tx.exec(pqxx::prepped{"find"}, name, min_salary);
│ │ │ │
}
│ │ │ │ -

│ │ │ │ +

│ │ │ │ A special prepared statement

│ │ │ │

There is one special case: the nameless prepared statement. You may prepare a statement without a name, i.e. whose name is an empty string. The unnamed statement can be redefined at any time, without un-preparing it first.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Performance note

│ │ │ │

Don't assume that using prepared statements will speed up your application. There are cases where prepared statements are actually slower than plain SQL.

│ │ │ │

The reason is that the backend can often produce a better execution plan when it knows the statement's actual parameter values.

│ │ │ │

For example, say you've got a web application and you're querying for users with status "inactive" who have email addresses in a given domain name X. If X is a very popular provider, the best way for the database engine to plan the query may be to list the inactive users first and then filter for the email addresses you're looking for. But in other cases, it may be much faster to find matching email addresses first and then see which of their owners are "inactive." A prepared statement must be planned to fit either case, but a direct query will be optimised based on table statistics, partial indexes, etc.

│ │ │ │

So, as with any optimisation... measure where your real performance problems are before you start making changes, and then afterwards, measure whether your changes actually helped. Don't complicate your code unless it solves a real problem. Knuth's Law applies.

│ │ │ │ -

│ │ │ │ +

│ │ │ │ Zero bytes

│ │ │ │
Warning
Beware of zero ("nul") bytes!
│ │ │ │

Since libpqxx is a wrapper around libpq, the C-level client library, most strings you pass to the library should be compatible with C-style strings. So they must end with a single byte with value 0, and the text within them cannot contain any such zero bytes.

│ │ │ │

(The pqxx::zview type exists specifically to tell libpqxx: "this is a │ │ │ │ C-compatible string, containing no zero bytes but ending in a zero byte.")

│ │ │ │

One example is prepared statement names. But the same also goes for the parameters values. Any string you pass as a parameter will end at the first char with value zero. If you pass a string that contains a zero byte, the last byte in the value will be the one just before the zero.

│ │ │ │

So, if you need a zero byte in a string, consider that it's really a binary string, which is not the same thing as a text string. SQL represents binary data as the BYTEA type, or in binary large objects ("blobs").

│ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/result_8hxx_source.html │ │ │ │ @@ -178,31 +178,31 @@ │ │ │ │
96 using reference = row;
│ │ │ │
97 using const_iterator = const_result_iterator;
│ │ │ │
98 using pointer = const_iterator;
│ │ │ │
99 using iterator = const_iterator;
│ │ │ │
100 using const_reverse_iterator = const_reverse_result_iterator;
│ │ │ │
101 using reverse_iterator = const_reverse_iterator;
│ │ │ │
102
│ │ │ │ -
103 result() noexcept :
│ │ │ │ +
103 result() noexcept :
│ │ │ │
104 m_data{}, m_query{}, m_encoding{internal::encoding_group::MONOBYTE}
│ │ │ │
105 {}
│ │ │ │
106
│ │ │ │ -
107 result(result const &rhs) noexcept = default;
│ │ │ │ -
108 result(result &&rhs) noexcept = default;
│ │ │ │ +
107 result(result const &rhs) noexcept = default;
│ │ │ │ +
108 result(result &&rhs) noexcept = default;
│ │ │ │
109
│ │ │ │
111
│ │ │ │ -
114 result &operator=(result const &rhs) noexcept = default;
│ │ │ │ +
114 result &operator=(result const &rhs) noexcept = default;
│ │ │ │
115
│ │ │ │ -
117 result &operator=(result &&rhs) noexcept = default;
│ │ │ │ +
117 result &operator=(result &&rhs) noexcept = default;
│ │ │ │
118
│ │ │ │ -
128 [[nodiscard]] bool operator==(result const &) const noexcept;
│ │ │ │ +
128 [[nodiscard]] bool operator==(result const &) const noexcept;
│ │ │ │
│ │ │ │ -
130 [[nodiscard]] bool operator!=(result const &rhs) const noexcept
│ │ │ │ +
130 [[nodiscard]] bool operator!=(result const &rhs) const noexcept
│ │ │ │
131 {
│ │ │ │ -
132 return not operator==(rhs);
│ │ │ │ +
132 return not operator==(rhs);
│ │ │ │
133 }
│ │ │ │
│ │ │ │
135
│ │ │ │
137
│ │ │ │
143 template<typename... TYPE> auto iter() const;
│ │ │ │
144
│ │ │ │
145 [[nodiscard]] const_reverse_iterator rbegin() const;
│ │ │ │ @@ -235,15 +235,15 @@ │ │ │ │
180
│ │ │ │
182 row at(size_type) const;
│ │ │ │
183
│ │ │ │
185 field at(size_type, row_size_type) const;
│ │ │ │
186
│ │ │ │
188
│ │ │ │
│ │ │ │ -
195 void clear() noexcept
│ │ │ │ +
195 void clear() noexcept
│ │ │ │
196 {
│ │ │ │
197 m_data.reset();
│ │ │ │
198 m_query = nullptr;
│ │ │ │
199 }
│ │ │ │
│ │ │ │
200
│ │ │ │
206 [[nodiscard]] PQXX_PURE row_size_type columns() const noexcept;
│ │ │ │ @@ -257,35 +257,35 @@ │ │ │ │
219
│ │ │ │
221
│ │ │ │
231 [[nodiscard]] int column_type_modifier(row_size_type number) const noexcept;
│ │ │ │
232
│ │ │ │
234 [[nodiscard]] oid column_type(row_size_type col_num) const;
│ │ │ │
235
│ │ │ │
│ │ │ │ -
237 [[nodiscard]] oid column_type(zview col_name) const
│ │ │ │ +
237 [[nodiscard]] oid column_type(zview col_name) const
│ │ │ │
238 {
│ │ │ │ -
239 return column_type(column_number(col_name));
│ │ │ │ +
239 return column_type(column_number(col_name));
│ │ │ │
240 }
│ │ │ │
│ │ │ │
241
│ │ │ │
243 [[nodiscard]] oid column_table(row_size_type col_num) const;
│ │ │ │
244
│ │ │ │
│ │ │ │ -
246 [[nodiscard]] oid column_table(zview col_name) const
│ │ │ │ +
246 [[nodiscard]] oid column_table(zview col_name) const
│ │ │ │
247 {
│ │ │ │ -
248 return column_table(column_number(col_name));
│ │ │ │ +
248 return column_table(column_number(col_name));
│ │ │ │
249 }
│ │ │ │
│ │ │ │
250
│ │ │ │
252 [[nodiscard]] row_size_type table_column(row_size_type col_num) const;
│ │ │ │
253
│ │ │ │
│ │ │ │ -
255 [[nodiscard]] row_size_type table_column(zview col_name) const
│ │ │ │ +
255 [[nodiscard]] row_size_type table_column(zview col_name) const
│ │ │ │
256 {
│ │ │ │ -
257 return table_column(column_number(col_name));
│ │ │ │ +
257 return table_column(column_number(col_name));
│ │ │ │
258 }
│ │ │ │
│ │ │ │
260
│ │ │ │
262 [[nodiscard]] PQXX_PURE std::string const &query() const & noexcept;
│ │ │ │
263
│ │ │ │
265
│ │ │ │
268 [[nodiscard]] PQXX_PURE oid inserted_oid() const;
│ │ │ │ @@ -295,26 +295,26 @@ │ │ │ │
275
│ │ │ │
276 // C++20: Concept like std::invocable, but without specifying param types.
│ │ │ │
278
│ │ │ │
315 template<typename CALLABLE> inline void for_each(CALLABLE &&func) const;
│ │ │ │
316
│ │ │ │
318
│ │ │ │
│ │ │ │ -
321 result expect_rows(size_type n) const
│ │ │ │ +
321 result expect_rows(size_type n) const
│ │ │ │
322 {
│ │ │ │ -
323 auto const sz{size()};
│ │ │ │ -
324 if (sz != n)
│ │ │ │ +
323 auto const sz{size()};
│ │ │ │ +
324 if (sz != n)
│ │ │ │
325 {
│ │ │ │
326 // TODO: See whether result contains a generated statement.
│ │ │ │ -
327 if (not m_query or m_query->empty())
│ │ │ │ +
327 if (not m_query or m_query->empty())
│ │ │ │
328 throw unexpected_rows{pqxx::internal::concat(
│ │ │ │ -
329 "Expected ", n, " row(s) from query, got ", sz, ".")};
│ │ │ │ +
329 "Expected ", n, " row(s) from query, got ", sz, ".")};
│ │ │ │
330 else
│ │ │ │
331 throw unexpected_rows{pqxx::internal::concat(
│ │ │ │ -
332 "Expected ", n, " row(s) from query '", *m_query, "', got ", sz,
│ │ │ │ +
332 "Expected ", n, " row(s) from query '", *m_query, "', got ", sz,
│ │ │ │
333 ".")};
│ │ │ │
334 }
│ │ │ │
335 return *this;
│ │ │ │
336 }
│ │ │ │
│ │ │ │
337
│ │ │ │
339
│ │ │ │ @@ -329,26 +329,26 @@ │ │ │ │
355 expect_rows(0);
│ │ │ │
356 return *this;
│ │ │ │
357 }
│ │ │ │
│ │ │ │
358
│ │ │ │
360
│ │ │ │
│ │ │ │ -
363 result expect_columns(row_size_type cols) const
│ │ │ │ +
363 result expect_columns(row_size_type cols) const
│ │ │ │
364 {
│ │ │ │ -
365 auto const actual{columns()};
│ │ │ │ -
366 if (actual != cols)
│ │ │ │ +
365 auto const actual{columns()};
│ │ │ │ +
366 if (actual != cols)
│ │ │ │
367 {
│ │ │ │
368 // TODO: See whether result contains a generated statement.
│ │ │ │ -
369 if (not m_query or m_query->empty())
│ │ │ │ +
369 if (not m_query or m_query->empty())
│ │ │ │
370 throw usage_error{pqxx::internal::concat(
│ │ │ │ -
371 "Expected 1 column from query, got ", actual, ".")};
│ │ │ │ +
371 "Expected 1 column from query, got ", actual, ".")};
│ │ │ │
372 else
│ │ │ │
373 throw usage_error{pqxx::internal::concat(
│ │ │ │ -
374 "Expected 1 column from query '", *m_query, "', got ", actual, ".")};
│ │ │ │ +
374 "Expected 1 column from query '", *m_query, "', got ", actual, ".")};
│ │ │ │
375 }
│ │ │ │
376 return *this;
│ │ │ │
377 }
│ │ │ │
│ │ │ │
378
│ │ │ │
380
│ │ │ │
383 field one_field() const;
│ │ │ │ ├── html2text {} │ │ │ │ │ @@ -81,30 +81,30 @@ │ │ │ │ │ 96 using _r_e_f_e_r_e_n_c_e = _r_o_w; │ │ │ │ │ 97 using _c_o_n_s_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; │ │ │ │ │ 98 using _p_o_i_n_t_e_r = _c_o_n_s_t___i_t_e_r_a_t_o_r; │ │ │ │ │ 99 using _i_t_e_r_a_t_o_r = _c_o_n_s_t___i_t_e_r_a_t_o_r; │ │ │ │ │ 100 using _c_o_n_s_t___r_e_v_e_r_s_e___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; │ │ │ │ │ 101 using _r_e_v_e_r_s_e___i_t_e_r_a_t_o_r = _c_o_n_s_t___r_e_v_e_r_s_e___i_t_e_r_a_t_o_r; │ │ │ │ │ 102 │ │ │ │ │ -103 _r_e_s_u_l_t() _n_o_e_x_c_e_p_t : │ │ │ │ │ +103 _r_e_s_u_l_t() noexcept : │ │ │ │ │ 104 m_data{}, m_query{}, m_encoding{internal::encoding_group::MONOBYTE} │ │ │ │ │ 105 {} │ │ │ │ │ 106 │ │ │ │ │ -107 _r_e_s_u_l_t(_r_e_s_u_l_t const &_r_h_s) noexcept = default; │ │ │ │ │ -108 _r_e_s_u_l_t(_r_e_s_u_l_t &&_r_h_s) noexcept = default; │ │ │ │ │ +107 _r_e_s_u_l_t(_r_e_s_u_l_t const &rhs) noexcept = default; │ │ │ │ │ +108 _r_e_s_u_l_t(_r_e_s_u_l_t &&rhs) noexcept = default; │ │ │ │ │ 109 │ │ │ │ │ 111 │ │ │ │ │ -_1_1_4 _r_e_s_u_l_t &_o_p_e_r_a_t_o_r_=(_r_e_s_u_l_t const &_r_h_s) noexcept = default; │ │ │ │ │ +_1_1_4 _r_e_s_u_l_t &_o_p_e_r_a_t_o_r_=(_r_e_s_u_l_t const &rhs) noexcept = default; │ │ │ │ │ 115 │ │ │ │ │ -_1_1_7 _r_e_s_u_l_t &_o_p_e_r_a_t_o_r_=(_r_e_s_u_l_t &&_r_h_s) noexcept = default; │ │ │ │ │ +_1_1_7 _r_e_s_u_l_t &_o_p_e_r_a_t_o_r_=(_r_e_s_u_l_t &&rhs) noexcept = default; │ │ │ │ │ 118 │ │ │ │ │ -128 [[_n_o_d_i_s_c_a_r_d]] bool operator==(_r_e_s_u_l_t const &) const noexcept; │ │ │ │ │ -_1_3_0 [[_n_o_d_i_s_c_a_r_d]] bool _o_p_e_r_a_t_o_r_!_=(_r_e_s_u_l_t const &_r_h_s) const noexcept │ │ │ │ │ +128 [[nodiscard]] bool operator==(_r_e_s_u_l_t const &) const noexcept; │ │ │ │ │ +_1_3_0 [[nodiscard]] bool _o_p_e_r_a_t_o_r_!_=(_r_e_s_u_l_t const &rhs) const noexcept │ │ │ │ │ 131 { │ │ │ │ │ -132 return _n_o_t operator==(_r_h_s); │ │ │ │ │ +132 return not operator==(rhs); │ │ │ │ │ 133 } │ │ │ │ │ 135 │ │ │ │ │ 137 │ │ │ │ │ 143 template auto iter() const; │ │ │ │ │ 144 │ │ │ │ │ 145 [[nodiscard]] const_reverse_iterator rbegin() const; │ │ │ │ │ 146 [[nodiscard]] const_reverse_iterator crbegin() const; │ │ │ │ │ @@ -135,15 +135,15 @@ │ │ │ │ │ 179#endif // PQXX_HAVE_MULTIDIM │ │ │ │ │ 180 │ │ │ │ │ 182 row at(size_type) const; │ │ │ │ │ 183 │ │ │ │ │ 185 field at(size_type, row_size_type) const; │ │ │ │ │ 186 │ │ │ │ │ 188 │ │ │ │ │ -_1_9_5 void _c_l_e_a_r() _n_o_e_x_c_e_p_t │ │ │ │ │ +_1_9_5 void _c_l_e_a_r() noexcept │ │ │ │ │ 196 { │ │ │ │ │ 197 m_data.reset(); │ │ │ │ │ 198 m_query = nullptr; │ │ │ │ │ 199 } │ │ │ │ │ 200 │ │ │ │ │ 206 [[nodiscard]] PQXX_PURE _r_o_w___s_i_z_e___t_y_p_e columns() const noexcept; │ │ │ │ │ 207 │ │ │ │ │ @@ -156,31 +156,31 @@ │ │ │ │ │ 219 │ │ │ │ │ 221 │ │ │ │ │ 231 [[nodiscard]] int column_type_modifier(_r_o_w___s_i_z_e___t_y_p_e number) const │ │ │ │ │ noexcept; │ │ │ │ │ 232 │ │ │ │ │ 234 [[nodiscard]] _o_i_d column_type(_r_o_w___s_i_z_e___t_y_p_e col_num) const; │ │ │ │ │ 235 │ │ │ │ │ -_2_3_7 [[_n_o_d_i_s_c_a_r_d]] _o_i_d column_type(_z_v_i_e_w _c_o_l___n_a_m_e) const │ │ │ │ │ +_2_3_7 [[nodiscard]] _o_i_d column_type(_z_v_i_e_w col_name) const │ │ │ │ │ 238 { │ │ │ │ │ -239 return column_type(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +239 return column_type(column_number(col_name)); │ │ │ │ │ 240 } │ │ │ │ │ 241 │ │ │ │ │ 243 [[nodiscard]] _o_i_d column_table(_r_o_w___s_i_z_e___t_y_p_e col_num) const; │ │ │ │ │ 244 │ │ │ │ │ -_2_4_6 [[_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 │ │ │ │ │ +_2_4_6 [[nodiscard]] _o_i_d _c_o_l_u_m_n___t_a_b_l_e(_z_v_i_e_w col_name) const │ │ │ │ │ 247 { │ │ │ │ │ -248 return column_table(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +248 return column_table(column_number(col_name)); │ │ │ │ │ 249 } │ │ │ │ │ 250 │ │ │ │ │ 252 [[nodiscard]] _r_o_w___s_i_z_e___t_y_p_e table_column(_r_o_w___s_i_z_e___t_y_p_e col_num) const; │ │ │ │ │ 253 │ │ │ │ │ -_2_5_5 [[_n_o_d_i_s_c_a_r_d]] _r_o_w___s_i_z_e___t_y_p_e _t_a_b_l_e___c_o_l_u_m_n(_z_v_i_e_w _c_o_l___n_a_m_e) const │ │ │ │ │ +_2_5_5 [[nodiscard]] _r_o_w___s_i_z_e___t_y_p_e _t_a_b_l_e___c_o_l_u_m_n(_z_v_i_e_w col_name) const │ │ │ │ │ 256 { │ │ │ │ │ -257 return table_column(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +257 return table_column(column_number(col_name)); │ │ │ │ │ 258 } │ │ │ │ │ 260 │ │ │ │ │ 262 [[nodiscard]] PQXX_PURE std::string const &query() const & noexcept; │ │ │ │ │ 263 │ │ │ │ │ 265 │ │ │ │ │ 268 [[nodiscard]] PQXX_PURE _o_i_d inserted_oid() const; │ │ │ │ │ 269 │ │ │ │ │ @@ -188,26 +188,26 @@ │ │ │ │ │ 274 [[nodiscard]] PQXX_PURE size_type affected_rows() const; │ │ │ │ │ 275 │ │ │ │ │ 276 // C++20: Concept like std::invocable, but without specifying param types. │ │ │ │ │ 278 │ │ │ │ │ 315 template inline void for_each(CALLABLE &&func) const; │ │ │ │ │ 316 │ │ │ │ │ 318 │ │ │ │ │ -_3_2_1 _r_e_s_u_l_t expect_rows(size_type _n) const │ │ │ │ │ +_3_2_1 _r_e_s_u_l_t expect_rows(size_type n) const │ │ │ │ │ 322 { │ │ │ │ │ -323 auto const _s_z{size()}; │ │ │ │ │ -324 if (_s_z != _n) │ │ │ │ │ +323 auto const sz{size()}; │ │ │ │ │ +324 if (sz != n) │ │ │ │ │ 325 { │ │ │ │ │ 326 // TODO: See whether result contains a generated statement. │ │ │ │ │ -327 if (_n_o_t m_query _o_r m_query->empty()) │ │ │ │ │ +327 if (not m_query or m_query->empty()) │ │ │ │ │ 328 throw _u_n_e_x_p_e_c_t_e_d___r_o_w_s{_p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_c_o_n_c_a_t( │ │ │ │ │ -329 "Expected ", _n, " row(s) from query, got ", _s_z, ".")}; │ │ │ │ │ +329 "Expected ", n, " row(s) from query, got ", sz, ".")}; │ │ │ │ │ 330 else │ │ │ │ │ 331 throw _u_n_e_x_p_e_c_t_e_d___r_o_w_s{_p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_c_o_n_c_a_t( │ │ │ │ │ -332 "Expected ", _n, " row(s) from query '", *m_query, "', got ", _s_z, │ │ │ │ │ +332 "Expected ", n, " row(s) from query '", *m_query, "', got ", sz, │ │ │ │ │ 333 ".")}; │ │ │ │ │ 334 } │ │ │ │ │ 335 return *this; │ │ │ │ │ 336 } │ │ │ │ │ 337 │ │ │ │ │ 339 │ │ │ │ │ 342 _r_o_w one_row() const; │ │ │ │ │ @@ -218,26 +218,26 @@ │ │ │ │ │ _3_5_3 _r_e_s_u_l_t _n_o___r_o_w_s() const │ │ │ │ │ 354 { │ │ │ │ │ 355 expect_rows(0); │ │ │ │ │ 356 return *this; │ │ │ │ │ 357 } │ │ │ │ │ 358 │ │ │ │ │ 360 │ │ │ │ │ -_3_6_3 _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) const │ │ │ │ │ +_3_6_3 _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 │ │ │ │ │ 364 { │ │ │ │ │ -365 auto const _a_c_t_u_a_l{columns()}; │ │ │ │ │ -366 if (_a_c_t_u_a_l != _c_o_l_s) │ │ │ │ │ +365 auto const actual{columns()}; │ │ │ │ │ +366 if (actual != cols) │ │ │ │ │ 367 { │ │ │ │ │ 368 // TODO: See whether result contains a generated statement. │ │ │ │ │ -369 if (_n_o_t m_query _o_r m_query->empty()) │ │ │ │ │ +369 if (not m_query or m_query->empty()) │ │ │ │ │ 370 throw _u_s_a_g_e___e_r_r_o_r{_p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_c_o_n_c_a_t( │ │ │ │ │ -371 "Expected 1 column from query, got ", _a_c_t_u_a_l, ".")}; │ │ │ │ │ +371 "Expected 1 column from query, got ", actual, ".")}; │ │ │ │ │ 372 else │ │ │ │ │ 373 throw _u_s_a_g_e___e_r_r_o_r{_p_q_x_x_:_:_i_n_t_e_r_n_a_l_:_:_c_o_n_c_a_t( │ │ │ │ │ -374 "Expected 1 column from query '", *m_query, "', got ", _a_c_t_u_a_l, ".")}; │ │ │ │ │ +374 "Expected 1 column from query '", *m_query, "', got ", actual, ".")}; │ │ │ │ │ 375 } │ │ │ │ │ 376 return *this; │ │ │ │ │ 377 } │ │ │ │ │ 378 │ │ │ │ │ 380 │ │ │ │ │ 383 _f_i_e_l_d one_field() const; │ │ │ │ │ 384 │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/result__iter_8hxx_source.html │ │ │ │ @@ -186,44 +186,43 @@ │ │ │ │
91 pqxx::result const m_home;
│ │ │ │
92};
│ │ │ │
│ │ │ │
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,43 +85,40 @@ │ │ │ │ │ 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<_T_Y_P_E...>{*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{*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(_C_A_L_L_A_B_L_E &&_f_u_n_c) const │ │ │ │ │ +_1_0_3inline void _p_q_x_x_:_:_r_e_s_u_l_t_:_:_f_o_r___e_a_c_h(CALLABLE &&func) const │ │ │ │ │ 104{ │ │ │ │ │ -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}; │ │ │ │ │ +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}; │ │ │ │ │ 107 static_assert( │ │ │ │ │ -108 _s_z > 0, │ │ │ │ │ +108 sz > 0, │ │ │ │ │ 109 "Callback for for_each must take parameters, one for each column in the " │ │ │ │ │ 110 "result."); │ │ │ │ │ 111 │ │ │ │ │ -112 auto const _c_o_l_s{this->columns()}; │ │ │ │ │ -113 if (_s_z != _c_o_l_s) │ │ │ │ │ +112 auto const cols{this->columns()}; │ │ │ │ │ +113 if (sz != cols) │ │ │ │ │ 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 ", _s_z, "parameter", (_s_z == 1) ? "" : "s", │ │ │ │ │ -116 ", but result set has ", _c_o_l_s, "field", (_c_o_l_s == 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 _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>()); │ │ │ │ │ +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()); │ │ │ │ │ 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,15 +431,14 @@ │ │ │ │
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 _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 *; │ │ │ │ │ +37 using value_type = _r_o_w const; │ │ │ │ │ +38 using pointer = _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() _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; │ │ │ │ │ +_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; │ │ │ │ │ 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 _c_o_n_s_t &_t) _n_o_e_x_c_e_p_t : _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 const &t) noexcept : _r_o_w{t} {} │ │ │ │ │ 53#include "pqxx/internal/ignore-deprecated-post.hxx" │ │ │ │ │ 54 │ │ │ │ │ -_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; } │ │ │ │ │ +_7_0 [[nodiscard]] pointer _o_p_e_r_a_t_o_r_-_>() const { return this; } │ │ │ │ │ 71 │ │ │ │ │ 72#include "pqxx/internal/ignore-deprecated-pre.hxx" │ │ │ │ │ -_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; } │ │ │ │ │ +_7_4 [[nodiscard]] _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 &_o_t_h_e_r) 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 &other) noexcept │ │ │ │ │ 136 { │ │ │ │ │ 137#include "pqxx/internal/ignore-deprecated-pre.hxx" │ │ │ │ │ -138 row::swap(_o_t_h_e_r); │ │ │ │ │ +138 row::swap(other); │ │ │ │ │ 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 [[_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) │ │ │ │ │ +_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) │ │ │ │ │ const; │ │ │ │ │ -181 [[_n_o_d_i_s_c_a_r_d]] inline difference_type │ │ │ │ │ +181 [[nodiscard]] 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) _n_o_e_x_c_e_p_t : │ │ │ │ │ -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) noexcept : │ │ │ │ │ +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 _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; │ │ │ │ │ +202 using iterator_type::pointer; │ │ │ │ │ +203 using value_type = iterator_type::value_type; │ │ │ │ │ 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 &_r_h_s) = │ │ │ │ │ +_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) = │ │ │ │ │ 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 &_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} │ │ │ │ │ +_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} │ │ │ │ │ 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 &&_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)} │ │ │ │ │ +_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)} │ │ │ │ │ 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,17 +355,14 @@ │ │ │ │ │ _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 [[_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 │ │ │ │ │ +70 [[nodiscard]] PQXX_PURE bool operator==(_r_o_w const &) const noexcept; │ │ │ │ │ +71 [[nodiscard]] bool operator!=(_r_o_w const &rhs) const noexcept │ │ │ │ │ 72 { │ │ │ │ │ -73 return _n_o_t operator==(_r_h_s); │ │ │ │ │ +73 return not operator==(rhs); │ │ │ │ │ 74 } │ │ │ │ │ 76 │ │ │ │ │ -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; │ │ │ │ │ +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; │ │ │ │ │ 81 │ │ │ │ │ -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; │ │ │ │ │ +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; │ │ │ │ │ 88 │ │ │ │ │ -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; │ │ │ │ │ +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; │ │ │ │ │ 93 │ │ │ │ │ -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; │ │ │ │ │ +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; │ │ │ │ │ 99 │ │ │ │ │ -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; │ │ │ │ │ +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; │ │ │ │ │ 105 │ │ │ │ │ -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 │ │ │ │ │ +106 [[nodiscard]] constexpr size_type size() const noexcept │ │ │ │ │ 107 { │ │ │ │ │ 108 return m_end - m_begin; │ │ │ │ │ 109 } │ │ │ │ │ 110 │ │ │ │ │ -_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 │ │ │ │ │ +_1_1_2 [[nodiscard]] constexpr result::size_type _r_o_w_n_u_m_b_e_r() const noexcept │ │ │ │ │ 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 [[_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 │ │ │ │ │ +_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 │ │ │ │ │ 129 { │ │ │ │ │ -130 return column_type(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +130 return column_type(column_number(col_name)); │ │ │ │ │ 131 } │ │ │ │ │ 132 │ │ │ │ │ 134 [[nodiscard]] _o_i_d column_table(size_type col_num) const; │ │ │ │ │ 135 │ │ │ │ │ -_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 │ │ │ │ │ +_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 │ │ │ │ │ 138 { │ │ │ │ │ -139 return column_table(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +139 return column_table(column_number(col_name)); │ │ │ │ │ 140 } │ │ │ │ │ 141 │ │ │ │ │ 143 │ │ │ │ │ 150 [[nodiscard]] size_type table_column(size_type) const; │ │ │ │ │ 151 │ │ │ │ │ -_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 │ │ │ │ │ +_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 │ │ │ │ │ 154 { │ │ │ │ │ -155 return table_column(column_number(_c_o_l___n_a_m_e)); │ │ │ │ │ +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 │ │ │ │ │ -_1_7_3 template void _t_o(_T_u_p_l_e &_t) const │ │ │ │ │ +_1_7_3 template void _t_o(Tuple &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<_T_Y_P_E...> _a_s() const │ │ │ │ │ +_1_8_8 template std::tuple _a_s() const │ │ │ │ │ 189 { │ │ │ │ │ -190 check_size(sizeof...(_T_Y_P_E)); │ │ │ │ │ -191 using _s_e_q = std::make_index_sequence; │ │ │ │ │ -192 return get_tuple>(_s_e_q{}); │ │ │ │ │ +190 check_size(sizeof...(TYPE)); │ │ │ │ │ +191 using seq = std::make_index_sequence; │ │ │ │ │ +192 return get_tuple>(seq{}); │ │ │ │ │ 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 _e_x_p_e_c_t_e_d) const │ │ │ │ │ +_2_2_1 void check_size(size_type expected) const │ │ │ │ │ 222 { │ │ │ │ │ -223 if (size() != _e_x_p_e_c_t_e_d) │ │ │ │ │ +223 if (size() != expected) │ │ │ │ │ 224 throw _u_s_a_g_e___e_r_r_o_r{internal::concat( │ │ │ │ │ -225 "Tried to extract ", _e_x_p_e_c_t_e_d, " field(s) from a row of ", size(), │ │ │ │ │ +225 "Tried to extract ", expected, " field(s) from a row of ", size(), │ │ │ │ │ 226 ".")}; │ │ │ │ │ 227 } │ │ │ │ │ 228 │ │ │ │ │ 230 │ │ │ │ │ -_2_3_3 template _T_U_P_L_E _a_s___t_u_p_l_e() const │ │ │ │ │ +_2_3_3 template TUPLE _a_s___t_u_p_l_e() const │ │ │ │ │ 234 { │ │ │ │ │ -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{}); │ │ │ │ │ +235 using seq = std::make_index_sequence>; │ │ │ │ │ +236 return get_tuple(seq{}); │ │ │ │ │ 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(_T_u_p_l_e &_t) const │ │ │ │ │ +_2_4_1 template void _c_o_n_v_e_r_t(Tuple &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(_T_u_p_l_e &_t, std::index_sequence) const │ │ │ │ │ +265 template │ │ │ │ │ +266 void extract_fields(Tuple &t, std::index_sequence) const │ │ │ │ │ 267 { │ │ │ │ │ -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), ...); │ │ │ │ │ +268 (extract_value(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_md18', 1, '']]], │ │ │ │ │ - ['a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md6', 1, '']]], │ │ │ │ │ - ['a_20special_20prepared_20statement_2', ['A special prepared statement', ['../prepared.html#autotoc_md11', 1, '']]], │ │ │ │ │ - ['a_20statement_3', ['Preparing a statement', ['../prepared.html#autotoc_md9', 1, '']]], │ │ │ │ │ - ['a_20table_20em_4', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['a_20special_20prepared_20statement_2', ['A special prepared statement', ['../prepared.html#autotoc_md10', 1, '']]], │ │ │ │ │ + ['a_20statement_3', ['Preparing a statement', ['../prepared.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['a_20table_20em_4', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 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_md13', 1, 'Zero bytes'] │ │ │ │ │ + ['../prepared.html#autotoc_md12', 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 {} │ │ │ │ │ @@ -21,16 +21,16 @@ │ │ │ │ │ ['register_5ftransaction_11', ['register_transaction', ['../group__transactions.html#aae93291a592dc93c7a569f922a8a10e0', 1, 'pqxx::transaction_base']]], │ │ │ │ │ ['release_5fraw_5fconnection_12', ['release_raw_connection', ['../classpqxx_1_1connection.html#a84ca9d29d5d2cb1d35fde324a7b3fc71', 1, 'pqxx::connection']]], │ │ │ │ │ ['remove_13', ['remove', ['../classpqxx_1_1blob.html#a04dba3c567afabaf21474a487ee16ed3', 1, 'pqxx::blob::remove()'], │ │ │ │ │ ['../classpqxx_1_1largeobject.html#a12f426d5cd7f173de01551fa1629ddf4', 1, 'pqxx::largeobject::remove()'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#a12f426d5cd7f173de01551fa1629ddf4', 1, 'pqxx::largeobjectaccess::remove()'] │ │ │ │ │ ]], │ │ │ │ │ ['render_5fitem_14', ['render_item', ['../namespacepqxx_1_1internal.html#aad2e696d48b72821c43c7ee968fac155', 1, 'pqxx::internal']]], │ │ │ │ │ - ['reserve_15', ['reserve', ['../classpqxx_1_1params.html#af736445f5bb035a646ed84f8843c91e4', 1, 'pqxx::params::reserve()'], │ │ │ │ │ - ['../structpqxx_1_1internal_1_1c__params.html#aa0700df147dee1b1a38c37c43f268ba3', 1, 'pqxx::internal::c_params::reserve()'] │ │ │ │ │ + ['reserve_15', ['reserve', ['../structpqxx_1_1internal_1_1c__params.html#aa0700df147dee1b1a38c37c43f268ba3', 1, 'pqxx::internal::c_params::reserve()'], │ │ │ │ │ + ['../classpqxx_1_1params.html#af736445f5bb035a646ed84f8843c91e4', 1, 'pqxx::params::reserve()'] │ │ │ │ │ ]], │ │ │ │ │ ['resize_16', ['resize', ['../classpqxx_1_1blob.html#a2066f1b112029d66c2a7880592a199e2', 1, 'pqxx::blob']]], │ │ │ │ │ ['restrict_5fviolation_17', ['restrict_violation', ['../group__exception.html#structpqxx_1_1restrict__violation', 1, 'pqxx']]], │ │ │ │ │ ['result_18', ['result', ['../classpqxx_1_1result.html', 1, 'pqxx']]], │ │ │ │ │ ['result_20rows_19', ['Accessing results and result rows', ['../accessing-results.html', 1, '']]], │ │ │ │ │ ['result_5fconnection_20', ['result_connection', ['../classpqxx_1_1internal_1_1gate_1_1result__connection.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['result_5fcreation_21', ['result_creation', ['../classpqxx_1_1internal_1_1gate_1_1result__creation.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ @@ -39,31 +39,31 @@ │ │ │ │ │ ['../classpqxx_1_1internal_1_1result__iter.html#a0c920149f5043b7d03b7ac765447a929', 1, 'pqxx::internal::result_iter::result_iter()'] │ │ │ │ │ ]], │ │ │ │ │ ['result_5fiteration_24', ['result_iteration', ['../classpqxx_1_1internal_1_1result__iteration.html', 1, 'pqxx::internal']]], │ │ │ │ │ ['result_5fpipeline_25', ['result_pipeline', ['../classpqxx_1_1internal_1_1gate_1_1result__pipeline.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['result_5fsize_5ftype_26', ['result_size_type', ['../namespacepqxx.html#a937d9f67d0bc04774b85efa58736852b', 1, 'pqxx']]], │ │ │ │ │ ['result_5fsql_5fcursor_27', ['result_sql_cursor', ['../classpqxx_1_1internal_1_1gate_1_1result__sql__cursor.html', 1, 'pqxx::internal::gate']]], │ │ │ │ │ ['results_20and_20result_20rows_28', ['Accessing results and result rows', ['../accessing-results.html', 1, '']]], │ │ │ │ │ - ['results_20with_20metadata_29', ['Results with metadata', ['../accessing-results.html#autotoc_md16', 1, '']]], │ │ │ │ │ + ['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_md7', 1, '']]], │ │ │ │ │ - ['row_34', ['row', ['../classpqxx_1_1row.html', 1, 'pqxx::row'], │ │ │ │ │ - ['../classpqxx_1_1row.html#a5bd8864f453d45f83984ed858fb68880', 1, 'pqxx::row::row()'] │ │ │ │ │ + ['right_20for_20my_20query_33', ['Is streaming right for my query?', ['../streams.html#autotoc_md15', 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']]], │ │ │ │ │ ['rownumber_39', ['rownumber', ['../classpqxx_1_1const__reverse__result__iterator.html#aadd30c2141060d954c16301e3711a02c', 1, 'pqxx::const_reverse_result_iterator::rownumber()'], │ │ │ │ │ ['../classpqxx_1_1const__result__iterator.html#aadd30c2141060d954c16301e3711a02c', 1, 'pqxx::const_result_iterator::rownumber()'], │ │ │ │ │ ['../classpqxx_1_1row.html#aadd30c2141060d954c16301e3711a02c', 1, 'pqxx::row::rownumber()'] │ │ │ │ │ ]], │ │ │ │ │ ['rows_40', ['rows', ['../accessing-results.html', 1, 'Accessing results and result rows'], │ │ │ │ │ - ['../accessing-results.html#autotoc_md15', 1, 'Streaming rows'] │ │ │ │ │ + ['../accessing-results.html#autotoc_md1', 1, 'Streaming rows'] │ │ │ │ │ ]], │ │ │ │ │ - ['rows_20of_20data_41', ['Querying rows of data', ['../accessing-results.html#autotoc_md14', 1, '']]] │ │ │ │ │ + ['rows_20of_20data_41', ['Querying rows of data', ['../accessing-results.html#autotoc_md0', 1, '']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_11.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -44,37 +44,37 @@ │ │ │ │ │ ['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()'] │ │ │ │ │ ]], │ │ │ │ │ - ['special_20prepared_20statement_32', ['A special prepared statement', ['../prepared.html#autotoc_md11', 1, '']]], │ │ │ │ │ + ['special_20prepared_20statement_32', ['A special prepared statement', ['../prepared.html#autotoc_md10', 1, '']]], │ │ │ │ │ ['specialise_20tt_20is_5funquoted_5fsafe_20tt_33', ['Optional: Specialise <tt>is_unquoted_safe</tt>', ['../datatypes.html#autotoc_md27', 1, '']]], │ │ │ │ │ ['specialise_20tt_20nullness_20tt_34', ['Specialise <tt>nullness</tt>', ['../datatypes.html#autotoc_md21', 1, '']]], │ │ │ │ │ ['specialise_20tt_20param_5fformat_20tt_35', ['Optional: Specialise <tt>param_format</tt>', ['../datatypes.html#autotoc_md28', 1, '']]], │ │ │ │ │ ['specialise_20tt_20string_5ftraits_20tt_36', ['Specialise <tt>string_traits</tt>', ['../datatypes.html#autotoc_md22', 1, '']]], │ │ │ │ │ ['specialise_20tt_20type_5fname_20tt_37', ['Specialise <tt>type_name</tt>', ['../datatypes.html#autotoc_md20', 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_md1', 1, '']]], │ │ │ │ │ + ['sql_20injection_39', ['SQL injection', ['../escaping.html#autotoc_md4', 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()'], │ │ │ │ │ ['../classpqxx_1_1array.html#a707b514df7835fa198a29ae68897efd8', 1, 'pqxx::array::ssize()'], │ │ │ │ │ ['../classpqxx_1_1params.html#ab23b2a3b2a58bfd03fca36022ebce8b4', 1, 'pqxx::params::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#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_md11', 1, 'A special prepared statement'], │ │ │ │ │ - ['../prepared.html#autotoc_md9', 1, 'Preparing a statement'] │ │ │ │ │ + ['statement_47', ['statement', ['../prepared.html#autotoc_md10', 1, 'A special prepared statement'], │ │ │ │ │ + ['../prepared.html#autotoc_md8', 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) &'] │ │ │ │ │ @@ -99,18 +99,18 @@ │ │ │ │ │ ]], │ │ │ │ │ ['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_md6', 1, '']]], │ │ │ │ │ - ['streaming_20data_20em_20into_20a_20table_20em_61', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md8', 1, '']]], │ │ │ │ │ - ['streaming_20right_20for_20my_20query_62', ['Is streaming right for my query?', ['../streams.html#autotoc_md7', 1, '']]], │ │ │ │ │ - ['streaming_20rows_63', ['Streaming rows', ['../accessing-results.html#autotoc_md15', 1, '']]], │ │ │ │ │ + ['streaming_20data_20em_20from_20a_20query_20em_60', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['streaming_20data_20em_20into_20a_20table_20em_61', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 1, '']]], │ │ │ │ │ + ['streaming_20right_20for_20my_20query_62', ['Is streaming right for my query?', ['../streams.html#autotoc_md15', 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_md22', 1, '']]], │ │ │ │ │ ['string_5ftraits_3c_20binarystring_20_3e_70', ['string_traits< binarystring >', ['../structpqxx_1_1string__traits_3_01binarystring_01_4.html', 1, 'pqxx']]], │ │ │ │ │ @@ -150,17 +150,17 @@ │ │ │ │ │ ['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(subtransaction &t, std::string_view name=""sv)'], │ │ │ │ │ - ['../group__transactions.html#abec3848ca61ae755fab531e791ce89d8', 1, 'pqxx::subtransaction::subtransaction(dbtransaction &t, std::string_view tname=""sv)'], │ │ │ │ │ - ['../group__transactions.html#classpqxx_1_1subtransaction', 1, 'pqxx::subtransaction'] │ │ │ │ │ + ['subtransaction_111', ['subtransaction', ['../group__transactions.html#classpqxx_1_1subtransaction', 1, 'pqxx::subtransaction'], │ │ │ │ │ + ['../group__transactions.html#aa351325206ada1be7f3db4fa69145c4d', 1, 'pqxx::subtransaction::subtransaction(subtransaction &t, std::string_view name=""sv)'], │ │ │ │ │ + ['../group__transactions.html#abec3848ca61ae755fab531e791ce89d8', 1, 'pqxx::subtransaction::subtransaction(dbtransaction &t, std::string_view tname=""sv)'] │ │ │ │ │ ]], │ │ │ │ │ ['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_md18', 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()'] │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_12.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,24 +1,24 @@ │ │ │ │ │ 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_md8', 1, '']]], │ │ │ │ │ + ['table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 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_md2', 1, '']]], │ │ │ │ │ + ['the_20esc_20functions_5', ['Using the esc functions', ['../escaping.html#autotoc_md5', 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'], │ │ │ ├── ./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_md2', 1, '']]], │ │ │ │ │ + ['using_20the_20esc_20functions_14', ['Using the esc functions', ['../escaping.html#autotoc_md5', 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_md5', 1, 'Interlude: null values'], │ │ │ │ │ + ['values_2', ['values', ['../streams.html#autotoc_md13', 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_15.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ ['wait_5ffd_0', ['wait_fd', ['../namespacepqxx_1_1internal.html#ae8a3cb88d2e0bc1f1125bee862fe100b', 1, 'pqxx::internal']]], │ │ │ │ │ ['wait_5ffor_1', ['wait_for', ['../namespacepqxx_1_1internal.html#ae95ba6e41e051ca26d13855aa2b512cb', 1, 'pqxx::internal']]], │ │ │ │ │ ['wait_5fto_5fread_2', ['wait_to_read', ['../classpqxx_1_1connecting.html#aa60ab98dc5a2702929765f05229bf160', 1, 'pqxx::connecting']]], │ │ │ │ │ ['wait_5fto_5fwrite_3', ['wait_to_write', ['../classpqxx_1_1connecting.html#a4b39dd46b61ea3e39242213bd4245eb0', 1, 'pqxx::connecting']]], │ │ │ │ │ - ['with_20metadata_4', ['Results with metadata', ['../accessing-results.html#autotoc_md16', 1, '']]], │ │ │ │ │ + ['with_20metadata_4', ['Results with metadata', ['../accessing-results.html#autotoc_md2', 1, '']]], │ │ │ │ │ ['write_5', ['write', ['../classpqxx_1_1blob.html#a28ff055c22102e0d1bda250d20d265e8', 1, 'pqxx::blob::write()'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#a60ff3072349074e732d0c00e2aefc498', 1, 'pqxx::largeobjectaccess::write(char const buf[], std::size_t len)'], │ │ │ │ │ ['../classpqxx_1_1largeobjectaccess.html#addc309fe11d4d3e29547b149e4600199', 1, 'pqxx::largeobjectaccess::write(std::string_view buf)'] │ │ │ │ │ ]], │ │ │ │ │ ['write_5fpolicy_6', ['write_policy', ['../namespacepqxx.html#a3a8103e375bc507b6e9df93e24121912', 1, 'pqxx']]], │ │ │ │ │ ['write_5frow_7', ['write_row', ['../classpqxx_1_1stream__to.html#ae628c71679b4ec6ebb4378b487e4f543', 1, 'pqxx::stream_to']]], │ │ │ │ │ ['write_5fvalues_8', ['write_values', ['../classpqxx_1_1stream__to.html#a41ffa59e4f36803f1e9473ed83b3c41d', 1, 'pqxx::stream_to']]] │ │ │ ├── ./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_md13', 1, '']]], │ │ │ │ │ + ['zero_20bytes_0', ['Zero bytes', ['../prepared.html#autotoc_md12', 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 {} │ │ │ │ │ @@ -14,15 +14,15 @@ │ │ │ │ │ ['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, '']]], │ │ │ │ │ ['cat2_14', ['cat2', ['../namespacepqxx_1_1internal.html#ae3d8bb14c1d7c63c57c59b61cf63ff09', 1, 'pqxx::internal']]], │ │ │ │ │ - ['caveats_15', ['Caveats', ['../binary.html#autotoc_md0', 1, '']]], │ │ │ │ │ + ['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'] │ │ │ │ │ ]], │ │ │ │ │ ['char_5ffinder_5ffunc_19', ['char_finder_func', ['../namespacepqxx_1_1internal.html#a93267405e140acb909fe17d58746f113', 1, 'pqxx::internal']]], │ │ │ │ │ ['check_5fcast_20', ['check_cast', ['../namespacepqxx.html#af61c9b8bf784c48b540deb2fe1c1f90c', 1, 'pqxx']]], │ │ │ ├── ./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_md14', 1, 'Querying rows of 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_md6', 1, '']]], │ │ │ │ │ - ['data_20em_20into_20a_20table_20em_2', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['data_20em_20from_20a_20query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['data_20em_20into_20a_20table_20em_2', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 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,10 +1,10 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['em_20from_20a_20query_20em_0', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md6', 1, '']]], │ │ │ │ │ - ['em_20into_20a_20table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md8', 1, '']]], │ │ │ │ │ + ['em_20from_20a_20query_20em_0', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['em_20into_20a_20table_20em_1', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 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)'] │ │ │ │ │ ]], │ │ │ │ │ @@ -30,15 +30,15 @@ │ │ │ │ │ ]], │ │ │ │ │ ['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_md2', 1, '']]], │ │ │ │ │ + ['esc_20functions_20', ['Using the esc functions', ['../escaping.html#autotoc_md5', 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()'], │ │ │ ├── ./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_md7', 1, '']]], │ │ │ │ │ + ['for_20my_20query_15', ['Is streaming right for my query?', ['../streams.html#autotoc_md15', 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,15 +33,15 @@ │ │ │ │ │ ['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_md6', 1, '']]], │ │ │ │ │ + ['from_20a_20query_20em_30', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 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()'], │ │ │ │ │ @@ -54,11 +54,11 @@ │ │ │ │ │ ]], │ │ │ │ │ ['from_5fstring_20tt_36', ['<tt>from_string</tt>', ['../datatypes.html#autotoc_md23', 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_md2', 1, 'Using the esc functions'], │ │ │ │ │ + ['../escaping.html#autotoc_md5', 1, 'Using the esc functions'], │ │ │ │ │ ['../group__utility.html', 1, 'Utility functions'] │ │ │ │ │ ]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_6.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,9 +1,9 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['generating_20placeholders_0', ['Generating placeholders', ['../parameters.html#autotoc_md4', 1, '']]], │ │ │ │ │ + ['generating_20placeholders_0', ['Generating placeholders', ['../parameters.html#autotoc_md7', 1, '']]], │ │ │ │ │ ['generic_5finto_5fbuf_1', ['generic_into_buf', ['../namespacepqxx_1_1internal.html#ad36377dfe85994d97cb1aaa942100b6b', 1, 'pqxx::internal']]], │ │ │ │ │ ['get_2', ['get', ['../classpqxx_1_1placeholders.html#a4bdc5f0c544e544a62af6d2fc2309c58', 1, 'pqxx::placeholders::get()'], │ │ │ │ │ ['../classpqxx_1_1field.html#adb7ec4ecef586ebbab147b5b181dfff3', 1, 'pqxx::field::get()'], │ │ │ │ │ ['../group__escaping-functions.html#a22a65469db21930a72c82178f37b568a', 1, 'pqxx::binarystring::get()'] │ │ │ │ │ ]], │ │ │ │ │ ['get_5fchar_5ffinder_3', ['get_char_finder', ['../namespacepqxx_1_1internal.html#a16e6f54fdf88d18355e1a3a570fa175f', 1, 'pqxx::internal']]], │ │ │ │ │ ['get_5fclient_5fencoding_4', ['get_client_encoding', ['../classpqxx_1_1connection.html#a777daa7f80f3e55df9ee50e236f74653', 1, 'pqxx::connection']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_8.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -3,38 +3,38 @@ │ │ │ │ │ ['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_md1', 1, '']]], │ │ │ │ │ + ['injection_6', ['SQL injection', ['../escaping.html#autotoc_md4', 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_md5', 1, '']]], │ │ │ │ │ + ['interlude_3a_20null_20values_21', ['Interlude: null values', ['../streams.html#autotoc_md13', 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_md8', 1, '']]], │ │ │ │ │ + ['into_20a_20table_20em_23', ['Streaming data <em>into a table</em>', ['../streams.html#autotoc_md16', 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_md25', 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_md7', 1, '']]], │ │ │ │ │ + ['is_20streaming_20right_20for_20my_20query_29', ['Is streaming right for my query?', ['../streams.html#autotoc_md15', 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()'], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_b.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -4,11 +4,11 @@ │ │ │ │ │ ['m_5fend_2', ['m_end', ['../classpqxx_1_1row.html#a0ec7d11b9721ab7bb54ec5df113ab8f5', 1, 'pqxx::row']]], │ │ │ │ │ ['m_5findex_3', ['m_index', ['../classpqxx_1_1row.html#a859f508b95f424531247427189a529ef', 1, 'pqxx::row']]], │ │ │ │ │ ['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_md16', 1, '']]], │ │ │ │ │ - ['multiple_20parameters_10', ['Multiple parameters', ['../parameters.html#autotoc_md3', 1, '']]], │ │ │ │ │ - ['my_20query_11', ['Is streaming right for my query?', ['../streams.html#autotoc_md7', 1, '']]] │ │ │ │ │ + ['metadata_9', ['Results with metadata', ['../accessing-results.html#autotoc_md2', 1, '']]], │ │ │ │ │ + ['multiple_20parameters_10', ['Multiple parameters', ['../parameters.html#autotoc_md6', 1, '']]], │ │ │ │ │ + ['my_20query_11', ['Is streaming right for my query?', ['../streams.html#autotoc_md15', 1, '']]] │ │ │ │ │ ]; │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_c.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -27,29 +27,29 @@ │ │ │ │ │ ['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()'] │ │ │ │ │ ]], │ │ │ │ │ ['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_md12', 1, '']]], │ │ │ │ │ + ['note_23', ['Performance note', ['../prepared.html#autotoc_md11', 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', 1, 'pqxx::notification_receiver'], │ │ │ │ │ ['../classpqxx_1_1notification__receiver.html#a4779f6b712bf7a1d5ab3253b8d274db9', 1, 'pqxx::notification_receiver::notification_receiver(connection &cx, std::string_view channel)'], │ │ │ │ │ ['../classpqxx_1_1notification__receiver.html#a44ffe1ed8ec8020f4106ef8427e09d17', 1, 'pqxx::notification_receiver::notification_receiver(notification_receiver const &)=delete'] │ │ │ │ │ ]], │ │ │ │ │ ['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_3_01std_1_1variant_3_01T_8_8_8_01_4_01_4.html#a62b23c197cb393e146d9720ed4aed004', 1, 'pqxx::nullness< std::variant< T... > >::null()'], │ │ │ │ │ ['../structpqxx_1_1nullness.html#a475f5e490aabd4934aa63a621ecfd0ab', 1, 'pqxx::nullness::null()'] │ │ │ │ │ ]], │ │ │ │ │ - ['null_20values_32', ['Interlude: null values', ['../streams.html#autotoc_md5', 1, '']]], │ │ │ │ │ + ['null_20values_32', ['Interlude: null values', ['../streams.html#autotoc_md13', 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_md21', 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']]], │ │ │ ├── ./usr/share/doc/libpqxx-doc/doxygen-html/search/all_d.js │ │ │ │ ├── js-beautify {} │ │ │ │ │ @@ -1,9 +1,9 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['of_20data_0', ['Querying rows of data', ['../accessing-results.html#autotoc_md14', 1, '']]], │ │ │ │ │ + ['of_20data_0', ['Querying rows of data', ['../accessing-results.html#autotoc_md0', 1, '']]], │ │ │ │ │ ['oid_1', ['oid', ['../namespacepqxx.html#ac9eb697318d27a5b023609e0160f1ade', 1, 'pqxx']]], │ │ │ │ │ ['oid_5fnone_2', ['oid_none', ['../namespacepqxx.html#aea8d8e21558dad5b03ac2f73910c93e1', 1, 'pqxx']]], │ │ │ │ │ ['one_5ffield_3', ['one_field', ['../classpqxx_1_1result.html#a2caa168a1984a277b29d70ccbbdf50c4', 1, 'pqxx::result']]], │ │ │ │ │ ['one_5frow_4', ['one_row', ['../classpqxx_1_1result.html#a0c06b4a276d79960cfdbbfb1be070b48', 1, 'pqxx::result']]], │ │ │ │ │ ['oops_5fforbidden_5fconversion_5', ['oops_forbidden_conversion', ['../namespacepqxx.html#a807bfd03b5fb6cf1bbcd9d728f2dd4e0', 1, 'pqxx']]], │ │ │ │ │ ['open_5fr_6', ['open_r', ['../classpqxx_1_1blob.html#a0d4a50c0d8862f98ce728647987f6d51', 1, 'pqxx::blob']]], │ │ │ │ │ ['openmode_7', ['openmode', ['../classpqxx_1_1largeobjectaccess.html#a6b09598014eca3c4c4b8a0c1495185d3', 1, 'pqxx::largeobjectaccess']]], │ │ │ ├── ./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_md28', 1, '']]], │ │ │ │ │ - ['parameters_2', ['parameters', ['../parameters.html#autotoc_md3', 1, 'Multiple parameters'], │ │ │ │ │ - ['../prepared.html#autotoc_md10', 1, 'Parameters'], │ │ │ │ │ + ['parameters_2', ['parameters', ['../parameters.html#autotoc_md6', 1, 'Multiple parameters'], │ │ │ │ │ + ['../prepared.html#autotoc_md9', 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,20 +18,20 @@ │ │ │ │ │ ['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_md12', 1, '']]], │ │ │ │ │ + ['performance_20note_12', ['Performance note', ['../prepared.html#autotoc_md11', 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_md4', 1, 'Generating placeholders'], │ │ │ │ │ + ['placeholders_14', ['placeholders', ['../parameters.html#autotoc_md7', 1, 'Generating placeholders'], │ │ │ │ │ ['../classpqxx_1_1placeholders.html', 1, 'pqxx::placeholders< COUNTER >'] │ │ │ │ │ ]], │ │ │ │ │ ['plpgsql_5ferror_15', ['plpgsql_error', ['../group__exception.html#structpqxx_1_1plpgsql__error', 1, 'pqxx']]], │ │ │ │ │ ['plpgsql_5fno_5fdata_5ffound_16', ['plpgsql_no_data_found', ['../group__exception.html#structpqxx_1_1plpgsql__no__data__found', 1, 'pqxx']]], │ │ │ │ │ ['plpgsql_5fraise_17', ['plpgsql_raise', ['../group__exception.html#structpqxx_1_1plpgsql__raise', 1, 'pqxx']]], │ │ │ │ │ ['plpgsql_5ftoo_5fmany_5frows_18', ['plpgsql_too_many_rows', ['../group__exception.html#structpqxx_1_1plpgsql__too__many__rows', 1, 'pqxx']]], │ │ │ │ │ ['port_19', ['port', ['../classpqxx_1_1connection.html#aa517b7352ea7d8aed937281c295d1f8d', 1, 'pqxx::connection']]], │ │ │ │ │ @@ -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_md11', 1, '']]], │ │ │ │ │ + ['prepared_20statement_27', ['A special prepared statement', ['../prepared.html#autotoc_md10', 1, '']]], │ │ │ │ │ ['prepared_20statements_28', ['Prepared statements', ['../prepared.html', 1, '']]], │ │ │ │ │ - ['preparing_20a_20statement_29', ['Preparing a statement', ['../prepared.html#autotoc_md9', 1, '']]], │ │ │ │ │ + ['preparing_20a_20statement_29', ['Preparing a statement', ['../prepared.html#autotoc_md8', 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,39 +1,39 @@ │ │ │ │ │ var searchData = [ │ │ │ │ │ - ['query_0', ['query', ['../streams.html#autotoc_md7', 1, 'Is streaming right for my query?'], │ │ │ │ │ + ['query_0', ['query', ['../streams.html#autotoc_md15', 1, 'Is streaming right for my query?'], │ │ │ │ │ ['../group__exception.html#af011efdf2ba4459774e1e146a50c398d', 1, 'pqxx::sql_error::query()'], │ │ │ │ │ - ['../classpqxx_1_1result.html#a9d28f84628b9e8a8fecf7849f31bf1a0', 1, 'pqxx::result::query()'], │ │ │ │ │ - ['../classpqxx_1_1stream__from.html#a062c20b73f6c9d019bfc35806c432ec0', 1, 'pqxx::stream_from::query()'], │ │ │ │ │ - ['../group__transactions.html#a2b8b6bcc152f542e8cbe8e227db2ef62', 1, 'pqxx::transaction_base::query(zview 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)'], │ │ │ │ │ - ['../group__transactions.html#a41080a9f7c8cbf27a888c3cbf3e9c974', 1, 'pqxx::transaction_base::query(prepped statement, 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_md6', 1, '']]], │ │ │ │ │ - ['query01_2', ['query01', ['../group__transactions.html#a40ddd8e96d1dbd58b8e1355d24de5898', 1, 'pqxx::transaction_base::query01(zview query, params const &parms)'], │ │ │ │ │ - ['../group__transactions.html#aa5929c0f9068f6569c246063a6428c99', 1, 'pqxx::transaction_base::query01(zview query)'] │ │ │ │ │ + ['query_20em_1', ['Streaming data <em>from a query</em>', ['../streams.html#autotoc_md14', 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']]], │ │ │ │ │ - ['query_5fn_5', ['query_n', ['../group__transactions.html#a3ddff300844031c184bceea4cf55c9dd', 1, 'pqxx::transaction_base::query_n(result::size_type rows, zview query)'], │ │ │ │ │ - ['../group__transactions.html#acfde62bb97de6c6112624acc7880b0e2', 1, 'pqxx::transaction_base::query_n(result::size_type rows, zview query, params const &parms)'] │ │ │ │ │ + ['query_5fn_5', ['query_n', ['../group__transactions.html#acfde62bb97de6c6112624acc7880b0e2', 1, 'pqxx::transaction_base::query_n(result::size_type rows, zview query, params const &parms)'], │ │ │ │ │ + ['../group__transactions.html#a3ddff300844031c184bceea4cf55c9dd', 1, 'pqxx::transaction_base::query_n(result::size_type rows, zview query)'] │ │ │ │ │ ]], │ │ │ │ │ - ['query_5fvalue_6', ['query_value', ['../group__transactions.html#a3cd56db0a41e5a08649b3f86e3c3e738', 1, 'pqxx::transaction_base::query_value(prepped statement, params const &parms={})'], │ │ │ │ │ - ['../group__transactions.html#a9088693e2337da4d75f8f624ac4fb9bc', 1, 'pqxx::transaction_base::query_value(zview query, std::string_view desc)=delete'], │ │ │ │ │ + ['query_5fvalue_6', ['query_value', ['../group__transactions.html#a4a7e907112201a77641d775fcbe49153', 1, 'pqxx::transaction_base::query_value(zview query, std::string_view desc)'], │ │ │ │ │ + ['../group__transactions.html#a7167da8b1ac61caa7e2caa0a9b0244c8', 1, 'pqxx::transaction_base::query_value(zview query)'], │ │ │ │ │ ['../group__transactions.html#a2f2f530ab83df00027ad7b09716b3bac', 1, 'pqxx::transaction_base::query_value(zview query, params const &parms)'], │ │ │ │ │ - ['../group__transactions.html#a4a7e907112201a77641d775fcbe49153', 1, 'pqxx::transaction_base::query_value(zview query, std::string_view desc)'], │ │ │ │ │ - ['../group__transactions.html#a7167da8b1ac61caa7e2caa0a9b0244c8', 1, 'pqxx::transaction_base::query_value(zview query)'] │ │ │ │ │ + ['../group__transactions.html#a3cd56db0a41e5a08649b3f86e3c3e738', 1, 'pqxx::transaction_base::query_value(prepped statement, params const &parms={})'], │ │ │ │ │ + ['../group__transactions.html#a9088693e2337da4d75f8f624ac4fb9bc', 1, 'pqxx::transaction_base::query_value(zview query, std::string_view desc)=delete'] │ │ │ │ │ ]], │ │ │ │ │ - ['querying_20rows_20of_20data_7', ['Querying rows of data', ['../accessing-results.html#autotoc_md14', 1, '']]], │ │ │ │ │ - ['quiet_5ferrorhandler_8', ['quiet_errorhandler', ['../classpqxx_1_1quiet__errorhandler.html#ac89d9cb68e28649ed53ec9d00ad75550', 1, 'pqxx::quiet_errorhandler::quiet_errorhandler()'], │ │ │ │ │ - ['../classpqxx_1_1quiet__errorhandler.html', 1, 'pqxx::quiet_errorhandler'] │ │ │ │ │ + ['querying_20rows_20of_20data_7', ['Querying rows of data', ['../accessing-results.html#autotoc_md0', 1, '']]], │ │ │ │ │ + ['quiet_5ferrorhandler_8', ['quiet_errorhandler', ['../classpqxx_1_1quiet__errorhandler.html', 1, 'pqxx::quiet_errorhandler'], │ │ │ │ │ + ['../classpqxx_1_1quiet__errorhandler.html#ac89d9cb68e28649ed53ec9d00ad75550', 1, 'pqxx::quiet_errorhandler::quiet_errorhandler()'] │ │ │ │ │ ]], │ │ │ │ │ - ['quote_9', ['quote', ['../classpqxx_1_1connection.html#aa8dd0b5e748b96a2c82152b8001bdc69', 1, 'pqxx::connection::quote()'], │ │ │ │ │ - ['../group__transactions.html#a6476b6d27bb27a6eb8767080cc3e6a49', 1, 'pqxx::transaction_base::quote()'], │ │ │ │ │ + ['quote_9', ['quote', ['../group__transactions.html#a6476b6d27bb27a6eb8767080cc3e6a49', 1, 'pqxx::transaction_base::quote()'], │ │ │ │ │ + ['../classpqxx_1_1connection.html#aa8dd0b5e748b96a2c82152b8001bdc69', 1, 'pqxx::connection::quote(bytes_view bytes) const'], │ │ │ │ │ ['../classpqxx_1_1connection.html#ae871e3c436af0ed50e1373d9157e7340', 1, 'pqxx::connection::quote(T const &t) const'] │ │ │ │ │ ]], │ │ │ │ │ ['quote_5fcolumns_10', ['quote_columns', ['../classpqxx_1_1connection.html#a6f0d42562cf2e37c1673738bf330b2b7', 1, 'pqxx::connection']]], │ │ │ │ │ ['quote_5fname_11', ['quote_name', ['../classpqxx_1_1connection.html#a98f0397793e45b0ea2d9fa4e7a454167', 1, 'pqxx::connection::quote_name()'], │ │ │ │ │ ['../group__transactions.html#ade6d268d6b59cd8684be5d127746d99f', 1, 'pqxx::transaction_base::quote_name()'] │ │ │ │ │ ]], │ │ │ │ │ ['quote_5fraw_12', ['quote_raw', ['../classpqxx_1_1connection.html#a276b3fe0ae9d3cc8e5a04f5e9b2bf1cf', 1, 'pqxx::connection::quote_raw(bytes_view) const'], │ │ │ ├── ./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"}};