fuchsia.io/File.WriteAt — fuchsia

`fuchsia.io/File.WriteAt`

METHOD fuchsia.io sdk/fidl/fuchsia.io/file.fidl:151

Writes data at the provided offset. Does not affect the seek offset. The file size may grow if `offset` plus `data.length` is past the current end of file. + request `data` the byte buffer to write to the file. + request `offset` the offset from start of the file to begin writing. - response `actual_count` the number of bytes written. ## Invariants * The returned `actual_count` will never be greater than `data.length`. * If the server is unable to write all the data due to e.g. not enough space, `actual_count` may be less than `data.length`. If no bytes could be written, an error is returned. * If `data.length` is zero, the server should perform all the checks ensuring write access without mutating the file, and will return a successful write of zero bytes. This method requires the [`Rights.WRITE_BYTES`] right.

Relationships

ACCEPTS_TYPE → fuchsia.io/data
method param
ACCEPTS_TYPE → fuchsia.io/Transfer
method param
ACCEPTS_TYPE → fuchsia.io/offset
method param
RETURNS_TYPE → fuchsia.io/actual_count
method result

Documentation (1)

SUBSTANTIVE sdk/fidl/fuchsia.io/file.fidl:151 ↗ 139 words
docs.reference.fidldoc · adapter: fidl

Tests (0)

No test references.

Examples (0)

No example references.

Gaps

Missing categories:

examples
tests

Findings (2)

WARNING DOCUMENTED_UNTESTED element is documented but has no test references
analyzer: documented-untested
WARNING MISSING_IN_CATEGORY no references in category "tests.unit_tests"
analyzer: missing-in-category

← back to elements