File: Expression%2BMacro.swift

package info (click to toggle)
swiftlang 6.0.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,519,992 kB
  • sloc: cpp: 9,107,863; ansic: 2,040,022; asm: 1,135,751; python: 296,500; objc: 82,456; f90: 60,502; lisp: 34,951; pascal: 19,946; sh: 18,133; perl: 7,482; ml: 4,937; javascript: 4,117; makefile: 3,840; awk: 3,535; xml: 914; fortran: 619; cs: 573; ruby: 573
file content (105 lines) | stat: -rw-r--r-- 4,434 bytes parent folder | download
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2023 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 Swift project authors
//

extension __Expression {
  /// Create an instance of this type representing a complete syntax node.
  ///
  /// - Parameters:
  ///   - syntaxNode: The complete syntax node (expression, declaration,
  ///     statement, etc.)
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromSyntaxNode(_ syntaxNode: String) -> Self {
    Self(kind: .generic(syntaxNode))
  }

  /// Create an instance of this type representing a string literal.
  ///
  /// - Parameters:
  ///   - sourceCode: The source code representation of the string literal,
  ///     including leading and trailing punctuation.
  ///   - stringValue: The actual string value of the string literal
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromStringLiteral(_ sourceCode: String, _ stringValue: String) -> Self {
    Self(kind: .stringLiteral(sourceCode: sourceCode, stringValue: stringValue))
  }

  /// Create an instance of this type representing a binary operation.
  ///
  /// - Parameters:
  ///   - lhs: The left-hand operand.
  ///   - op: The operator.
  ///   - rhs: The right-hand operand.
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromBinaryOperation(_ lhs: Self, _ op: String, _ rhs: Self) -> Self {
    return Self(kind: .binaryOperation(lhs: lhs, operator: op, rhs: rhs))
  }

  /// Create an instance of this type representing a function call.
  ///
  /// - Parameters:
  ///   - value: The value on which the member function is being invoked, if
  ///     any.
  ///   - functionName: The name of the member function.
  ///   - argumentLabel: Optionally, the argument label.
  ///   - argumentValue: The value of the argument to the function.
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromFunctionCall(_ value: Self?, _ functionName: String, _ arguments: (label: String?, value: Self)...) -> Self {
    let arguments = arguments.map(Kind.FunctionCallArgument.init)
    return Self(kind: .functionCall(value: value, functionName: functionName, arguments: arguments))
  }

  /// Create an instance of this type representing a property access.
  ///
  /// - Parameters:
  ///   - value: The value whose property was accessed.
  ///   - keyPath: The key path, relative to `value`, that was accessed, not
  ///     including a leading backslash or period.
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromPropertyAccess(_ value: Self, _ keyPath: Self) -> Self {
    return Self(kind: .propertyAccess(value: value, keyPath: keyPath))
  }

  /// Create an instance of this type representing a negated expression
  /// using the `!` operator..
  ///
  /// - Parameters:
  ///   - expression: The expression that was negated.
  ///   - isParenthetical: Whether or not `expression` was enclosed in
  ///     parentheses (and the `!` operator was outside it.) This argument
  ///     affects how this expression is represented as a string.
  ///
  /// - Returns: A new instance of this type.
  ///
  /// - Warning: This function is used to implement the `@Test`, `@Suite`,
  ///   `#expect()` and `#require()` macros. Do not call it directly.
  public static func __fromNegation(_ expression: Self, _ isParenthetical: Bool) -> Self {
    return Self(kind: .negation(expression, isParenthetical: isParenthetical))
  }
}