//!< copies a file from the "source" location to the "destination".
/*!< the outcomes could be from this class or from common::outcomes.
the "copy_chunk_factor" is the read buffer size to use while copying. */
static basis::outcome write_file_chunk(const basis::astring &target, double byte_start,
const basis::byte_array &chunk, bool truncate = true,
//!< copies a file from the "source" location to the "destination".
/*!< the outcomes could be from this class or from common::outcomes.
the "copy_chunk_factor" is the read buffer size to use while copying. */
static basis::outcome write_file_chunk(const basis::astring &target, double byte_start,
const basis::byte_array &chunk, bool truncate = true,