xref: /aosp_15_r20/art/libartbase/base/unix_file/README (revision 795d594fd825385562da6b089ea9b2033f3abf5a)
1*795d594fSAndroid Build Coastguard WorkerA simple C++ wrapper for Unix file I/O.
2*795d594fSAndroid Build Coastguard Worker
3*795d594fSAndroid Build Coastguard WorkerThis is intended to be lightweight and easy to use, similar to Java's
4*795d594fSAndroid Build Coastguard WorkerRandomAccessFile and related classes. The usual C++ idioms of RAII and "you
5*795d594fSAndroid Build Coastguard Workerdon't pay for what you don't use" apply.
6*795d594fSAndroid Build Coastguard Worker
7*795d594fSAndroid Build Coastguard WorkerIn particular, the basic RandomAccessFile interface is kept small and simple so
8*795d594fSAndroid Build Coastguard Workerit's trivial to add new implementations.
9*795d594fSAndroid Build Coastguard Worker
10*795d594fSAndroid Build Coastguard WorkerThis code will not log, because it can't know whether that's appropriate in
11*795d594fSAndroid Build Coastguard Workeryour application.
12*795d594fSAndroid Build Coastguard Worker
13*795d594fSAndroid Build Coastguard WorkerThis code will, in general, return -errno on failure. If an operation consisted
14*795d594fSAndroid Build Coastguard Workerof multiple sub-operations, it will return the errno corresponding to the most
15*795d594fSAndroid Build Coastguard Workerrelevant operation.
16