View source code
Display the source code in std/logger/filelogger.d from which this page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Class std.logger.filelogger.FileLogger

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.

class FileLogger
  : Logger ;

Constructors

NameDescription
this (fn, lv) A constructor for the FileLogger Logger.
this (fn, lv, createFileNameFolder) A constructor for the FileLogger Logger that takes a reference to a File.
this (file, lv) A constructor for the FileLogger Logger that takes a reference to a File.

Fields

NameTypeDescription
file_ FileThe File log messages are written to.
filename stringThe filename of the File log messages are written to.

Properties

NameTypeDescription
file[get] FileIf the FileLogger is managing the File it logs to, this method will return a reference to this File.
fatalHandler[get, set] void delegate()This delegate is called in case a log message with LogLevel.fatal gets logged.
logLevel[get, set] LogLevelThe LogLevel determines if the log call are processed or dropped by the Logger. In order for the log call to be processed the LogLevel of the log call must be greater or equal to the LogLevel of the logger.

Methods

NameDescription
getFilename () If the FileLogger was constructed with a filename, this method returns this filename. Otherwise an empty string is returned.
factory (classname) Create instance of class specified by the fully qualified name classname. The class must either have no constructors or have a default constructor.
forwardMsg (payload) This method allows forwarding log entries from one logger to another.
log (ll, condition, args) This method logs data with the LogLevel of the used Logger.
log (ll, args) This function logs data to the used Logger with a specific LogLevel.
log (condition, args) This function logs data to the used Logger depending on a explicitly passed condition with the LogLevel of the used Logger.
log (args) This function logs data to the used Logger with the LogLevel of the used Logger.
logf (ll, condition, msg, args) This function logs data to the used Logger with a specific LogLevel and depending on a condition in a printf-style manner.
logf (ll, msg, args) This function logs data to the used Logger with a specific LogLevel in a printf-style manner.
logf (condition, msg, args) This function logs data to the used Logger depending on a condition with the LogLevel of the used Logger in a printf-style manner.
logf (msg, args) This method logs data to the used Logger with the LogLevel of the this Logger in a printf-style manner.
opCmp (o) Compare with another Object obj.
opEquals (o) Test whether this is equal to o. The default implementation only compares by identity (using the is operator). Generally, overrides and overloads for opEquals should attempt to compare objects by their contents. A class will most likely want to add an overload that takes your specific type as the argument and does the content comparison. Then you can override this and forward it to your specific typed overload with a cast. Remember to check for null on the typed overload.
toHash () Compute hash function for Object.
toString () Convert Object to a human readable string.
finishLogMsg () Signals that the message has been written and no more calls to logMsgPart follow.
logMsgPart (msg) Logs a part of the log message.
writeLogMsg (payload) A custom logger must implement this method in order to work in a MultiLogger and ArrayLogger.

Inner structs

NameDescription
LogEntry LogEntry is a aggregation combining all information associated with a log message. This aggregation will be passed to the method writeLogMsg.

Aliases

NameDescription
critical This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
criticalf This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
error This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
errorf This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
fatal This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
fatalf This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
info This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
infof This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
trace This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
tracef This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
warning This template provides the log functions for the Logger class with the LogLevel encoded in the function name.
warningf This template provides the log functions for the Logger class with the LogLevel encoded in the function name.

Templates

NameDescription
memLogFunctions This template provides the log functions for the Logger class with the LogLevel encoded in the function name.

Authors

License