Skip to content

Remove String APIs currently implemented in swift-foundation #4946

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 6, 2024
Merged

Remove String APIs currently implemented in swift-foundation #4946

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
137 changes: 0 additions & 137 deletions Sources/Foundation/NSStringAPI.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -669,47 +669,6 @@ extension StringProtocol {
return _ns.canBeConverted(to: encoding.rawValue)
}

// @property NSString* capitalizedString

/// A copy of the string with each word changed to its corresponding
/// capitalized spelling.
///
/// This property performs the canonical (non-localized) mapping. It is
/// suitable for programming operations that require stable results not
/// depending on the current locale.
///
/// A capitalized string is a string with the first character in each word
/// changed to its corresponding uppercase value, and all remaining
/// characters set to their corresponding lowercase values. A "word" is any
/// sequence of characters delimited by spaces, tabs, or line terminators.
/// Some common word delimiting punctuation isn't considered, so this
/// property may not generally produce the desired results for multiword
/// strings. See the `getLineStart(_:end:contentsEnd:for:)` method for
/// additional information.
///
/// Case transformations aren’t guaranteed to be symmetrical or to produce
/// strings of the same lengths as the originals.
public var capitalized: String {
return _ns.capitalized as String
}

// @property (readonly, copy) NSString *localizedCapitalizedString NS_AVAILABLE(10_11, 9_0);

/// A capitalized representation of the string that is produced
/// using the current locale.
@available(macOS 10.11, iOS 9.0, *)
public var localizedCapitalized: String {
return _ns.localizedCapitalized
}

// - (NSString *)capitalizedStringWithLocale:(Locale *)locale

/// Returns a capitalized representation of the string
/// using the specified locale.
public func capitalized(with locale: Locale?) -> String {
return _ns.capitalized(with: locale) as String
}

// - (NSComparisonResult)caseInsensitiveCompare:(NSString *)aString

/// Returns the result of invoking `compare:options:` with
Expand Down Expand Up @@ -863,44 +822,6 @@ extension StringProtocol {
return _ns.components(separatedBy: separator)
}

// - (NSArray *)componentsSeparatedByString:(NSString *)separator

/// Returns an array containing substrings from the string that have been
/// divided by the given separator.
///
/// The substrings in the resulting array appear in the same order as the
/// original string. Adjacent occurrences of the separator string produce
/// empty strings in the result. Similarly, if the string begins or ends
/// with the separator, the first or last substring, respectively, is empty.
/// The following example shows this behavior:
///
/// let list1 = "Karin, Carrie, David"
/// let items1 = list1.components(separatedBy: ", ")
/// // ["Karin", "Carrie", "David"]
///
/// // Beginning with the separator:
/// let list2 = ", Norman, Stanley, Fletcher"
/// let items2 = list2.components(separatedBy: ", ")
/// // ["", "Norman", "Stanley", "Fletcher"
///
/// If the list has no separators, the array contains only the original
/// string itself.
///
/// let name = "Karin"
/// let list = name.components(separatedBy: ", ")
/// // ["Karin"]
///
/// - Parameter separator: The separator string.
/// - Returns: An array containing substrings that have been divided from the
/// string using `separator`.
// FIXME(strings): now when String conforms to Collection, this can be
// replaced by split(separator:maxSplits:omittingEmptySubsequences:)
public func components<
T : StringProtocol
>(separatedBy separator: T) -> [String] {
return _ns.components(separatedBy: separator._ephemeralString)
}

// - (const char *)cStringUsingEncoding:(NSStringEncoding)encoding

/// Returns a representation of the string as a C string
Expand Down Expand Up @@ -1022,24 +943,6 @@ extension StringProtocol {
//===--- Omitted for consistency with API review results 5/20/2014 ------===//
// @property long long longLongValue

// @property (readonly, copy) NSString *localizedLowercase NS_AVAILABLE(10_11, 9_0);

/// A lowercase version of the string that is produced using the current
/// locale.
@available(macOS 10.11, iOS 9.0, *)
public var localizedLowercase: String {
return _ns.localizedLowercase
}

// - (NSString *)lowercaseStringWithLocale:(Locale *)locale

/// Returns a version of the string with all letters
/// converted to lowercase, taking into account the specified
/// locale.
public func lowercased(with locale: Locale?) -> String {
return _ns.lowercased(with: locale)
}

// - (NSUInteger)maximumLengthOfBytesUsingEncoding:(NSStringEncoding)enc

/// Returns the maximum number of bytes needed to store the
Expand Down Expand Up @@ -1262,24 +1165,6 @@ extension StringProtocol {
return _ns.trimmingCharacters(in: set)
}

// @property (readonly, copy) NSString *localizedUppercaseString NS_AVAILABLE(10_11, 9_0);

/// An uppercase version of the string that is produced using the current
/// locale.
@available(macOS 10.11, iOS 9.0, *)
public var localizedUppercase: String {
return _ns.localizedUppercase as String
}

// - (NSString *)uppercaseStringWithLocale:(Locale *)locale

/// Returns a version of the string with all letters
/// converted to uppercase, taking into account the specified
/// locale.
public func uppercased(with locale: Locale?) -> String {
return _ns.uppercased(with: locale)
}

//===--- Omitted due to redundancy with "utf8" property -----------------===//
// - (const char *)UTF8String

Expand Down Expand Up @@ -1569,17 +1454,6 @@ extension StringProtocol {
// @property BOOL absolutePath;
// - (BOOL)isEqualToString:(NSString *)aString

// - (NSRange)lineRangeForRange:(NSRange)aRange

/// Returns the range of characters representing the line or lines
/// containing a given range.
public func lineRange<
R : RangeExpression
>(for aRange: R) -> Range<Index> where R.Bound == Index {
return _toRange(_ns.lineRange(
for: _toRelativeNSRange(aRange.relative(to: self))))
}

#if !DEPLOYMENT_RUNTIME_SWIFT
// - (NSArray *)
// linguisticTagsInRange:(NSRange)range
Expand Down Expand Up @@ -1617,17 +1491,6 @@ extension StringProtocol {

return result as! [String]
}

// - (NSRange)paragraphRangeForRange:(NSRange)aRange

/// Returns the range of characters representing the
/// paragraph or paragraphs containing a given range.
public func paragraphRange<
R : RangeExpression
>(for aRange: R) -> Range<Index> where R.Bound == Index {
return _toRange(
_ns.paragraphRange(for: _toRelativeNSRange(aRange.relative(to: self))))
}
#endif

// - (NSRange)rangeOfCharacterFromSet:(NSCharacterSet *)aSet
Expand Down