averello/swift-mirror
1
0
Fork 0
mirror of https://github.com/apple/swift.git synced 2026-06-20 15:42:51 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
swift-mirror/stdlib/stdlib.docc/String.md
T
Graham Lee 9ead8781d4 Add .docc catalog to publish stdlib docs on swift.org 
Co-authored-by: Alex Martini <amartini@apple.com>
Co-authored-by: Graham Lee <glee23@apple.com>
Co-authored-by: Chris Adamson <cadamson@apple.com>
Co-authored-by: Kirby Turner <kirby_turner@apple.com>
Co-authored-by: Paris Pinkney <ppinkney@apple.com>
Co-authored-by: Dave Spector <dspector@apple.com>
Co-authored-by: Sofia Rodriguez Morales <sofia_rodriguez@apple.com>
Co-authored-by: Ethan Kusters <ekusters@apple.com>
Co-authored-by: Goli Mohammadi <g_mohammadi@apple.com>
Co-authored-by: Adora Vaz <a_vaz@apple.com>
Co-authored-by: David Rönnqvist <ronnqvist@apple.com>
Co-authored-by: Nate Merseth Cook <natecook@apple.com>
Co-authored-by: Susan Conant <susan_c@apple.com>
2026-04-10 10:04:56 -04:00

342 lines
9.9 KiB
Markdown
Raw Permalink Blame History

# ``Swift/String``
## Topics
### Creating a String
In addition to creating a string from a single string literal, you can also create
an empty string, a string containing an existing group of characters, or a string
repeating the contents of another string.
- ``Swift/String/init()``
- ``Swift/String/init(_:)-8v3fo``
- ``Swift/String/init(_:)-8og6g``
- ``Swift/String/init(_:)-1ip93``
- ``Swift/String/init(_:)-50pwi``
- ``Swift/String/init(_:)-14lv5``
- ``Swift/String/init(repeating:count:)-23xjt``
- ``Swift/String/init(repeating:count:)-11bpi``
- ``Swift/String/init(unsafeUninitializedCapacity:initializingUTF8With:)``
### Inspecting a String
- ``Swift/String/isEmpty-vc7l``
- ``Swift/String/count-7qyfb``
### Creating a String from Unicode Data
- ``Swift/String/init(_:)-8ay23``
- ``Swift/String/init(validatingUTF8:)-208fn``
- ``Swift/String/init(validating:as:)-(Sequence<Encoding.CodeUnit>,_)``
- ``Swift/String/init(validating:as:)-(Sequence<Int8>,_)``
- ``Swift/String/init(decoding:as:)``
- ``Swift/String/init(_:)-3rgu``
- ``Swift/String/init(copying:)``
### Converting Numeric Values
- ``Swift/String/init(_:radix:uppercase:)``
### Converting a C String
- ``Swift/String/init(validatingCString:)-992vo``
- ``Swift/String/init(validatingCString:)-98wra``
- ``Swift/String/init(cString:)-2p84k``
- ``Swift/String/init(cString:)-6kr8s``
- ``Swift/String/init(decodingCString:as:)-8way7``
- ``Swift/String/decodeCString(_:as:repairingInvalidCodeUnits:)-46n2p``
- ``Swift/String/init(cString:)-472zs``
- ``Swift/String/init(cString:)-54awj``
### Converting a C++ String
- ``Swift/String/init(_:)-4bhtc``
- ``Swift/String/init(_:)-753pq``
- ``Swift/String/init(_:)-779lt``
- ``Swift/String/init(_:)-7i93e``
- ``Swift/String/init(_:)-871md``
- ``Swift/String/init(_:)-8h97e``
- ``Swift/String/init(_:)-lk68``
- ``Swift/String/init(_:)-p219``
### Converting Other Types to Strings
- ``Swift/String/init(_:)-1ywfq``
- ``Swift/String/init(describing:)-588wb``
- ``Swift/String/init(describing:)-hsqw``
- ``Swift/String/init(describing:)-6ttci``
- ``Swift/String/init(describing:)-67ncf``
- ``Swift/String/init(reflecting:)``
### Writing to a File or URL
- ``Swift/String/write(_:)``
- ``Swift/String/write(to:)``
### Appending Strings and Characters
- ``Swift/String/append(_:)-4xa8f``
- ``Swift/String/append(_:)-4xi3j``
- ``Swift/String/append(contentsOf:)-oxek``
- ``Swift/String/append(contentsOf:)-9vb4t``
- ``Swift/String/append(contentsOf:)-7est5``
- ``Swift/String/append(contentsOf:)-9foms``
- ``Swift/String/reserveCapacity(_:)-1ozk3``
- ``Swift/String/+(_:_:)-655mi``
- ``Swift/String/+=(_:_:)-4pvxa``
- ``Swift/String/+(_:_:)-6h59y``
- ``Swift/String/+(_:_:)-n329``
- ``Swift/String/+(_:_:)-9fm57``
- ``Swift/String/+=(_:_:)-676gx``
### Inserting Characters
- ``Swift/String/insert(_:at:)-1uqvy``
- ``Swift/String/insert(_:at:)-88yqh``
- ``Swift/String/insert(contentsOf:at:)-rdu9``
- ``Swift/String/insert(contentsOf:at:)-4may``
### Replacing Substrings
- ``Swift/String/replaceSubrange(_:with:)-1wyxa``
- ``Swift/String/replaceSubrange(_:with:)-72947``
### Removing Substrings
- ``Swift/String/remove(at:)-4n29z``
- ``Swift/String/remove(at:)-5g0wm``
- ``Swift/String/removeAll(keepingCapacity:)-b1dr``
- ``Swift/String/removeAll(where:)``
- ``Swift/String/removeFirst()``
- ``Swift/String/removeFirst(_:)``
- ``Swift/String/removeLast()``
- ``Swift/String/removeLast(_:)``
- ``Swift/String/removeSubrange(_:)-8y51u``
- ``Swift/String/removeSubrange(_:)-8maxn``
- ``Swift/String/removeSubrange(_:)-9twng``
- ``Swift/String/filter(_:)``
- ``Swift/String/drop(while:)``
- ``Swift/String/dropFirst(_:)``
- ``Swift/String/dropLast(_:)``
- ``Swift/String/popLast()``
### Changing Case
- ``Swift/String/lowercased()``
- ``Swift/String/uppercased()``
### Comparing Strings Using Operators
Comparing strings using the equal-to operator (==) or a relational operator (like
&lt; and &gt;=) is always performed using the Unicode canonical representation, so
that different representations of a string compare as being equal.
- ``Swift/String/==(_:_:)-9812z``
- ``Swift/String/==(_:_:)-8kzxf``
- ``Swift/String/!=(_:_:)-1bb05``
- ``Swift/String/!=(_:_:)-frzf``
- ``Swift/String/<(_:_:)-1incq``
- ``Swift/String/<(_:_:)-8d1wy``
- ``Swift/String/<=(_:_:)-1ih6``
- ``Swift/String/<=(_:_:)-5y22v``
- ``Swift/String/>(_:_:)-24u5x``
- ``Swift/String/>(_:_:)-6o7qv``
- ``Swift/String/>=(_:_:)-8lyim``
- ``Swift/String/>=(_:_:)-nd86``
- ``Swift/String/~=(_:_:)``
### Comparing Characters
- ``Swift/String/elementsEqual(_:)``
- ``Swift/String/elementsEqual(_:by:)``
- ``Swift/String/starts(with:)``
- ``Swift/String/starts(with:by:)``
- ``Swift/String/lexicographicallyPrecedes(_:)``
- ``Swift/String/lexicographicallyPrecedes(_:by:)``
### Creating and Applying Differences
- ``Swift/String/applying(_:)``
- ``Swift/String/difference(from:)``
- ``Swift/String/difference(from:by:)``
### Finding Substrings
- ``Swift/String/hasPrefix(_:)``
- ``Swift/String/hasSuffix(_:)``
### Finding Characters
- ``Swift/String/characters``
- ``Swift/String/utf8Span``
- ``Swift/String/contains(_:)``
- ``Swift/String/allSatisfy(_:)``
- ``Swift/String/contains(where:)``
- ``Swift/String/first(where:)``
- ``Swift/String/firstIndex(of:)``
- ``Swift/String/firstIndex(where:)``
- ``Swift/String/last(where:)``
- ``Swift/String/lastIndex(of:)``
- ``Swift/String/lastIndex(where:)``
- ``Swift/String/max()``
- ``Swift/String/max(_:_:)``
- ``Swift/String/max(by:)``
- ``Swift/String/min()``
- ``Swift/String/min(_:_:)``
- ``Swift/String/min(by:)``
- ``Swift/String/characterMap()``
- ``Swift/String/scalarMap()``
### Getting Substrings
- ``Swift/String/subscript(_:)-2so14``
- ``Swift/String/subscript(_:)-4h7s3``
- ``Swift/String/subscript(_:)-4al9c``
- ``Swift/String/prefix(_:)``
- ``Swift/String/prefix(through:)``
- ``Swift/String/prefix(upTo:)``
- ``Swift/String/prefix(while:)``
- ``Swift/String/suffix(_:)``
- ``Swift/String/suffix(from:)``
### Splitting a String
- ``Swift/String/split(separator:maxSplits:omittingEmptySubsequences:)``
- ``Swift/String/split(maxSplits:omittingEmptySubsequences:whereSeparator:)``
### Getting Characters and Bytes
- ``Swift/String/subscript(_:)-lc0v``
- ``Swift/String/first``
- ``Swift/String/last``
- ``Swift/String/randomElement()``
- ``Swift/String/randomElement(using:)``
### Working with Encodings
- ``Swift/String/isContiguousUTF8``
- ``Swift/String/makeContiguousUTF8()``
- ``Swift/String/withUTF8(_:)``
### Working with String Views
- ``Swift/String/unicodeScalars``
- ``Swift/String/UnicodeScalarIndex``
- ``Swift/String/init(_:)-2t931``
- ``Swift/String/init(_:)-11jx3``
- ``Swift/String/utf16``
- ``Swift/String/init(_:)-wbcx``
- ``Swift/String/init(_:)-expd``
- ``Swift/String/utf8``
- ``Swift/String/init(_:)-6sprj``
- ``Swift/String/init(_:)-83bub``
### Transforming a String's Characters
- ``Swift/String/compactMap(_:)``
- ``Swift/String/flatMap(_:)-i3m9``
- ``Swift/String/flatMap(_:)-6chuq``
- ``Swift/String/reduce(_:_:)``
- ``Swift/String/reduce(into:_:)``
- ``Swift/String/lazy``
- ``Swift/String/withMutableCharacters(_:)``
### Iterating over a String's Characters
- ``Swift/String/forEach(_:)``
- ``Swift/String/enumerated()``
- ``Swift/String/makeIterator()``
- ``Swift/String/underestimatedCount-4ggs3``
### Reordering a String's Characters
- ``Swift/String/sorted()``
- ``Swift/String/sorted(by:)``
- ``Swift/String/reversed()``
- ``Swift/String/shuffled()``
- ``Swift/String/shuffled(using:)``
### Getting C Strings
- ``Swift/String/utf8CString``
- ``Swift/String/withCString(_:)``
- ``Swift/String/withCString(encodedAs:_:)``
### Working with Paths
- ``Swift/String/init(validatingUTF8:)-(String)``
- ``Swift/String/init(validatingUTF8:)-(UnsafePointer<CChar>)``
- ``Swift/String/init(validatingUTF8:)-([CChar])``
- ``Swift/String/init(validatingUTF8:)-(CChar)``
### Manipulating Indices
- ``Swift/String/startIndex``
- ``Swift/String/endIndex``
- ``Swift/String/allIndices(includingEnd:)``
- ``Swift/String/dumpIndices()``
- ``Swift/String/index(after:)``
- ``Swift/String/formIndex(after:)``
- ``Swift/String/index(before:)``
- ``Swift/String/formIndex(before:)``
- ``Swift/String/index(_:offsetBy:)``
- ``Swift/String/index(_:offsetBy:limitedBy:)``
- ``Swift/String/formIndex(_:offsetBy:)``
- ``Swift/String/formIndex(_:offsetBy:limitedBy:)``
- ``Swift/String/distance(from:to:)``
- ``Swift/String/isOnGraphemeClusterBoundary(_:)``
- ``Swift/String/indices-swift.property``
### Creating a Range Expression
- ``Swift/String/..<(_:_:)``
- ``Swift/String/...(_:_:)``
- ``Swift/String/..<(_:)``
- ``Swift/String/...(_:)-4mm4o``
- ``Swift/String/...(_:)-6ct5g``
### Encoding and Decoding
- ``Swift/String/encode(to:)``
- ``Swift/String/init(from:)-qki5``
### Describing a String
- ``Swift/String/description``
- ``Swift/String/debugDescription``
- ``Swift/String/customMirror``
- ``Swift/String/hash(into:)``
### Infrequently Used Functionality
- ``Swift/String/index(of:)``
- ``Swift/String/init(stringInterpolation:)-1jjv``
- ``Swift/String/init(stringLiteral:)``
- ``Swift/String/init(unicodeScalarLiteral:)``
- ``Swift/String/init(extendedGraphemeClusterLiteral:)``
- ``Swift/String/customPlaygroundQuickLook``
- ``Swift/String/withContiguousStorageIfAvailable(_:)``
- ``Swift/String/init(cString:)-1gatt``
- ``Swift/String/init(cString:)-295hy``
- ``Swift/String/init(cString:)-cgw2``
- ``Swift/String/init(decodingCString:as:)-2zmjc``
- ``Swift/String/init(decodingCString:as:)-534rp``
- ``Swift/String/init(validatingCString:)-1x5p0``
- ``Swift/String/init(validatingCString:)-7gjlg``
- ``Swift/String/IndexDistance``
- ``Swift/String/decodeCString(_:as:repairingInvalidCodeUnits:)-2l7u6``
- ``Swift/String/decodeCString(_:as:repairingInvalidCodeUnits:)-9pdmv``
- ``Swift/String/decodeCString(_:as:repairingInvalidCodeUnits:)-3mvvy``
### Related String Types
- ``Swift/Substring``
- ``Swift/StringProtocol``
- ``Swift/String/Index``
- ``Swift/String/CharacterView``
- ``Swift/String/UnicodeScalarView``
- ``Swift/String/UTF16View``
- ``Swift/String/UTF8View``
- ``Swift/String/Iterator``
- ``Swift/String/Output``
Reference in New Issue View Git Blame Copy Permalink