API
#log
Xu 0.8.8 API
import: #log
counts: 1 fns, 16 methods, 1 types, 8 consts, 0 ifaces
Owning Logger: print/printf/fatal; optional file location.
const ldate
Purpose
Minimal logger aligned with `log` (Logger + Print/Println/Printf). No package-global logger (Xu forbids mutable globals). Callers hold a Logger. Output defaults to eprintln; set_output_stdout switches to println. No io.Writer struct@ values. Time flags: ldate/ltime/lmicroseconds/lutc/lstd_flags. File flags: lshortfile/llongfile via output/println_at (explicit file:line). print/println/printf/fatal auto-inject callsite when those flags are set (compiler rewrites to *at with compile-time file/line). Value `1`.
Parameters
none
const ltime
Purpose
Public constant `ltime`. Value `2`.
Parameters
none
const lmicroseconds
pub const lmicroseconds = 4
Purpose
Public constant `lmicroseconds`. Value `4`.
Parameters
none
const lutc
Purpose
Public constant `lutc`. Value `8`.
Parameters
none
const llongfile
Purpose
Public constant `llongfile`. Value `16`.
Parameters
none
const lshortfile
pub const lshortfile = 32
Purpose
Public constant `lshortfile`. Value `32`.
Parameters
none
const lmsgprefix
pub const lmsgprefix = 64
Purpose
Public constant `lmsgprefix`. Value `64`.
Parameters
none
const lstd_flags
Purpose
Public constant `lstd_flags`. Value `3`.
Parameters
none
struct Logger
pub struct Logger {
pub prefix string
pub use_stdout bool
pub flags int
pub buf string
pub use_buf bool
}
Purpose
Public struct `Logger`.
Parameters
prefix string- prefix
use_stdout bool- field (bool)
flags int- field (int)
buf string- buffer
use_buf bool- field (bool)
new_logger
pub fn new_logger() Logger
Purpose
Construct logger.
Parameters
none
Returns
Logger — a value of this type
(&mut Logger) set_prefix
pub fn (l &mut Logger) set_prefix(p string)
Purpose
Method on `&mut Logger`: set prefix.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
p string- p (string)
(&Logger) prefix
pub fn (l &Logger) prefix() string
Purpose
Call `prefix` on `&Logger`.
Parameters
l &Logger- receiver &Logger (borrow)
Returns
string — result string
(&Logger) flags
pub fn (l &Logger) flags() int
Purpose
Call `flags` on `&Logger`.
Parameters
l &Logger- receiver &Logger (borrow)
Returns
int — a value of this type
(&mut Logger) set_output_stdout
pub fn (l &mut Logger) set_output_stdout(on bool)
Purpose
Method on `&mut Logger`: set output stdout.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
on bool- on (bool)
(&mut Logger) set_flags
pub fn (l &mut Logger) set_flags(f int)
Purpose
Method on `&mut Logger`: set flags.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
f int- callback or format string (int)
(&mut Logger) set_output_buffer
pub fn (l &mut Logger) set_output_buffer()
Purpose
Method on `&mut Logger`: set output buffer.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
(&mut Logger) buffer_text
pub fn (l &mut Logger) buffer_text() string
Purpose
Method on `&mut Logger`: buffer text.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
Returns
string — result string
(&mut Logger) output
pub fn (l &mut Logger) output(file string, line int, s string)
Purpose
Call `output` on `&mut Logger`.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
file string- file (string)
line int- line (int)
s string- source string (string)
(&mut Logger) println_at
pub fn (l &mut Logger) println_at(file string, line int, args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: println at.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
file string- file (string)
line int- line (int)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) print_at
pub fn (l &mut Logger) print_at(file string, line int, args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: print at.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
file string- file (string)
line int- line (int)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) printf_at
pub fn (l &mut Logger) printf_at(file string, line int, f string, args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: printf at.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
file string- file (string)
line int- line (int)
f string- callback or format string (string)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) fatal_at
pub fn (l &mut Logger) fatal_at(file string, line int, args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: fatal at.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
file string- file (string)
line int- line (int)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) print
pub fn (l &mut Logger) print(args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: print.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) println
pub fn (l &mut Logger) println(args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: print with a newline.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) printf
pub fn (l &mut Logger) printf(f string, args <-> fmt.Arg)
Purpose
Method on `&mut Logger`: print using a format string.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
f string- callback or format string (string)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
(&mut Logger) fatal
pub fn (l &mut Logger) fatal(args <-> fmt.Arg)
Purpose
Call `fatal` on `&mut Logger`.
Parameters
l &mut Logger- receiver &mut Logger (exclusive borrow)
args <-> fmt.Arg- variadic fmt.Arg (seen inside the function as []fmt.Arg)
