A raw_ostream of a file for reading/writing/seeking. More...

#include "llvm/Support/raw_ostream.h"

Inheritance diagram for llvm::raw_fd_stream:

Public Member Functions
LLVM_ABI	raw_fd_stream (StringRef Filename, std::error_code &EC)
	Open the specified file for reading/writing/seeking.
LLVM_ABI	raw_fd_stream (int fd, bool shouldClose)
LLVM_ABI ssize_t	read (char *Ptr, size_t Size)
	This reads the `Size` bytes into a buffer pointed by `Ptr`.
Public Member Functions inherited from llvm::raw_fd_ostream
	raw_fd_ostream (StringRef Filename, std::error_code &EC)
	Open the specified file for writing.
	raw_fd_ostream (StringRef Filename, std::error_code &EC, sys::fs::CreationDisposition Disp)
	raw_fd_ostream (StringRef Filename, std::error_code &EC, sys::fs::FileAccess Access)
	raw_fd_ostream (StringRef Filename, std::error_code &EC, sys::fs::OpenFlags Flags)
	raw_fd_ostream (StringRef Filename, std::error_code &EC, sys::fs::CreationDisposition Disp, sys::fs::FileAccess Access, sys::fs::OpenFlags Flags)
	raw_fd_ostream (int fd, bool shouldClose, bool unbuffered=false, OStreamKind K=OStreamKind::OK_OStream)
	FD is the file descriptor that this writes to.
	~raw_fd_ostream () override
void	close ()
	Manually flush the stream and close the file.
bool	supportsSeeking () const
bool	isRegularFile () const
uint64_t	seek (uint64_t off)
	Flushes the stream and repositions the underlying file descriptor position to the offset specified from the beginning of the file.
bool	is_displayed () const override
	This function determines if this stream is connected to a "tty" or "console" window.
bool	has_colors () const override
	This function determines if this stream is displayed and supports colors.
void	tie (raw_ostream *TieTo)
	Tie this stream to the specified stream.
std::error_code	error () const
bool	has_error () const
	Return the value of the flag in this raw_fd_ostream indicating whether an output error has been encountered.
void	clear_error ()
	Set the flag read by has_error() to false.
Expected< sys::fs::FileLocker >	lock ()
	Locks the underlying file.
Expected< sys::fs::FileLocker >	tryLockFor (Duration const &Timeout)
	Tries to lock the underlying file within the specified period.
Public Member Functions inherited from llvm::raw_pwrite_stream
	raw_pwrite_stream (bool Unbuffered=false, OStreamKind K=OStreamKind::OK_OStream)
void	pwrite (const char *Ptr, size_t Size, uint64_t Offset)
Public Member Functions inherited from llvm::raw_ostream
	raw_ostream (bool unbuffered=false, OStreamKind K=OStreamKind::OK_OStream)
	raw_ostream (const raw_ostream &)=delete
void	operator= (const raw_ostream &)=delete
virtual	~raw_ostream ()
uint64_t	tell () const
	tell - Return the current offset with the file.
OStreamKind	get_kind () const
virtual void	reserveExtraSpace (uint64_t ExtraSize)
	If possible, pre-allocate `ExtraSize` bytes for stream data.
void	SetBuffered ()
	Set the stream to be buffered, with an automatically determined buffer size.
void	SetBufferSize (size_t Size)
	Set the stream to be buffered, using the specified buffer size.
size_t	GetBufferSize () const
void	SetUnbuffered ()
	Set the stream to be unbuffered.
size_t	GetNumBytesInBuffer () const
void	flush ()
raw_ostream &	operator<< (char C)
raw_ostream &	operator<< (unsigned char C)
raw_ostream &	operator<< (signed char C)
raw_ostream &	operator<< (StringRef Str)
raw_ostream &	operator<< (const char *Str)
raw_ostream &	operator<< (const std::string &Str)
raw_ostream &	operator<< (const std::string_view &Str)
raw_ostream &	operator<< (const SmallVectorImpl< char > &Str)
raw_ostream &	operator<< (unsigned long N)
raw_ostream &	operator<< (long N)
raw_ostream &	operator<< (unsigned long long N)
raw_ostream &	operator<< (long long N)
raw_ostream &	operator<< (const void *P)
raw_ostream &	operator<< (unsigned int N)
raw_ostream &	operator<< (int N)
raw_ostream &	operator<< (double N)
raw_ostream &	write_hex (unsigned long long N)
	Output `N` in hexadecimal, without any prefix or padding.
raw_ostream &	operator<< (Colors C)
raw_ostream &	write_uuid (const uuid_t UUID)
raw_ostream &	write_escaped (StringRef Str, bool UseHexEscapes=false)
	Output `Str`, turning '\', '\t', ' ', '"', and anything that doesn't satisfy llvm::isPrint into an escape sequence.
raw_ostream &	write (unsigned char C)
raw_ostream &	write (const char *Ptr, size_t Size)
raw_ostream &	operator<< (const format_object_base &Fmt)
raw_ostream &	operator<< (const FormattedString &)
raw_ostream &	operator<< (const FormattedNumber &)
raw_ostream &	operator<< (const formatv_object_base &)
raw_ostream &	operator<< (const FormattedBytes &)
raw_ostream &	indent (unsigned NumSpaces)
	indent - Insert 'NumSpaces' spaces.
raw_ostream &	write_zeros (unsigned NumZeros)
	write_zeros - Insert 'NumZeros' nulls.
virtual raw_ostream &	changeColor (enum Colors Color, bool Bold=false, bool BG=false)
	Changes the foreground color of text that will be output from this point forward.
virtual raw_ostream &	resetColor ()
	Resets the colors to terminal defaults.
virtual raw_ostream &	reverseColor ()
	Reverses the foreground and background colors.
virtual void	enable_colors (bool enable)
bool	colors_enabled () const

Static Public Member Functions
static LLVM_ABI bool	classof (const raw_ostream *OS)
	Check if `OS` is a pointer of type raw_fd_stream*.

Additional Inherited Members
Public Types inherited from llvm::raw_ostream
enum class	OStreamKind { OK_OStream , OK_FDStream , OK_SVecStream }
enum class	Colors { BLACK = 0 , RED , GREEN , YELLOW , BLUE , MAGENTA , CYAN , WHITE , BRIGHT_BLACK , BRIGHT_RED , BRIGHT_GREEN , BRIGHT_YELLOW , BRIGHT_BLUE , BRIGHT_MAGENTA , BRIGHT_CYAN , BRIGHT_WHITE , SAVEDCOLOR , RESET }
using	uuid_t = uint8_t[16]
	Output a formatted UUID with dash separators.
Static Public Attributes inherited from llvm::raw_ostream
static constexpr Colors	BLACK = Colors::BLACK
static constexpr Colors	RED = Colors::RED
static constexpr Colors	GREEN = Colors::GREEN
static constexpr Colors	YELLOW = Colors::YELLOW
static constexpr Colors	BLUE = Colors::BLUE
static constexpr Colors	MAGENTA = Colors::MAGENTA
static constexpr Colors	CYAN = Colors::CYAN
static constexpr Colors	WHITE = Colors::WHITE
static constexpr Colors	BRIGHT_BLACK = Colors::BRIGHT_BLACK
static constexpr Colors	BRIGHT_RED = Colors::BRIGHT_RED
static constexpr Colors	BRIGHT_GREEN = Colors::BRIGHT_GREEN
static constexpr Colors	BRIGHT_YELLOW = Colors::BRIGHT_YELLOW
static constexpr Colors	BRIGHT_BLUE = Colors::BRIGHT_BLUE
static constexpr Colors	BRIGHT_MAGENTA = Colors::BRIGHT_MAGENTA
static constexpr Colors	BRIGHT_CYAN = Colors::BRIGHT_CYAN
static constexpr Colors	BRIGHT_WHITE = Colors::BRIGHT_WHITE
static constexpr Colors	SAVEDCOLOR = Colors::SAVEDCOLOR
static constexpr Colors	RESET = Colors::RESET
Protected Member Functions inherited from llvm::raw_fd_ostream
void	error_detected (std::error_code EC)
	Set the flag indicating that an output error has been encountered.
int	get_fd () const
	Return the file descriptor.
void	inc_pos (uint64_t Delta)
Protected Member Functions inherited from llvm::raw_ostream
void	SetBuffer (char *BufferStart, size_t Size)
	Use the provided buffer as the raw_ostream buffer.
const char *	getBufferStart () const
	Return the beginning of the current stream buffer, or 0 if the stream is unbuffered.

Detailed Description

A raw_ostream of a file for reading/writing/seeking.

Definition at line 629 of file raw_ostream.h.

Constructor & Destructor Documentation

◆ raw_fd_stream() [1/2]

raw_fd_stream::raw_fd_stream	(	StringRef	Filename,
		std::error_code &	EC )

Open the specified file for reading/writing/seeking.

If an error occurs, information about the error is put into EC, and the stream should be immediately destroyed.

Definition at line 929 of file raw_ostream.cpp.

References getFD(), llvm::raw_fd_ostream::isRegularFile(), llvm::raw_ostream::OK_FDStream, and llvm::raw_fd_ostream::raw_fd_ostream().

Referenced by llvm::raw_socket_stream::raw_socket_stream().

◆ raw_fd_stream() [2/2]

raw_fd_stream::raw_fd_stream	(	int	fd,
		bool	shouldClose )

Definition at line 941 of file raw_ostream.cpp.

References llvm::raw_ostream::OK_FDStream, and llvm::raw_fd_ostream::raw_fd_ostream().

Member Function Documentation

◆ classof()

bool raw_fd_stream::classof ( const raw_ostream * OS )

static

Check if OS is a pointer of type raw_fd_stream*.

Definition at line 954 of file raw_ostream.cpp.

References llvm::raw_ostream::get_kind(), and llvm::raw_ostream::OK_FDStream.

◆ read()

ssize_t raw_fd_stream::read	(	char *	Ptr,
		size_t	Size )

This reads the Size bytes into a buffer pointed by Ptr.

Parameters

Ptr	The start of the buffer to hold data to be read.
Size	The number of bytes to be read.

On success, the number of bytes read is returned, and the file position is advanced by this number. On error, -1 is returned, use error() to get the error code.

Definition at line 944 of file raw_ostream.cpp.

References assert(), llvm::errnoAsErrorCode(), llvm::raw_fd_ostream::error_detected(), llvm::raw_fd_ostream::get_fd(), llvm::raw_fd_ostream::inc_pos(), Ptr, read(), and Size.

Referenced by read(), and llvm::raw_socket_stream::read().

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

include/llvm/Support/raw_ostream.h
lib/Support/raw_ostream.cpp

Public Member Functions

Static Public Member Functions