File: Formatter.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 (89 lines) | stat: -rw-r--r-- 3,715 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
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2016 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See http://swift.org/LICENSE.txt for license information
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//

extension Formatter {
    public enum Context : Int, Sendable {
        
        // The capitalization context to be used is unknown (this is the default value).
        case unknown

        // The capitalization context is determined dynamically from the set {NSFormattingContextStandalone, NSFormattingContextBeginningOfSentence, NSFormattingContextMiddleOfSentence}. For example, if a date is placed at the beginning of a sentence, NSFormattingContextBeginningOfSentence is used to format the string automatically. When this context is used, the formatter will return a string proxy that works like a normal string in most cases. After returning from the formatter, the string in the string proxy is formatted by using NSFormattingContextUnknown. When the string proxy is used in stringWithFormat:, we can determine where the %@ is and then set the context accordingly. With the new context, the string in the string proxy will be formatted again and be put into the final string returned from stringWithFormat:.
        case dynamic
        
        // The capitalization context if a date or date symbol is to be formatted with capitalization appropriate for stand-alone usage such as an isolated name on a calendar page.
        case standalone
        
        // The capitalization context if a date or date symbol is to be formatted with capitalization appropriate for a list or menu item.
        case listItem
        
        // The capitalization context if a date or date symbol is to be formatted with capitalization appropriate for the beginning of a sentence.
        case beginningOfSentence

        // The capitalization context if a date or date symbol is to be formatted with capitalization appropriate for the middle of a sentence.
        case middleOfSentence
    }

    /*
     * There are 3 widths: long, medium, and short.
     * For example, for English, when formatting "3 pounds"
     * Long is "3 pounds"; medium is "3 lb"; short is "3#";
     */

    public enum UnitStyle : Int, Sendable {
        
        case short
        case medium
        case long
    }
}

//@_nonSendable - TODO: Mark with attribute to indicate this pure abstract class defers Sendable annotation to its subclasses.
open class Formatter : NSObject, NSCopying, NSCoding {
    
    public override init() {
        
    }
    
    public required init?(coder: NSCoder) {
        
    }
    
    open func encode(with aCoder: NSCoder) {
        
    }
    
    open override func copy() -> Any {
        return copy(with: nil)
    }
    
    open func copy(with zone: NSZone? = nil) -> Any {
        return self
    }
    
    open func string(for obj: Any) -> String? {
        NSRequiresConcreteImplementation()
    }
    
    open func editingString(for obj: Any) -> String? {
        return string(for: obj)
    }
    
    @available(*, unavailable, message: "Use each formatter's class and instance methods instead.")
    open func objectValue(_ string: String) throws -> Any? {
        NSUnsupported()
    }
    
    @available(*, unavailable, message: "Use each formatter's class and instance methods instead.")
    func getObjectValue(_ obj: UnsafeMutablePointer<AnyObject?>?,
                        for string: String,
                        errorDescription error: UnsafeMutablePointer<NSString?>?) -> Bool {
        NSUnsupported()
    }
}