File: Source.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 (106 lines) | stat: -rw-r--r-- 2,888 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
106
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2021-2022 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
//
//===----------------------------------------------------------------------===//

// For now, we use String as the source while prototyping...

/// The source of text being given to a parser.
///
/// This can be bytes in memory, a file on disk,
/// something streamed over a network connection, and so on.
///
public struct Source {
  var input: Input
  var bounds: Range<Input.Index>

  // TODO: source should hold outer collection and range, at least
  // for error reporting if nothing else

  init(_ str: Input) {
    self.input = str
    self.bounds = str.startIndex ..< str.endIndex
  }

  subscript(_ range: Range<Input.Index>) -> Input.SubSequence { input[range] }
}

// MARK: - Prototype uses String

// For prototyping, base everything on String. Might be buffer
// of bytes, etc., in the future
extension Source {
  public typealias Input = String    // for wrapper...
  public typealias Char  = Character // for wrapper...

  /// A precise point in the input, commonly used for bounded ranges.
  public typealias Position = String.Index
}

// MARK: - Source as a peekable consumer

extension Source {
  var _slice: Input.SubSequence { input[bounds] }

  var isEmpty: Bool { _slice.isEmpty }

  func peek() -> Char? { _slice.first }

  @discardableResult
  mutating func tryAdvance(_ n: Int = 1) -> Bool {
    guard n > 0, let newLower = _slice.index(
      bounds.lowerBound, offsetBy: n, limitedBy: bounds.upperBound)
    else {
      return false
    }
    self.bounds = newLower ..< bounds.upperBound
    return true
  }

  mutating func eat(upToCount count: Int) -> Input.SubSequence {
    let pre = _slice.prefix(count)
    tryAdvance(pre.count)
    return pre
  }

  mutating func tryEatPrefix(
    maxLength: Int? = nil,
    _ f: (Char) -> Bool
  ) -> Input.SubSequence? {
    guard let pre = peekPrefix(maxLength: maxLength, f) else { return nil }
    tryAdvance(pre.count)
    return pre
  }

  mutating func tryEat(count: Int) -> Input.SubSequence? {
    let pre = _slice.prefix(count)
    guard tryAdvance(count) else { return nil }
    return pre
  }

  func starts<S: Sequence>(with s: S) -> Bool where S.Element == Char {
    _slice.starts(with: s)
  }

  func peekPrefix(
    maxLength: Int? = nil,
    _ f: (Char) -> Bool
  ) -> Input.SubSequence? {
    let chunk: Input.SubSequence
    if let maxLength = maxLength {
      chunk = _slice.prefix(maxLength)
    } else {
      chunk = _slice[...]
    }
    let pre = chunk.prefix(while: f)
    guard !pre.isEmpty else { return nil }

    return pre
  }
}