003 File Manager
Current Path:
/usr/src/contrib/llvm-project/llvm/include/llvm/Support
usr
/
src
/
contrib
/
llvm-project
/
llvm
/
include
/
llvm
/
Support
/
📁
..
📄
AArch64TargetParser.def
(12.01 KB)
📄
AArch64TargetParser.h
(4.89 KB)
📄
AMDGPUMetadata.h
(17.98 KB)
📄
AMDHSAKernelDescriptor.h
(7.63 KB)
📄
ARMAttributeParser.h
(3.2 KB)
📄
ARMBuildAttributes.h
(8.6 KB)
📄
ARMEHABI.h
(3.72 KB)
📄
ARMTargetParser.def
(18.94 KB)
📄
ARMTargetParser.h
(8.76 KB)
📄
ARMWinEH.h
(18.27 KB)
📄
AlignOf.h
(1.56 KB)
📄
Alignment.h
(12.95 KB)
📄
Allocator.h
(16.54 KB)
📄
AllocatorBase.h
(3.87 KB)
📄
ArrayRecycler.h
(4.78 KB)
📄
Atomic.h
(1.09 KB)
📄
AtomicOrdering.h
(6.01 KB)
📄
Automaton.h
(9.64 KB)
📄
Base64.h
(1.84 KB)
📄
BinaryByteStream.h
(9.14 KB)
📄
BinaryItemStream.h
(3.63 KB)
📄
BinaryStream.h
(3.75 KB)
📄
BinaryStreamArray.h
(12.46 KB)
📄
BinaryStreamError.h
(1.29 KB)
📄
BinaryStreamReader.h
(11.01 KB)
📄
BinaryStreamRef.h
(10.09 KB)
📄
BinaryStreamWriter.h
(7.79 KB)
📄
BlockFrequency.h
(2.41 KB)
📄
BranchProbability.h
(7.92 KB)
📄
BuryPointer.h
(1.03 KB)
📄
CBindingWrapping.h
(1.86 KB)
📄
CFGDiff.h
(9.95 KB)
📄
CFGUpdate.h
(4.12 KB)
📄
COM.h
(1004 B)
📄
CRC.h
(1.63 KB)
📄
CachePruning.h
(3.5 KB)
📄
Capacity.h
(972 B)
📄
Casting.h
(13.92 KB)
📄
CheckedArithmetic.h
(3.71 KB)
📄
Chrono.h
(5.78 KB)
📄
CodeGen.h
(1.96 KB)
📄
CodeGenCoverage.h
(1.18 KB)
📄
CommandLine.h
(71.22 KB)
📄
Compiler.h
(19.5 KB)
📄
Compression.h
(1.39 KB)
📄
ConvertUTF.h
(11.4 KB)
📄
CrashRecoveryContext.h
(9.26 KB)
📄
DJB.h
(1.05 KB)
📄
DOTGraphTraits.h
(5.58 KB)
📄
DataExtractor.h
(30.28 KB)
📄
DataTypes.h
(775 B)
📄
Debug.h
(4.7 KB)
📄
DebugCounter.h
(7.01 KB)
📄
DynamicLibrary.h
(5.77 KB)
📄
ELFAttributeParser.h
(2.22 KB)
📄
ELFAttributes.h
(1.02 KB)
📄
Endian.h
(14.28 KB)
📄
EndianStream.h
(1.93 KB)
📄
Errc.h
(3.8 KB)
📄
Errno.h
(1.45 KB)
📄
Error.h
(43.82 KB)
📄
ErrorHandling.h
(6.39 KB)
📄
ErrorOr.h
(7.48 KB)
📄
ExtensibleRTTI.h
(4.02 KB)
📄
FileCheck.h
(6.69 KB)
📄
FileCollector.h
(3.74 KB)
📄
FileOutputBuffer.h
(3.36 KB)
📄
FileSystem.h
(53.03 KB)
📄
FileUtilities.h
(3.83 KB)
📄
Format.h
(9.45 KB)
📄
FormatAdapters.h
(3.38 KB)
📄
FormatCommon.h
(2.05 KB)
📄
FormatProviders.h
(15.27 KB)
📄
FormatVariadic.h
(9.88 KB)
📄
FormatVariadicDetails.h
(5.3 KB)
📄
FormattedStream.h
(6.42 KB)
📄
GenericDomTree.h
(30.89 KB)
📄
GenericDomTreeConstruction.h
(63.42 KB)
📄
GenericIteratedDominanceFrontier.h
(7.31 KB)
📄
GlobPattern.h
(1.35 KB)
📄
GraphWriter.h
(11.79 KB)
📄
Host.h
(2.68 KB)
📄
InitLLVM.h
(1.79 KB)
📄
ItaniumManglingCanonicalizer.h
(3.17 KB)
📄
JSON.h
(28.25 KB)
📄
KnownBits.h
(8.35 KB)
📄
LEB128.h
(5.74 KB)
📄
LineIterator.h
(2.62 KB)
📄
Locale.h
(223 B)
📄
LockFileManager.h
(3.13 KB)
📄
LowLevelTypeImpl.h
(11.94 KB)
📄
MD5.h
(3.39 KB)
📄
MSVCErrorWorkarounds.h
(2.62 KB)
📄
MachineValueType.h
(42.37 KB)
📄
ManagedStatic.h
(4.21 KB)
📄
MathExtras.h
(32.81 KB)
📄
MemAlloc.h
(3.21 KB)
📄
Memory.h
(6.94 KB)
📄
MemoryBuffer.h
(10.98 KB)
📄
MipsABIFlags.h
(3.92 KB)
📄
Mutex.h
(2.14 KB)
📄
NativeFormatting.h
(1.64 KB)
📄
OnDiskHashTable.h
(21.97 KB)
📄
OptimizedStructLayout.h
(5.89 KB)
📄
Parallel.h
(5.99 KB)
📄
Path.h
(15.6 KB)
📄
PluginLoader.h
(1.29 KB)
📄
PointerLikeTypeTraits.h
(5.69 KB)
📄
PrettyStackTrace.h
(4.45 KB)
📄
Printable.h
(1.5 KB)
📄
Process.h
(9.31 KB)
📄
Program.h
(10.35 KB)
📄
RISCVAttributeParser.h
(1.15 KB)
📄
RISCVAttributes.h
(1.2 KB)
📄
RISCVTargetParser.def
(446 B)
📄
RWMutex.h
(5.65 KB)
📄
RandomNumberGenerator.h
(2.29 KB)
📄
Recycler.h
(3.47 KB)
📄
RecyclingAllocator.h
(2.38 KB)
📄
Regex.h
(4.37 KB)
📄
Registry.h
(5.14 KB)
📄
ReverseIteration.h
(360 B)
📄
SHA1.h
(2.37 KB)
📄
SMLoc.h
(1.78 KB)
📄
SMTAPI.h
(16.33 KB)
📄
SaveAndRestore.h
(1.02 KB)
📄
ScaledNumber.h
(30.65 KB)
📄
ScopedPrinter.h
(11.39 KB)
📄
Signals.h
(5.22 KB)
📄
Signposts.h
(1.29 KB)
📄
SmallVectorMemoryBuffer.h
(2.28 KB)
📁
Solaris
📄
SourceMgr.h
(10.37 KB)
📄
SpecialCaseList.h
(6.01 KB)
📄
StringSaver.h
(1.94 KB)
📄
SuffixTree.h
(13.15 KB)
📄
SwapByteOrder.h
(4.8 KB)
📄
SymbolRemappingReader.h
(4.36 KB)
📄
SystemUtils.h
(1.02 KB)
📄
TarWriter.h
(941 B)
📄
TargetOpcodes.def
(22.01 KB)
📄
TargetParser.h
(4.08 KB)
📄
TargetRegistry.h
(46.87 KB)
📄
TargetSelect.h
(6.2 KB)
📄
TaskQueue.h
(4.24 KB)
📄
ThreadLocal.h
(2.08 KB)
📄
ThreadPool.h
(3.44 KB)
📄
Threading.h
(10.62 KB)
📄
TimeProfiler.h
(3.46 KB)
📄
Timer.h
(8.93 KB)
📄
ToolOutputFile.h
(2.24 KB)
📄
TrailingObjects.h
(15.19 KB)
📄
TrigramIndex.h
(2.84 KB)
📄
TypeName.h
(2.13 KB)
📄
TypeSize.h
(8.53 KB)
📄
Unicode.h
(2.5 KB)
📄
UnicodeCharRanges.h
(3.27 KB)
📄
Valgrind.h
(1.16 KB)
📄
VersionTuple.h
(5.22 KB)
📄
VirtualFileSystem.h
(28.28 KB)
📄
Watchdog.h
(1.15 KB)
📄
Win64EH.h
(4.82 KB)
📁
Windows
📄
WindowsError.h
(541 B)
📄
WithColor.h
(4.64 KB)
📄
X86DisassemblerDecoderCommon.h
(29.39 KB)
📄
X86TargetParser.def
(8.21 KB)
📄
X86TargetParser.h
(3.57 KB)
📄
YAMLParser.h
(16.29 KB)
📄
YAMLTraits.h
(67.62 KB)
📄
circular_raw_ostream.h
(4.97 KB)
📄
raw_os_ostream.h
(1.29 KB)
📄
raw_ostream.h
(20.82 KB)
📄
raw_sha1_ostream.h
(1.29 KB)
📄
thread.h
(1.33 KB)
📄
type_traits.h
(6.75 KB)
📄
xxhash.h
(1.92 KB)
Editing: BinaryStreamReader.h
//===- BinaryStreamReader.h - Reads objects from a binary stream *- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// #ifndef LLVM_SUPPORT_BINARYSTREAMREADER_H #define LLVM_SUPPORT_BINARYSTREAMREADER_H #include "llvm/ADT/ArrayRef.h" #include "llvm/ADT/STLExtras.h" #include "llvm/Support/Alignment.h" #include "llvm/Support/BinaryStreamArray.h" #include "llvm/Support/BinaryStreamRef.h" #include "llvm/Support/ConvertUTF.h" #include "llvm/Support/Endian.h" #include "llvm/Support/Error.h" #include "llvm/Support/type_traits.h" #include <string> #include <type_traits> namespace llvm { /// Provides read only access to a subclass of `BinaryStream`. Provides /// bounds checking and helpers for writing certain common data types such as /// null-terminated strings, integers in various flavors of endianness, etc. /// Can be subclassed to provide reading of custom datatypes, although no /// are overridable. class BinaryStreamReader { public: BinaryStreamReader() = default; explicit BinaryStreamReader(BinaryStreamRef Ref); explicit BinaryStreamReader(BinaryStream &Stream); explicit BinaryStreamReader(ArrayRef<uint8_t> Data, llvm::support::endianness Endian); explicit BinaryStreamReader(StringRef Data, llvm::support::endianness Endian); BinaryStreamReader(const BinaryStreamReader &Other) : Stream(Other.Stream), Offset(Other.Offset) {} BinaryStreamReader &operator=(const BinaryStreamReader &Other) { Stream = Other.Stream; Offset = Other.Offset; return *this; } virtual ~BinaryStreamReader() {} /// Read as much as possible from the underlying string at the current offset /// without invoking a copy, and set \p Buffer to the resulting data slice. /// Updates the stream's offset to point after the newly read data. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readLongestContiguousChunk(ArrayRef<uint8_t> &Buffer); /// Read \p Size bytes from the underlying stream at the current offset and /// and set \p Buffer to the resulting data slice. Whether a copy occurs /// depends on the implementation of the underlying stream. Updates the /// stream's offset to point after the newly read data. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readBytes(ArrayRef<uint8_t> &Buffer, uint32_t Size); /// Read an integer of the specified endianness into \p Dest and update the /// stream's offset. The data is always copied from the stream's underlying /// buffer into \p Dest. Updates the stream's offset to point after the newly /// read data. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. template <typename T> Error readInteger(T &Dest) { static_assert(std::is_integral<T>::value, "Cannot call readInteger with non-integral value!"); ArrayRef<uint8_t> Bytes; if (auto EC = readBytes(Bytes, sizeof(T))) return EC; Dest = llvm::support::endian::read<T, llvm::support::unaligned>( Bytes.data(), Stream.getEndian()); return Error::success(); } /// Similar to readInteger. template <typename T> Error readEnum(T &Dest) { static_assert(std::is_enum<T>::value, "Cannot call readEnum with non-enum value!"); std::underlying_type_t<T> N; if (auto EC = readInteger(N)) return EC; Dest = static_cast<T>(N); return Error::success(); } /// Read an unsigned LEB128 encoded value. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readULEB128(uint64_t &Dest); /// Read a signed LEB128 encoded value. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readSLEB128(int64_t &Dest); /// Read a null terminated string from \p Dest. Whether a copy occurs depends /// on the implementation of the underlying stream. Updates the stream's /// offset to point after the newly read data. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readCString(StringRef &Dest); /// Similar to readCString, however read a null-terminated UTF16 string /// instead. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readWideString(ArrayRef<UTF16> &Dest); /// Read a \p Length byte string into \p Dest. Whether a copy occurs depends /// on the implementation of the underlying stream. Updates the stream's /// offset to point after the newly read data. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readFixedString(StringRef &Dest, uint32_t Length); /// Read the entire remainder of the underlying stream into \p Ref. This is /// equivalent to calling getUnderlyingStream().slice(Offset). Updates the /// stream's offset to point to the end of the stream. Never causes a copy. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readStreamRef(BinaryStreamRef &Ref); /// Read \p Length bytes from the underlying stream into \p Ref. This is /// equivalent to calling getUnderlyingStream().slice(Offset, Length). /// Updates the stream's offset to point after the newly read object. Never /// causes a copy. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readStreamRef(BinaryStreamRef &Ref, uint32_t Length); /// Read \p Length bytes from the underlying stream into \p Ref. This is /// equivalent to calling getUnderlyingStream().slice(Offset, Length). /// Updates the stream's offset to point after the newly read object. Never /// causes a copy. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. Error readSubstream(BinarySubstreamRef &Ref, uint32_t Length); /// Get a pointer to an object of type T from the underlying stream, as if by /// memcpy, and store the result into \p Dest. It is up to the caller to /// ensure that objects of type T can be safely treated in this manner. /// Updates the stream's offset to point after the newly read object. Whether /// a copy occurs depends upon the implementation of the underlying /// stream. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. template <typename T> Error readObject(const T *&Dest) { ArrayRef<uint8_t> Buffer; if (auto EC = readBytes(Buffer, sizeof(T))) return EC; Dest = reinterpret_cast<const T *>(Buffer.data()); return Error::success(); } /// Get a reference to a \p NumElements element array of objects of type T /// from the underlying stream as if by memcpy, and store the resulting array /// slice into \p array. It is up to the caller to ensure that objects of /// type T can be safely treated in this manner. Updates the stream's offset /// to point after the newly read object. Whether a copy occurs depends upon /// the implementation of the underlying stream. /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. template <typename T> Error readArray(ArrayRef<T> &Array, uint32_t NumElements) { ArrayRef<uint8_t> Bytes; if (NumElements == 0) { Array = ArrayRef<T>(); return Error::success(); } if (NumElements > UINT32_MAX / sizeof(T)) return make_error<BinaryStreamError>( stream_error_code::invalid_array_size); if (auto EC = readBytes(Bytes, NumElements * sizeof(T))) return EC; assert(isAddrAligned(Align::Of<T>(), Bytes.data()) && "Reading at invalid alignment!"); Array = ArrayRef<T>(reinterpret_cast<const T *>(Bytes.data()), NumElements); return Error::success(); } /// Read a VarStreamArray of size \p Size bytes and store the result into /// \p Array. Updates the stream's offset to point after the newly read /// array. Never causes a copy (although iterating the elements of the /// VarStreamArray may, depending upon the implementation of the underlying /// stream). /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. template <typename T, typename U> Error readArray(VarStreamArray<T, U> &Array, uint32_t Size, uint32_t Skew = 0) { BinaryStreamRef S; if (auto EC = readStreamRef(S, Size)) return EC; Array.setUnderlyingStream(S, Skew); return Error::success(); } /// Read a FixedStreamArray of \p NumItems elements and store the result into /// \p Array. Updates the stream's offset to point after the newly read /// array. Never causes a copy (although iterating the elements of the /// FixedStreamArray may, depending upon the implementation of the underlying /// stream). /// /// \returns a success error code if the data was successfully read, otherwise /// returns an appropriate error code. template <typename T> Error readArray(FixedStreamArray<T> &Array, uint32_t NumItems) { if (NumItems == 0) { Array = FixedStreamArray<T>(); return Error::success(); } if (NumItems > UINT32_MAX / sizeof(T)) return make_error<BinaryStreamError>( stream_error_code::invalid_array_size); BinaryStreamRef View; if (auto EC = readStreamRef(View, NumItems * sizeof(T))) return EC; Array = FixedStreamArray<T>(View); return Error::success(); } bool empty() const { return bytesRemaining() == 0; } void setOffset(uint32_t Off) { Offset = Off; } uint32_t getOffset() const { return Offset; } uint32_t getLength() const { return Stream.getLength(); } uint32_t bytesRemaining() const { return getLength() - getOffset(); } /// Advance the stream's offset by \p Amount bytes. /// /// \returns a success error code if at least \p Amount bytes remain in the /// stream, otherwise returns an appropriate error code. Error skip(uint32_t Amount); /// Examine the next byte of the underlying stream without advancing the /// stream's offset. If the stream is empty the behavior is undefined. /// /// \returns the next byte in the stream. uint8_t peek() const; Error padToAlignment(uint32_t Align); std::pair<BinaryStreamReader, BinaryStreamReader> split(uint32_t Offset) const; private: BinaryStreamRef Stream; uint32_t Offset = 0; }; } // namespace llvm #endif // LLVM_SUPPORT_BINARYSTREAMREADER_H
Upload File
Create Folder