std.experimental.logger.filelogger

Source

std/experimental/logger/filelogger.d

alias CreateFolder = std.typecons.Flag!"CreateFolder".Flag;

An option to create FileLogger directory if it is non-existent.

class FileLogger: std.experimental.logger.core.Logger;

This Logger implementation writes log messages to the associated file. The name of the file has to be passed on construction time. If the file is already present new log messages will be append at its end.

@safe this(in string fn, const LogLevel lv = LogLevel.all);

A constructor for the FileLogger Logger.

Parameters:

string fn	The filename of the output file of the FileLogger. If that file can not be opened for writting an exception will be thrown.
LogLevel lv	The LogLevel for the FileLogger. By default the

Example

auto l1 = new FileLogger("logFile");
auto l2 = new FileLogger("logFile", LogLevel.fatal);
auto l3 = new FileLogger("logFile", LogLevel.fatal, CreateFolder.yes);

@safe this(in string fn, const LogLevel lv, CreateFolder createFileNameFolder);

A constructor for the FileLogger Logger that takes a reference to a File.

The File passed must be open for all the log call to the FileLogger. If the File gets closed, using the FileLogger for logging will result in undefined behaviour.

Parameters:

string fn	The file used for logging.
LogLevel lv	The LogLevel for the FileLogger. By default the LogLevel for FileLogger is LogLevel.all.
CreateFolder createFileNameFolder	if yes and fn contains a folder name, this folder will be created.

Example

auto file = File("logFile.log", "w");
auto l1 = new FileLogger(file);
auto l2 = new FileLogger(file, LogLevel.fatal);

@safe this(File file, const LogLevel lv = LogLevel.all);

A constructor for the FileLogger Logger that takes a reference to a File.

The File passed must be open for all the log call to the FileLogger. If the File gets closed, using the FileLogger for logging will result in undefined behaviour.

Parameters:

File file	The file used for logging.
LogLevel lv	The LogLevel for the FileLogger. By default the LogLevel for FileLogger is LogLevel.all.

Example

auto file = File("logFile.log", "w");
auto l1 = new FileLogger(file);
auto l2 = new FileLogger(file, LogLevel.fatal);

@property @safe File file();

If the FileLogger is managing the File it logs to, this method will return a reference to this File.

string getFilename();

If the FileLogger was constructed with a filename, this method returns this filename. Otherwise an empty string is returned.

protected File file_;

The File log messages are written to.

protected string filename;

The filename of the File log messages are written to.