When using formatted I/O operations (typically operator<<(std::istream&...) this option controls the size of the in-memory buffer kept before a chunk is uploaded. Note that GCS only accepts chunks in multiples of 256KiB, so this option is always rounded up to the next such multiple.
Applications seeking optimal performance for downloads should avoid formatted I/O, and prefer using std::istream::write(). This option has no effect in that case.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-22 UTC."],[[["This webpage documents different versions of the `UploadBufferSizeOption` for Google Cloud Storage in C++."],["The latest release candidate version available is 2.37.0-rc, with the currently listed stable version starting at 2.36.0 and up to 2.11.0."],["`UploadBufferSizeOption` controls the size of the in-memory buffer used for formatted I/O operations during uploads, with the caveat that the buffer size is always rounded up to the nearest multiple of 256KiB."],["The `UploadBufferSizeOption` is irrelevant when using unformatted `std::istream::write()` for downloads."],["The type alias of the `UploadBufferSizeOption` is `std::size_t`."]]],[]]
