1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
//===----------------- OSLogSwiftProtocols.swift -----------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2020 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
// This file defines extensions for interpolating types conforming to common
// Swift protocols. It defines `appendInterpolation` overloads for these protocols.
// All overloads defined in this file, delegate to other appendInterpolation
// functions for types natively supported by os_log.
extension OSLogInterpolation {
/// Defines interpolation for values conforming to CustomStringConvertible. The values
/// are displayed using the description methods on them.
///
/// Do not call this function directly. It will be called automatically when interpolating
/// a value conforming to CustomStringConvertible in the string interpolations passed
/// to the log APIs.
///
/// - Parameters:
/// - value: The interpolated expression conforming to CustomStringConvertible.
/// - align: Left or right alignment with the minimum number of columns as
/// defined by the type `OSLogStringAlignment`.
/// - privacy: A privacy qualifier which is either private or public.
/// It is auto-inferred by default.
@_optimize(none)
@_transparent
@_semantics("oslog.requires_constant_arguments")
public mutating func appendInterpolation<T : CustomStringConvertible>(
_ value: @autoclosure @escaping () -> T,
align: OSLogStringAlignment = .none,
privacy: OSLogPrivacy = .auto
) {
// TODO: Dead code elimination does not remove the call to the default value
// of alignment: .none. This function is made @_transparent to work around
// that.
appendInterpolation(value().description, align: align, privacy: privacy)
}
/// Defines interpolation for meta-types.
///
/// Do not call this function directly. It will be called automatically when interpolating
/// a value of type `Any.Type` in the string interpolations passed to the log APIs.
///
/// - Parameters:
/// - value: An interpolated expression of type Any.Type, which is autoclosured.
/// - align: Left or right alignment with the minimum number of columns as
/// defined by the type `OSLogStringAlignment`.
/// - privacy: A privacy qualifier which is either private or public.
/// It is auto-inferred by default.
@_semantics("constant_evaluable")
@inlinable
@_optimize(none)
@_semantics("oslog.requires_constant_arguments")
public mutating func appendInterpolation(
_ value: @autoclosure @escaping () -> Any.Type,
align: OSLogStringAlignment = .none,
privacy: OSLogPrivacy = .auto
) {
appendInterpolation(
_typeName(value(), qualified: false),
align: align,
privacy: privacy)
}
}
|
