fuchsia.io/File.ReadAt
METHOD
fuchsia.io
sdk/fidl/fuchsia.io/file.fidl:122
Reads up to 'count' bytes at the provided offset.
Does not affect the seek offset.
## Invariants
* The returned `data.length` will never be greater than `count`.
* If `data.length` is less than `count`, it means that `ReadAt` has hit
the end of file as part of this operation.
* If `data.length` is zero while `count` is not, it means that `offset`
is at or past the end of file, and no data can be read.
* If `count` is zero, the server should perform all the checks ensuring
read access without actually reading anything, and return an empty
`data` vector.
This method requires the [`Rights.READ_BYTES`] right.
Returns `ZX_ERR_OUT_OF_RANGE` if `count` is greater than `MAX_TRANSFER_SIZE`.
Relationships
-
ACCEPTS_TYPE→fuchsia.io/count -
ACCEPTS_TYPE→fuchsia.io/offset -
RETURNS_TYPE→fuchsia.io/data -
RETURNS_TYPE→fuchsia.io/Transfer
Documentation (1)
-
SUBSTANTIVE
sdk/fidl/fuchsia.io/file.fidl:122↗
Tests (0)
No test references.
Examples (0)
No example references.
Gaps
Missing categories:
- examples
- tests
Findings (2)
-
WARNING
DOCUMENTED_UNTESTEDelement is documented but has no test references -
WARNING
MISSING_IN_CATEGORYno references in category "tests.unit_tests"