Ninja
Defines | Functions
util.h File Reference
#include <stdint.h>
#include <string>
#include <vector>
Include dependency graph for util.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines

#define NORETURN   __attribute__((noreturn))

Functions

bool CanonicalizePath (string *path, string *err)
 Canonicalize a path like "foo/../bar.h" into just "bar.h".
bool CanonicalizePath (char *path, size_t *len, string *err)
string ElideMiddle (const string &str, size_t width)
 Elide the given string str with '...' in the middle if the length exceeds width.
void Error (const char *msg,...)
 Log an error message.
NORETURN void Fatal (const char *msg,...)
 Log a fatal message and exit.
double GetLoadAverage ()
int GetProcessorCount ()
int ReadFile (const string &path, string *contents, string *err)
 Read a file to a string (in text mode: with CRLF conversion on Windows).
void SetCloseOnExec (int fd)
 Mark a file descriptor to not be inherited on exec()s.
const char * SpellcheckString (const char *text,...)
 Like SpellcheckStringV, but takes a NULL-terminated list.
const char * SpellcheckStringV (const string &text, const vector< const char * > &words)
 Given a misspelled string and a list of correct spellings, returns the closest match or NULL if there is no close enough match.
string StripAnsiEscapeCodes (const string &in)
 Removes all Ansi escape codes (http://www.termsys.demon.co.uk/vtansi.htm).
bool Truncate (const string &path, size_t size, string *err)
 Truncates a file to the given size.
void Warning (const char *msg,...)
 Log a warning message.

Define Documentation

#define NORETURN   __attribute__((noreturn))

Definition at line 31 of file util.h.


Function Documentation

bool CanonicalizePath ( string *  path,
string *  err 
)

Canonicalize a path like "foo/../bar.h" into just "bar.h".

Definition at line 87 of file util.cc.

References CanonicalizePath(), and METRIC_RECORD.

Referenced by CanonicalizePath(), Builder::ExtractDeps(), ImplicitDepLoader::LoadDepFile(), main(), IncludesNormalize::Normalize(), ManifestParser::ParseDefault(), ManifestParser::ParseEdge(), and TEST().

bool CanonicalizePath ( char *  path,
size_t *  len,
string *  err 
)

Definition at line 99 of file util.cc.

References Fatal(), and METRIC_RECORD.

string ElideMiddle ( const string &  str,
size_t  width 
)

Elide the given string str with '...' in the middle if the length exceeds width.

Definition at line 331 of file util.cc.

Referenced by LinePrinter::Print().

void Error ( const char *  msg,
  ... 
)
NORETURN void Fatal ( const char *  msg,
  ... 
)
double GetLoadAverage ( )
Returns:
the load average of the machine. A negative value is returned on error.

Definition at line 320 of file util.cc.

Referenced by RealCommandRunner::CanRunMore().

Returns:
the number of processors on the machine. Useful for an initial guess for how many jobs to run in parallel.
0 on error.

Definition at line 303 of file util.cc.

int ReadFile ( const string &  path,
string *  contents,
string *  err 
)

Read a file to a string (in text mode: with CRLF conversion on Windows).

Returns -errno and fills in err on error.

Definition at line 178 of file util.cc.

Referenced by main(), MSVCHelperMain(), and CLWrapper::Run().

void SetCloseOnExec ( int  fd)

Mark a file descriptor to not be inherited on exec()s.

Definition at line 200 of file util.cc.

Referenced by BuildLog::OpenForWrite(), DepsLog::OpenForWrite(), and Subprocess::Start().

const char* SpellcheckString ( const char *  text,
  ... 
)

Like SpellcheckStringV, but takes a NULL-terminated list.

Definition at line 237 of file util.cc.

References SpellcheckStringV().

const char* SpellcheckStringV ( const string &  text,
const vector< const char * > &  words 
)

Given a misspelled string and a list of correct spellings, returns the closest match or NULL if there is no close enough match.

Definition at line 218 of file util.cc.

References EditDistance().

Referenced by SpellcheckString().

string StripAnsiEscapeCodes ( const string &  in)

Removes all Ansi escape codes (http://www.termsys.demon.co.uk/vtansi.htm).

Definition at line 280 of file util.cc.

References islatinalpha().

Referenced by BuildStatus::BuildEdgeFinished().

bool Truncate ( const string &  path,
size_t  size,
string *  err 
)

Truncates a file to the given size.

Definition at line 343 of file util.cc.

Referenced by DepsLog::Load().

void Warning ( const char *  msg,
  ... 
)

Log a warning message.

Definition at line 69 of file util.cc.

Referenced by State::AddOut(), CheckNinjaVersion(), CreateWin32MiniDump(), and IncludesNormalize::Normalize().