mirror/soci
1
0
Fork 0
mirror of https://github.com/SOCI/soci.git synced 2026-05-07 20:30:04 -05:00
Code Issues Packages Projects Releases Wiki Activity

Make it more clear that output vectors must have non-zero size

Browse Source 
Also mention that they need to be re-resized inside the loop every time
before using them.

Closes #1160.
This commit is contained in:
Vadim Zeitlin
2025-01-29 04:19:07 +01:00
parent 59efaf8e84
commit fdc551f283
1 changed files with 1 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/binding.md
+1 -2
View File
@@ -144,8 +144,7 @@ v.resize(100);
sql << "select ...", into(v);
```
In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept and after executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted.
That is, the vector will be automatically shrunk if the amount of data that was available was smaller than requested.
In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept, and so must be non-zero and, usually, relatively big for optimal performance. After executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted, i.e. the vector will be automatically shrunk if the amount of data that was available was smaller than requested. Note that this means that when performing a bulk operation in a loop, the vector needs to be resized during each loop iteration.
It is also possible to operate on the chosen sub-range of the vector: