// Copyright © 2022 Rangeproof Pty Ltd. All rights reserved. import Foundation import CoreText public extension String { var bytes: [UInt8] { Array(self.utf8) } var nullIfEmpty: String? { guard isEmpty else { return self } return nil } var glyphCount: Int { let richText = NSAttributedString(string: self) let line = CTLineCreateWithAttributedString(richText) return CTLineGetGlyphCount(line) } var isSingleAlphabet: Bool { return (glyphCount == 1 && isAlphabetic) } var isAlphabetic: Bool { return !isEmpty && range(of: "[^a-zA-Z]", options: .regularExpression) == nil } var isSingleEmoji: Bool { return (glyphCount == 1 && containsEmoji) } var containsEmoji: Bool { return unicodeScalars.contains { $0.isEmoji } } var containsOnlyEmoji: Bool { return ( !isEmpty && !unicodeScalars.contains(where: { !$0.isEmoji && !$0.isZeroWidthJoiner }) ) } func localized() -> String { // If the localized string matches the key provided then the localisation failed let localizedString = NSLocalizedString(self, comment: "") Log.assert(localizedString != self, "Key \"\(self)\" is not set in Localizable.strings") return localizedString } func ranges(of substring: String, options: CompareOptions = [], locale: Locale? = nil) -> [Range] { var ranges: [Range] = [] while (ranges.last.map({ $0.upperBound < self.endIndex }) ?? true), let range = self.range( of: substring, options: options, range: (ranges.last?.upperBound ?? self.startIndex).. String? { guard let text = text?.filteredForDisplay else { return nil } // iOS strips anything that looks like a printf formatting character from // the notification body, so if we want to dispay a literal "%" in a notification // it must be escaped. // see https://developer.apple.com/documentation/uikit/uilocalnotification/1616646-alertbody // for more details. return text.replacingOccurrences(of: "%", with: "%%") } } // MARK: - Formatting public extension String.StringInterpolation { mutating func appendInterpolation(_ value: TimeUnit, unit: TimeUnit.Unit, resolution: Int = 2) { appendLiteral("\(TimeUnit(value, unit: unit, resolution: resolution))") // stringlint:disable } mutating func appendInterpolation(_ value: Int, format: String) { let result: String = String(format: "%\(format)d", value) appendLiteral(result) } mutating func appendInterpolation(_ value: Double, format: String, omitZeroDecimal: Bool = false) { guard !omitZeroDecimal || Int(exactly: value) == nil else { appendLiteral("\(Int(exactly: value)!)") return } let result: String = String(format: "%\(format)f", value) appendLiteral(result) } } public extension String { static func formattedDuration(_ duration: TimeInterval, format: TimeInterval.DurationFormat = .short) -> String { let secondsPerMinute: TimeInterval = 60 let secondsPerHour: TimeInterval = (secondsPerMinute * 60) let secondsPerDay: TimeInterval = (secondsPerHour * 24) let secondsPerWeek: TimeInterval = (secondsPerDay * 7) switch format { case .videoDuration: let seconds: Int = Int(duration.truncatingRemainder(dividingBy: 60)) let minutes: Int = Int((duration / 60).truncatingRemainder(dividingBy: 60)) let hours: Int = Int(duration / 3600) guard hours > 0 else { return String(format: "%02ld:%02ld", minutes, seconds) } return String(format: "%ld:%02ld:%02ld", hours, minutes, seconds) case .hoursMinutesSeconds: let seconds: Int = Int(duration.truncatingRemainder(dividingBy: 60)) let minutes: Int = Int((duration / 60).truncatingRemainder(dividingBy: 60)) let hours: Int = Int(duration / 3600) guard hours > 0 else { return String(format: "%ld:%02ld", minutes, seconds) } return String(format: "%ld:%02ld:%02ld", hours, minutes, seconds) case .short: switch duration { case 0.. 0 else { return "" } return self.trimmingCharacters(in: .whitespacesAndNewlines) } private var hasExcessiveDiacriticals: Bool { for char in self.enumerated() { let scalarCount = String(char.element).unicodeScalars.count if scalarCount > 8 { return true } } return false } private var filterForExcessiveDiacriticals: String { guard hasExcessiveDiacriticals else { return self } return self.folding(options: .diacriticInsensitive, locale: .current) } private var ensureBalancedBidiControlCharacters: String { var isolateStartsCount: Int = 0 var isolatePopCount: Int = 0 var formattingStartsCount: Int = 0 var formattingPopCount: Int = 0 self.utf16.forEach { char in switch char { case CharacterSet.bidiLeftToRightIsolate, CharacterSet.bidiRightToLeftIsolate, CharacterSet.bidiFirstStrongIsolate: isolateStartsCount += 1 case CharacterSet.bidiPopDirectionalIsolate: isolatePopCount += 1 case CharacterSet.bidiLeftToRightEmbedding, CharacterSet.bidiRightToLeftEmbedding, CharacterSet.bidiLeftToRightOverride, CharacterSet.bidiRightToLeftOverride: formattingStartsCount += 1 case CharacterSet.bidiPopDirectionalFormatting: formattingPopCount += 1 default: break } } var balancedString: String = "" // If we have too many isolate pops, prepend FSI to balance while isolatePopCount > isolateStartsCount { balancedString.append("\(CharacterSet.bidiFirstStrongIsolate)") isolateStartsCount += 1 } // If we have too many formatting pops, prepend LRE to balance while formattingPopCount > formattingStartsCount { balancedString.append("\(CharacterSet.bidiLeftToRightEmbedding)") formattingStartsCount += 1 } balancedString.append(self) // If we have too many formatting starts, append PDF to balance while formattingStartsCount > formattingPopCount { balancedString.append("\(CharacterSet.bidiPopDirectionalFormatting)") formattingPopCount += 1 } // If we have too many isolate starts, append PDI to balance while isolateStartsCount > isolatePopCount { balancedString.append("\(CharacterSet.bidiPopDirectionalIsolate)") isolatePopCount += 1 } return balancedString } private var filterUnsafeFilenameCharacters: String { var unsafeCharacterSet: CharacterSet = CharacterSet.unsafeFilenameCharacterSet guard self.rangeOfCharacter(from: unsafeCharacterSet) != nil else { return self } var filtered = "" var remainder = self while let range = remainder.rangeOfCharacter(from: unsafeCharacterSet) { if range.lowerBound != remainder.startIndex { filtered += remainder[..