FilePath appeared in System 0.0.1 with a minimal API. This proposal adds API for syntactic operations, which are performed on the structure of the path and thus do not consult with the file system or make any system calls. These include inspecting the structure of paths, modifying paths, and accessing individual components.
FilePath appeared in System 0.0.1 with a minimal API. This proposal adds API for syntactic operations, which are performed on the structure of the path and thus do not consult with the file system or make any system calls. These include inspecting the structure of paths, modifying paths, and accessing individual components.
Additionally, this proposal greatly expands Windows support and enables writing platform-agnostic path manipulation code.
Future Work: Operations that consult the file system, e.g. resolving symlinks.
.start and .end, now all OffsetBounds are built from .first and .last.
.last + 1 representing the end is mostly only relevant to documentation.OffsetBound abstraction and terminology from indices..insert(at:), .remove(at:), etc.,
| struct StringFormatters { | |
| var text = "Hello, World!" | |
| } | |
| /* | |
| This is the master template for fprintf format string functionality. | |
| For development purposes only | |
| ``` |
| /// | |
| /// Collection Consumers | |
| /// | |
| protocol CollectionConsumer { | |
| associatedtype Element | |
| func consumeFront<C: Collection>(_ c: C) -> C.Index? where C.Element == Element | |
| } |
| // The below will be a customization point on Collection. For the purposes of | |
| // this gist, we'll fake/approximate it with static overloads | |
| extension Collection { | |
| /// Returns an index `distance` positions prior to `i` if it exists. | |
| /// | |
| /// Other methods such as `index(_:offetBy:)` must not be passed a negative | |
| /// offset if the collection is bidirectional. This method will perform a | |
| /// negative offset even if the collection is not bidirectional, by using a | |
| /// less efficient means. `BidirectionalCollection` customizes this with a |
| // TODO: doc | |
| public struct OffsetBound { | |
| internal enum Kind { | |
| case fromStart(Int) | |
| case fromEnd(Int) | |
| } | |
| internal var kind: Kind | |
| internal init(fromStart: Int) { | |
| self.kind = .fromStart(fromStart) |
| // TODO: doc | |
| public struct OffsetBound { | |
| internal enum Kind { | |
| case fromStart(Int) | |
| case fromEnd(Int) | |
| } | |
| internal var kind: Kind | |
| internal init(fromStart: Int) { | |
| self.kind = .fromStart(fromStart) |
| // TODO: doc | |
| public struct OffsetBound<Bound> { | |
| internal enum Kind { | |
| case fromStart(Int) | |
| case fromEnd(Int) | |
| } | |
| internal var kind: Kind | |
| public init(fromStart: Int) { | |
| self.kind = .fromStart(fromStart) |
| // TODO: doc | |
| public struct OffsetBound { | |
| internal enum Kind { | |
| case fromStart(Int) | |
| case fromEnd(Int) | |
| } | |
| internal var kind: Kind | |
| public init(fromStart: Int) { | |
| self.kind = .fromStart(fromStart) |