Function

os_log(_:dso:log:type:_:)

Sends a message to the logging system, optionally specifying a custom log object, log level, and any message format arguments.

Declaration

func os_log(_ message: StaticString, dso: UnsafeRawPointer? = #dsohandle, log: OSLog = default, type: OSLogType = default, _ args: CVarArg...)

Parameters

message

A constant string or format string that produces a human-readable log message.

log

A custom log object. If unspecified, the shared default log is used.

type

The log level. If unspecified, the default log level is used.

args

If message is a constant string, do not specify arguments.

If message is a format string, pass the expected number of arguments in the order that they appear in the string.

Discussion

Call this function to capture information about things that might result a failure. Default-level messages sent by this function are initially stored in memory. Without a configuration change, they are moved to the data store as memory buffers fill. They remain there until the storage quota is exceeded, at which point, the oldest messages are purged.For more information about format strings, see Formatting Log Messages.