yousefulSOFTWARE

YOUSEFUL / DELPHI / COMPONENTS

All Atlas Log components · Atlas Log guide

EAtlasLogError

Raised for configuration mistakes; logging calls themselves never raise.

Class Unit Atlas.Log · Inherits Exception · Product Atlas Log

Description

Raised by: TAtlasLogger.AddSink(nil); SetCategoryLevel with a blank name; an invalid Pattern on a text sink, TAtlasTextFormatter or TAtlasLogView (unknown token, unterminated {, single }); a negative MaxBytes or MaxFiles; a Capacity outside 1 to 10,000,000 on TAtlasMemorySink or TAtlasAsyncSink; a TAtlasAsyncSink whose Target is itself; TAtlasLogView.ShownEvent with a row that is not shown. A TAtlasFileSink without a FileName raises it when writing, which the logger catches and counts in SinkErrors.

This type has no members of its own beyond those listed in its description.

Examples

A rejected pattern

The previous pattern stays in force.

pascal
uses System.SysUtils, Atlas.Log, Atlas.LogSinks;

procedure TryPattern(Sink: TAtlasTextSink);
begin
  try
    Sink.Pattern := '{message} {colour}';
  except
    on E: EAtlasLogError do Writeln(E.Message);   // Pattern has an unknown token "{colour}"
  end;
end;

TAtlasLogger · TAtlasTextFormatter

Also in Atlas Log

TAtlasLogger · TAtlasMemorySink · TAtlasCallbackSink · TAtlasConsoleSink · TAtlasDebugSink · TAtlasFileSink · TAtlasAsyncSink · TAtlasLogView