mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-07-24 23:29:41 +00:00
Don't repeat names in comments.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@234412 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
parent
7db332b8ea
commit
dc45a1ef4f
@ -20,21 +20,20 @@
|
|||||||
#include <system_error>
|
#include <system_error>
|
||||||
|
|
||||||
namespace llvm {
|
namespace llvm {
|
||||||
class format_object_base;
|
class format_object_base;
|
||||||
class FormattedString;
|
class FormattedString;
|
||||||
class FormattedNumber;
|
class FormattedNumber;
|
||||||
template <typename T>
|
template <typename T> class SmallVectorImpl;
|
||||||
class SmallVectorImpl;
|
|
||||||
|
|
||||||
namespace sys {
|
namespace sys {
|
||||||
namespace fs {
|
namespace fs {
|
||||||
enum OpenFlags : unsigned;
|
enum OpenFlags : unsigned;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// raw_ostream - This class implements an extremely fast bulk output stream
|
/// This class implements an extremely fast bulk output stream that can *only*
|
||||||
/// that can *only* output to a stream. It does not support seeking, reopening,
|
/// output to a stream. It does not support seeking, reopening, rewinding, line
|
||||||
/// rewinding, line buffered disciplines etc. It is a simple buffer that outputs
|
/// buffered disciplines etc. It is a simple buffer that outputs
|
||||||
/// a chunk at a time.
|
/// a chunk at a time.
|
||||||
class raw_ostream {
|
class raw_ostream {
|
||||||
private:
|
private:
|
||||||
@ -96,12 +95,11 @@ public:
|
|||||||
// Configuration Interface
|
// Configuration Interface
|
||||||
//===--------------------------------------------------------------------===//
|
//===--------------------------------------------------------------------===//
|
||||||
|
|
||||||
/// SetBuffered - Set the stream to be buffered, with an automatically
|
/// Set the stream to be buffered, with an automatically determined buffer
|
||||||
/// determined buffer size.
|
/// size.
|
||||||
void SetBuffered();
|
void SetBuffered();
|
||||||
|
|
||||||
/// SetBufferSize - Set the stream to be buffered, using the
|
/// Set the stream to be buffered, using the specified buffer size.
|
||||||
/// specified buffer size.
|
|
||||||
void SetBufferSize(size_t Size) {
|
void SetBufferSize(size_t Size) {
|
||||||
flush();
|
flush();
|
||||||
SetBufferAndMode(new char[Size], Size, InternalBuffer);
|
SetBufferAndMode(new char[Size], Size, InternalBuffer);
|
||||||
@ -117,10 +115,9 @@ public:
|
|||||||
return OutBufEnd - OutBufStart;
|
return OutBufEnd - OutBufStart;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// SetUnbuffered - Set the stream to be unbuffered. When
|
/// Set the stream to be unbuffered. When unbuffered, the stream will flush
|
||||||
/// unbuffered, the stream will flush after every write. This routine
|
/// after every write. This routine will also flush the buffer immediately
|
||||||
/// will also flush the buffer immediately when the stream is being
|
/// when the stream is being set to unbuffered.
|
||||||
/// set to unbuffered.
|
|
||||||
void SetUnbuffered() {
|
void SetUnbuffered() {
|
||||||
flush();
|
flush();
|
||||||
SetBufferAndMode(nullptr, 0, Unbuffered);
|
SetBufferAndMode(nullptr, 0, Unbuffered);
|
||||||
@ -204,11 +201,11 @@ public:
|
|||||||
|
|
||||||
raw_ostream &operator<<(double N);
|
raw_ostream &operator<<(double N);
|
||||||
|
|
||||||
/// write_hex - Output \p N in hexadecimal, without any prefix or padding.
|
/// Output \p N in hexadecimal, without any prefix or padding.
|
||||||
raw_ostream &write_hex(unsigned long long N);
|
raw_ostream &write_hex(unsigned long long N);
|
||||||
|
|
||||||
/// write_escaped - Output \p Str, turning '\\', '\t', '\n', '"', and
|
/// Output \p Str, turning '\\', '\t', '\n', '"', and anything that doesn't
|
||||||
/// anything that doesn't satisfy std::isprint into an escape sequence.
|
/// satisfy std::isprint into an escape sequence.
|
||||||
raw_ostream &write_escaped(StringRef Str, bool UseHexEscapes = false);
|
raw_ostream &write_escaped(StringRef Str, bool UseHexEscapes = false);
|
||||||
|
|
||||||
raw_ostream &write(unsigned char C);
|
raw_ostream &write(unsigned char C);
|
||||||
@ -263,8 +260,8 @@ public:
|
|||||||
//===--------------------------------------------------------------------===//
|
//===--------------------------------------------------------------------===//
|
||||||
|
|
||||||
private:
|
private:
|
||||||
/// write_impl - The is the piece of the class that is implemented
|
/// The is the piece of the class that is implemented by subclasses. This
|
||||||
/// by subclasses. This writes the \p Size bytes starting at
|
/// writes the \p Size bytes starting at
|
||||||
/// \p Ptr to the underlying stream.
|
/// \p Ptr to the underlying stream.
|
||||||
///
|
///
|
||||||
/// This function is guaranteed to only be called at a point at which it is
|
/// This function is guaranteed to only be called at a point at which it is
|
||||||
@ -281,41 +278,38 @@ private:
|
|||||||
// An out of line virtual method to provide a home for the class vtable.
|
// An out of line virtual method to provide a home for the class vtable.
|
||||||
virtual void handle();
|
virtual void handle();
|
||||||
|
|
||||||
/// current_pos - Return the current position within the stream, not
|
/// Return the current position within the stream, not counting the bytes
|
||||||
/// counting the bytes currently in the buffer.
|
/// currently in the buffer.
|
||||||
virtual uint64_t current_pos() const = 0;
|
virtual uint64_t current_pos() const = 0;
|
||||||
|
|
||||||
protected:
|
protected:
|
||||||
/// SetBuffer - Use the provided buffer as the raw_ostream buffer. This is
|
/// Use the provided buffer as the raw_ostream buffer. This is intended for
|
||||||
/// intended for use only by subclasses which can arrange for the output to go
|
/// use only by subclasses which can arrange for the output to go directly
|
||||||
/// directly into the desired output buffer, instead of being copied on each
|
/// into the desired output buffer, instead of being copied on each flush.
|
||||||
/// flush.
|
|
||||||
void SetBuffer(char *BufferStart, size_t Size) {
|
void SetBuffer(char *BufferStart, size_t Size) {
|
||||||
SetBufferAndMode(BufferStart, Size, ExternalBuffer);
|
SetBufferAndMode(BufferStart, Size, ExternalBuffer);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// preferred_buffer_size - Return an efficient buffer size for the
|
/// Return an efficient buffer size for the underlying output mechanism.
|
||||||
/// underlying output mechanism.
|
|
||||||
virtual size_t preferred_buffer_size() const;
|
virtual size_t preferred_buffer_size() const;
|
||||||
|
|
||||||
/// getBufferStart - Return the beginning of the current stream buffer, or 0
|
/// Return the beginning of the current stream buffer, or 0 if the stream is
|
||||||
/// if the stream is unbuffered.
|
/// unbuffered.
|
||||||
const char *getBufferStart() const { return OutBufStart; }
|
const char *getBufferStart() const { return OutBufStart; }
|
||||||
|
|
||||||
//===--------------------------------------------------------------------===//
|
//===--------------------------------------------------------------------===//
|
||||||
// Private Interface
|
// Private Interface
|
||||||
//===--------------------------------------------------------------------===//
|
//===--------------------------------------------------------------------===//
|
||||||
private:
|
private:
|
||||||
/// SetBufferAndMode - Install the given buffer and mode.
|
/// Install the given buffer and mode.
|
||||||
void SetBufferAndMode(char *BufferStart, size_t Size, BufferKind Mode);
|
void SetBufferAndMode(char *BufferStart, size_t Size, BufferKind Mode);
|
||||||
|
|
||||||
/// flush_nonempty - Flush the current buffer, which is known to be
|
/// Flush the current buffer, which is known to be non-empty. This outputs the
|
||||||
/// non-empty. This outputs the currently buffered data and resets
|
/// currently buffered data and resets the buffer to empty.
|
||||||
/// the buffer to empty.
|
|
||||||
void flush_nonempty();
|
void flush_nonempty();
|
||||||
|
|
||||||
/// copy_to_buffer - Copy data into the buffer. Size must not be
|
/// Copy data into the buffer. Size must not be greater than the number of
|
||||||
/// greater than the number of unused bytes in the buffer.
|
/// unused bytes in the buffer.
|
||||||
void copy_to_buffer(const char *Ptr, size_t Size);
|
void copy_to_buffer(const char *Ptr, size_t Size);
|
||||||
};
|
};
|
||||||
|
|
||||||
@ -323,7 +317,7 @@ private:
|
|||||||
// File Output Streams
|
// File Output Streams
|
||||||
//===----------------------------------------------------------------------===//
|
//===----------------------------------------------------------------------===//
|
||||||
|
|
||||||
/// raw_fd_ostream - A raw_ostream that writes to a file descriptor.
|
/// A raw_ostream that writes to a file descriptor.
|
||||||
///
|
///
|
||||||
class raw_fd_ostream : public raw_ostream {
|
class raw_fd_ostream : public raw_ostream {
|
||||||
int FD;
|
int FD;
|
||||||
@ -339,18 +333,17 @@ class raw_fd_ostream : public raw_ostream {
|
|||||||
|
|
||||||
uint64_t pos;
|
uint64_t pos;
|
||||||
|
|
||||||
/// write_impl - See raw_ostream::write_impl.
|
/// See raw_ostream::write_impl.
|
||||||
void write_impl(const char *Ptr, size_t Size) override;
|
void write_impl(const char *Ptr, size_t Size) override;
|
||||||
|
|
||||||
/// current_pos - Return the current position within the stream, not
|
/// Return the current position within the stream, not counting the bytes
|
||||||
/// counting the bytes currently in the buffer.
|
/// currently in the buffer.
|
||||||
uint64_t current_pos() const override { return pos; }
|
uint64_t current_pos() const override { return pos; }
|
||||||
|
|
||||||
/// preferred_buffer_size - Determine an efficient buffer size.
|
/// Determine an efficient buffer size.
|
||||||
size_t preferred_buffer_size() const override;
|
size_t preferred_buffer_size() const override;
|
||||||
|
|
||||||
/// error_detected - Set the flag indicating that an output error has
|
/// Set the flag indicating that an output error has been encountered.
|
||||||
/// been encountered.
|
|
||||||
void error_detected() { Error = true; }
|
void error_detected() { Error = true; }
|
||||||
|
|
||||||
public:
|
public:
|
||||||
@ -367,22 +360,22 @@ public:
|
|||||||
raw_fd_ostream(StringRef Filename, std::error_code &EC,
|
raw_fd_ostream(StringRef Filename, std::error_code &EC,
|
||||||
sys::fs::OpenFlags Flags);
|
sys::fs::OpenFlags Flags);
|
||||||
|
|
||||||
/// raw_fd_ostream ctor - FD is the file descriptor that this writes to. If
|
/// FD is the file descriptor that this writes to. If ShouldClose is true,
|
||||||
/// ShouldClose is true, this closes the file when the stream is destroyed.
|
/// this closes the file when the stream is destroyed.
|
||||||
raw_fd_ostream(int fd, bool shouldClose, bool unbuffered=false);
|
raw_fd_ostream(int fd, bool shouldClose, bool unbuffered=false);
|
||||||
|
|
||||||
~raw_fd_ostream();
|
~raw_fd_ostream();
|
||||||
|
|
||||||
/// close - Manually flush the stream and close the file.
|
/// Manually flush the stream and close the file. Note that this does not call
|
||||||
/// Note that this does not call fsync.
|
/// fsync.
|
||||||
void close();
|
void close();
|
||||||
|
|
||||||
/// seek - Flushes the stream and repositions the underlying file descriptor
|
/// Flushes the stream and repositions the underlying file descriptor position
|
||||||
/// position to the offset specified from the beginning of the file.
|
/// to the offset specified from the beginning of the file.
|
||||||
uint64_t seek(uint64_t off);
|
uint64_t seek(uint64_t off);
|
||||||
|
|
||||||
/// SetUseAtomicWrite - Set the stream to attempt to use atomic writes for
|
/// Set the stream to attempt to use atomic writes for individual output
|
||||||
/// individual output routines where possible.
|
/// routines where possible.
|
||||||
///
|
///
|
||||||
/// Note that because raw_ostream's are typically buffered, this flag is only
|
/// Note that because raw_ostream's are typically buffered, this flag is only
|
||||||
/// sensible when used on unbuffered streams which will flush their output
|
/// sensible when used on unbuffered streams which will flush their output
|
||||||
@ -401,18 +394,18 @@ public:
|
|||||||
|
|
||||||
bool has_colors() const override;
|
bool has_colors() const override;
|
||||||
|
|
||||||
/// has_error - Return the value of the flag in this raw_fd_ostream indicating
|
/// Return the value of the flag in this raw_fd_ostream indicating whether an
|
||||||
/// whether an output error has been encountered.
|
/// output error has been encountered.
|
||||||
/// This doesn't implicitly flush any pending output. Also, it doesn't
|
/// This doesn't implicitly flush any pending output. Also, it doesn't
|
||||||
/// guarantee to detect all errors unless the stream has been closed.
|
/// guarantee to detect all errors unless the stream has been closed.
|
||||||
bool has_error() const {
|
bool has_error() const {
|
||||||
return Error;
|
return Error;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// clear_error - Set the flag read by has_error() to false. If the error
|
/// Set the flag read by has_error() to false. If the error flag is set at the
|
||||||
/// flag is set at the time when this raw_ostream's destructor is called,
|
/// time when this raw_ostream's destructor is called, report_fatal_error is
|
||||||
/// report_fatal_error is called to report the error. Use clear_error()
|
/// called to report the error. Use clear_error() after handling the error to
|
||||||
/// after handling the error to avoid this behavior.
|
/// avoid this behavior.
|
||||||
///
|
///
|
||||||
/// "Errors should never pass silently.
|
/// "Errors should never pass silently.
|
||||||
/// Unless explicitly silenced."
|
/// Unless explicitly silenced."
|
||||||
@ -423,56 +416,54 @@ public:
|
|||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
/// outs() - This returns a reference to a raw_ostream for standard output.
|
/// This returns a reference to a raw_ostream for standard output. Use it like:
|
||||||
/// Use it like: outs() << "foo" << "bar";
|
/// outs() << "foo" << "bar";
|
||||||
raw_ostream &outs();
|
raw_ostream &outs();
|
||||||
|
|
||||||
/// errs() - This returns a reference to a raw_ostream for standard error.
|
/// This returns a reference to a raw_ostream for standard error. Use it like:
|
||||||
/// Use it like: errs() << "foo" << "bar";
|
/// errs() << "foo" << "bar";
|
||||||
raw_ostream &errs();
|
raw_ostream &errs();
|
||||||
|
|
||||||
/// nulls() - This returns a reference to a raw_ostream which simply discards
|
/// This returns a reference to a raw_ostream which simply discards output.
|
||||||
/// output.
|
|
||||||
raw_ostream &nulls();
|
raw_ostream &nulls();
|
||||||
|
|
||||||
//===----------------------------------------------------------------------===//
|
//===----------------------------------------------------------------------===//
|
||||||
// Output Stream Adaptors
|
// Output Stream Adaptors
|
||||||
//===----------------------------------------------------------------------===//
|
//===----------------------------------------------------------------------===//
|
||||||
|
|
||||||
/// raw_string_ostream - A raw_ostream that writes to an std::string. This is a
|
/// A raw_ostream that writes to an std::string. This is a simple adaptor
|
||||||
/// simple adaptor class. This class does not encounter output errors.
|
/// class. This class does not encounter output errors.
|
||||||
class raw_string_ostream : public raw_ostream {
|
class raw_string_ostream : public raw_ostream {
|
||||||
std::string &OS;
|
std::string &OS;
|
||||||
|
|
||||||
/// write_impl - See raw_ostream::write_impl.
|
/// See raw_ostream::write_impl.
|
||||||
void write_impl(const char *Ptr, size_t Size) override;
|
void write_impl(const char *Ptr, size_t Size) override;
|
||||||
|
|
||||||
/// current_pos - Return the current position within the stream, not
|
/// Return the current position within the stream, not counting the bytes
|
||||||
/// counting the bytes currently in the buffer.
|
/// currently in the buffer.
|
||||||
uint64_t current_pos() const override { return OS.size(); }
|
uint64_t current_pos() const override { return OS.size(); }
|
||||||
public:
|
public:
|
||||||
explicit raw_string_ostream(std::string &O) : OS(O) {}
|
explicit raw_string_ostream(std::string &O) : OS(O) {}
|
||||||
~raw_string_ostream();
|
~raw_string_ostream();
|
||||||
|
|
||||||
/// str - Flushes the stream contents to the target string and returns
|
/// Flushes the stream contents to the target string and returns the string's
|
||||||
/// the string's reference.
|
/// reference.
|
||||||
std::string& str() {
|
std::string& str() {
|
||||||
flush();
|
flush();
|
||||||
return OS;
|
return OS;
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
/// raw_svector_ostream - A raw_ostream that writes to an SmallVector or
|
/// A raw_ostream that writes to an SmallVector or SmallString. This is a
|
||||||
/// SmallString. This is a simple adaptor class. This class does not
|
/// simple adaptor class. This class does not encounter output errors.
|
||||||
/// encounter output errors.
|
|
||||||
class raw_svector_ostream : public raw_ostream {
|
class raw_svector_ostream : public raw_ostream {
|
||||||
SmallVectorImpl<char> &OS;
|
SmallVectorImpl<char> &OS;
|
||||||
|
|
||||||
/// write_impl - See raw_ostream::write_impl.
|
/// See raw_ostream::write_impl.
|
||||||
void write_impl(const char *Ptr, size_t Size) override;
|
void write_impl(const char *Ptr, size_t Size) override;
|
||||||
|
|
||||||
/// current_pos - Return the current position within the stream, not
|
/// Return the current position within the stream, not counting the bytes
|
||||||
/// counting the bytes currently in the buffer.
|
/// currently in the buffer.
|
||||||
uint64_t current_pos() const override;
|
uint64_t current_pos() const override;
|
||||||
public:
|
public:
|
||||||
/// Construct a new raw_svector_ostream.
|
/// Construct a new raw_svector_ostream.
|
||||||
@ -482,23 +473,23 @@ public:
|
|||||||
explicit raw_svector_ostream(SmallVectorImpl<char> &O);
|
explicit raw_svector_ostream(SmallVectorImpl<char> &O);
|
||||||
~raw_svector_ostream();
|
~raw_svector_ostream();
|
||||||
|
|
||||||
/// resync - This is called when the SmallVector we're appending to is changed
|
/// This is called when the SmallVector we're appending to is changed outside
|
||||||
/// outside of the raw_svector_ostream's control. It is only safe to do this
|
/// of the raw_svector_ostream's control. It is only safe to do this if the
|
||||||
/// if the raw_svector_ostream has previously been flushed.
|
/// raw_svector_ostream has previously been flushed.
|
||||||
void resync();
|
void resync();
|
||||||
|
|
||||||
/// str - Flushes the stream contents to the target vector and return a
|
/// Flushes the stream contents to the target vector and return a StringRef
|
||||||
/// StringRef for the vector contents.
|
/// for the vector contents.
|
||||||
StringRef str();
|
StringRef str();
|
||||||
};
|
};
|
||||||
|
|
||||||
/// raw_null_ostream - A raw_ostream that discards all output.
|
/// A raw_ostream that discards all output.
|
||||||
class raw_null_ostream : public raw_ostream {
|
class raw_null_ostream : public raw_ostream {
|
||||||
/// write_impl - See raw_ostream::write_impl.
|
/// See raw_ostream::write_impl.
|
||||||
void write_impl(const char *Ptr, size_t size) override;
|
void write_impl(const char *Ptr, size_t size) override;
|
||||||
|
|
||||||
/// current_pos - Return the current position within the stream, not
|
/// Return the current position within the stream, not counting the bytes
|
||||||
/// counting the bytes currently in the buffer.
|
/// currently in the buffer.
|
||||||
uint64_t current_pos() const override;
|
uint64_t current_pos() const override;
|
||||||
|
|
||||||
public:
|
public:
|
||||||
|
Loading…
Reference in New Issue
Block a user