dart::Log Class Reference

#include <log.h>

Public Member Functions
	Log (LogPrinter printer=nullptr)
	~Log ()
void	Print (const char *format,...) PRINTF_ATTRIBUTE(2
void void	VPrint (const char *format, va_list args)
void	Flush (const intptr_t cursor=0)
void	Clear ()
intptr_t	cursor () const

Static Public Member Functions
static Log *	Current ()
static Log *	NoOpLog ()

Friends
class	LogBlock
class	LogTestHelper

Detailed Description

Definition at line 27 of file log.h.

Constructor & Destructor Documentation

Log()

dart::Log::Log ( LogPrinter  printer = nullptr )

explicit

Definition at line 60 of file log.cc.

                           : printer_(printer), manual_flush_(0), buffer_(0) {
  if (printer_ == nullptr) {
    if (FLAG_redirect_isolate_log_to == nullptr) {
      printer_ = [](const char* data) { OS::PrintErr("%s", data); };
    } else {
      printer_ = &LogFile::Print;
    }
  }
}

~Log()

dart::Log::~Log

(

)

Definition at line 70 of file log.cc.

          {
  // Did someone enable manual flushing and then forgot to Flush?
  ASSERT(cursor() == 0);
}

Member Function Documentation

Clear()

void dart::Log::Clear

(

)

Definition at line 151 of file log.cc.

                {
  if (this == NoOpLog()) {
    return;
  }
  buffer_.TruncateTo(0);
}

Current()

Log * dart::Log::Current ( )

static

Definition at line 75 of file log.cc.

                  {
  Thread* thread = Thread::Current();
  if (thread == nullptr) {
    OSThread* os_thread = OSThread::Current();
    ASSERT(os_thread != nullptr);
    return os_thread->log();
  }
  IsolateGroup* isolate_group = thread->isolate_group();
  if ((isolate_group != nullptr) &&
      Log::ShouldLogForIsolateGroup(isolate_group)) {
    OSThread* os_thread = thread->os_thread();
    ASSERT(os_thread != nullptr);
    return os_thread->log();
  } else {
    return Log::NoOpLog();
  }
}

cursor()

intptr_t dart::Log::cursor

(

)

const

Definition at line 158 of file log.cc.

                           {
  return buffer_.length();
}

Flush()

void dart::Log::Flush

(

const intptr_t

cursor = 0

)

Definition at line 134 of file log.cc.

                                     {
  if (this == NoOpLog()) {
    return;
  }
  if (buffer_.is_empty()) {
    return;
  }
  if (buffer_.length() <= cursor) {
    return;
  }
  TerminateString();
  const char* str = &buffer_[cursor];
  ASSERT(str != nullptr);
  printer_(str);
  buffer_.TruncateTo(cursor);
}

NoOpLog()

Log * dart::Log::NoOpLog ( )

static

Definition at line 183 of file log.cc.

                  {
  return &noop_log_;
}

Print()

void dart::Log::Print	(	const char *	format,
			...
	)

Definition at line 93 of file log.cc.

                                       {
  if (this == NoOpLog()) {
    return;
  }
 
  va_list args;
  va_start(args, format);
  VPrint(format, args);
  va_end(args);
}

VPrint()

void dart::Log::VPrint	(	const char *	format,
		va_list	args
	)

Definition at line 104 of file log.cc.

                                                 {
  if (this == NoOpLog()) {
    return;
  }
 
  // Measure.
  va_list measure_args;
  va_copy(measure_args, args);
  intptr_t len = Utils::VSNPrint(nullptr, 0, format, measure_args);
  va_end(measure_args);
 
  // Print.
  char* buffer = reinterpret_cast<char*>(malloc(len + 1));
  va_list print_args;
  va_copy(print_args, args);
  Utils::VSNPrint(buffer, (len + 1), format, print_args);
  va_end(print_args);
 
  // Append.
  // NOTE: does not append the '\0' character.
  for (intptr_t i = 0; i < len; i++) {
    buffer_.Add(buffer[i]);
  }
  free(buffer);
 
  if (ShouldFlush()) {
    Flush();
  }
}

Friends And Related Function Documentation

LogBlock

friend class LogBlock

friend

Definition at line 68 of file log.h.

LogTestHelper

friend class LogTestHelper

friend

Definition at line 69 of file log.h.

---

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

• third_party/dart-lang/sdk/runtime/vm/log.h
• third_party/dart-lang/sdk/runtime/vm/log.cc