llvm::yaml::BinaryRef Class Reference

Specialized YAMLIO scalar type for representing a binary blob. More...

#include <YAML.h>

List of all members.

Public Member Functions
	BinaryRef (ArrayRef< uint8_t > Data)
	BinaryRef (StringRef Data)
	BinaryRef ()
ArrayRef< uint8_t >::size_type	binary_size () const
	The number of bytes that are represented by this BinaryRef. This is the number of bytes that writeAsBinary() will write.
void	writeAsBinary (raw_ostream &OS) const
	Write the contents (regardless of whether it is binary or a hex string) as binary to the given raw_ostream.
void	writeAsHex (raw_ostream &OS) const
	Write the contents (regardless of whether it is binary or a hex string) as hex to the given raw_ostream.
Friends
bool	operator== (const BinaryRef &LHS, const BinaryRef &RHS)

---

Detailed Description

Specialized YAMLIO scalar type for representing a binary blob.

A typical use case would be to represent the content of a section in a binary file. This class has custom YAMLIO traits for convenient reading and writing. It renders as a string of hex digits in a YAML file. For example, it might render as `DEADBEEFCAFEBABE` (YAML does not require the quotation marks, so for simplicity when outputting they are omitted). When reading, any string whose content is an even number of hex digits will be accepted. For example, all of the following are acceptable: `DEADBEEF`, `"DeADbEeF"`, `"\x44EADBEEF"` (Note: '' == 'D')

A significant advantage of using this class is that it never allocates temporary strings or buffers for any of its functionality.

Example:

The YAML mapping:

 Foo: DEADBEEFCAFEBABE

Could be modeled in YAMLIO by the struct:

 struct FooHolder {
   BinaryRef Foo;
 };
 namespace llvm {
 namespace yaml {
 template <>
 struct MappingTraits<FooHolder> {
   static void mapping(IO &IO, FooHolder &FH) {
     IO.mapRequired("Foo", FH.Foo);
   }
 };
 } // end namespace yaml
 } // end namespace llvm

Definition at line 48 of file YAML.h.

---

Constructor & Destructor Documentation

llvm::yaml::BinaryRef::BinaryRef

(

ArrayRef< uint8_t >

Data

)

[inline]

Definition at line 57 of file YAML.h.

llvm::yaml::BinaryRef::BinaryRef

(

StringRef

Data

)

[inline]

Definition at line 58 of file YAML.h.

llvm::yaml::BinaryRef::BinaryRef

(

)

[inline]

Definition at line 61 of file YAML.h.

---

Member Function Documentation

ArrayRef<uint8_t>::size_type llvm::yaml::BinaryRef::binary_size

(

)

const [inline]

The number of bytes that are represented by this BinaryRef. This is the number of bytes that writeAsBinary() will write.

Definition at line 64 of file YAML.h.

References llvm::ArrayRef< T >::size().

Referenced by llvm::yaml::sectionMapping().

void yaml::BinaryRef::writeAsBinary

(

raw_ostream &

OS

)

const

Write the contents (regardless of whether it is binary or a hex string) as binary to the given raw_ostream.

Definition at line 40 of file YAML.cpp.

References llvm::ArrayRef< T >::data(), llvm::StringRef::getAsInteger(), I, N, llvm::ArrayRef< T >::size(), and llvm::raw_ostream::write().

void yaml::BinaryRef::writeAsHex

(

raw_ostream &

OS

)

const

Write the contents (regardless of whether it is binary or a hex string) as hex to the given raw_ostream.

For example, a possible output could be `DEADBEEFCAFEBABE`.

Definition at line 52 of file YAML.cpp.

References llvm::hexdigit(), I, and llvm::raw_ostream::write().

---

Friends And Related Function Documentation

bool operator==	(	const BinaryRef &	LHS,
		const BinaryRef &	RHS
	)		[friend]

Definition at line 79 of file YAML.h.

---

The documentation for this class was generated from the following files:

• YAML.h
• YAML.cpp