An interface for accessing data in a stream-like format, but which discourages copying. More...
#include "llvm/Support/BinaryStream.h"
Public Member Functions | |
| virtual | ~BinaryStream ()=default |
| virtual llvm::endianness | getEndian () const =0 |
| virtual Error | readBytes (uint64_t Offset, uint64_t Size, ArrayRef< uint8_t > &Buffer)=0 |
| Given an offset into the stream and a number of bytes, attempt to read the bytes and set the output ArrayRef to point to data owned by the stream. | |
| virtual Error | readLongestContiguousChunk (uint64_t Offset, ArrayRef< uint8_t > &Buffer)=0 |
| Given an offset into the stream, read as much as possible without copying any data. | |
| virtual uint64_t | getLength ()=0 |
| Return the number of bytes of data in this stream. | |
| virtual BinaryStreamFlags | getFlags () const |
| Return the properties of this stream. | |
Protected Member Functions | |
| Error | checkOffsetForRead (uint64_t Offset, uint64_t DataSize) |
Detailed Description
An interface for accessing data in a stream-like format, but which discourages copying.
Instead of specifying a buffer in which to copy data on a read, the API returns an ArrayRef to data owned by the stream's implementation. Since implementations may not necessarily store data in a single contiguous buffer (or even in memory at all), in such cases a it may be necessary for an implementation to cache such a buffer so that it can return it.
Definition at line 34 of file BinaryStream.h.
Constructor & Destructor Documentation
◆ ~BinaryStream()
|
virtualdefault |
Member Function Documentation
◆ checkOffsetForRead()
Definition at line 58 of file BinaryStream.h.
References getLength(), llvm::invalid_offset, llvm::Offset, llvm::stream_too_short, and llvm::Error::success().
Referenced by llvm::WritableBinaryStream::checkOffsetForWrite(), llvm::msf::MappedBlockStream::readBytes(), llvm::BinaryByteStream::readBytes(), llvm::BinaryItemStream< T, Traits >::readBytes(), llvm::msf::MappedBlockStream::readLongestContiguousChunk(), and llvm::BinaryByteStream::readLongestContiguousChunk().
◆ getEndian()
|
pure virtual |
◆ getFlags()
|
inlinevirtual |
Return the properties of this stream.
Reimplemented in llvm::AppendingBinaryByteStream, and llvm::WritableBinaryStream.
Definition at line 55 of file BinaryStream.h.
References llvm::BSF_None.
◆ getLength()
|
pure virtual |
Return the number of bytes of data in this stream.
Implemented in llvm::msf::MappedBlockStream, llvm::msf::WritableMappedBlockStream, llvm::BinaryByteStream, llvm::MutableBinaryByteStream, llvm::AppendingBinaryByteStream, llvm::FileBufferByteStream, and llvm::BinaryItemStream< T, Traits >.
Referenced by checkOffsetForRead(), and llvm::WritableBinaryStream::checkOffsetForWrite().
◆ readBytes()
|
pure virtual |
Given an offset into the stream and a number of bytes, attempt to read the bytes and set the output ArrayRef to point to data owned by the stream.
Implemented in llvm::msf::MappedBlockStream, llvm::msf::WritableMappedBlockStream, llvm::BinaryByteStream, llvm::MutableBinaryByteStream, llvm::AppendingBinaryByteStream, llvm::FileBufferByteStream, and llvm::BinaryItemStream< T, Traits >.
Referenced by llvm::BinaryStreamRef::readBytes().
◆ readLongestContiguousChunk()
|
pure virtual |
Given an offset into the stream, read as much as possible without copying any data.
Implemented in llvm::msf::MappedBlockStream, llvm::msf::WritableMappedBlockStream, llvm::BinaryByteStream, llvm::MutableBinaryByteStream, llvm::AppendingBinaryByteStream, llvm::FileBufferByteStream, and llvm::BinaryItemStream< T, Traits >.
Referenced by llvm::BinaryStreamRef::readLongestContiguousChunk().
The documentation for this class was generated from the following file:
- include/llvm/Support/BinaryStream.h
