Type Method

string(withContentsOf:)

Returns a string created by reading data from the file named by a given URL.

Declaration

class func string(withContentsOf url: URL) -> Any?

Discussion

If the contents begin with a byte-order mark (U+FEFF or U+FFFE), interprets the contents as UTF-16 code units. If the contents begin with a UTF-8 byte-order mark (EFBBBF), interprets the contents as UTF-8. Otherwise interprets the contents as data in the default C string encoding. Since the default C string encoding will vary with the user’s configuration, do not depend on this method unless you are using Unicode or UTF-8 or you can verify the default C string encoding. Returns nil if the location can’t be opened.

See Also

Deprecated

class func string(withCString: UnsafePointer<Int8>)

Creates a new string using a given C-string.

Deprecated
init?(cString: UnsafePointer<Int8>)

Initializes the receiver, a newly allocated NSString object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.

Deprecated
class func string(withCString: UnsafePointer<Int8>, length: Int)

Returns a string containing the characters in a given C-string.

Deprecated
init?(cString: UnsafePointer<Int8>, length: Int)

Initializes the receiver, a newly allocated NSString object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.

Deprecated
init?(cStringNoCopy: UnsafeMutablePointer<Int8>, length: Int, freeWhenDone: Bool)

Initializes the receiver, a newly allocated NSString object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.

Deprecated
class func string(withContentsOfFile: String)

Returns a string created by reading data from the file named by a given path.

Deprecated
init?(contentsOfFile: String)

Initializes the receiver, a newly allocated NSString object, by reading data from the file named by path.

Deprecated
init?(contentsOf: URL)

Initializes the receiver, a newly allocated NSString object, by reading data from the location named by a given URL.

Deprecated
func write(toFile: String, atomically: Bool)

Writes the contents of the receiver to the file specified by a given path.

Deprecated
func write(to: URL, atomically: Bool)

Writes the contents of the receiver to the location specified by a given URL.

Deprecated
func getCharacters(UnsafeMutablePointer<unichar>)

Copies all characters from the receiver into a given buffer.

Deprecated
func cString()

Returns a representation of the receiver as a C string in the default C-string encoding.

Deprecated
func lossyCString()

Returns a representation of the receiver as a C string in the default C-string encoding, possibly losing information in converting to that encoding.

Deprecated
func cStringLength()

Returns the length in char-sized units of the receiver’s C-string representation in the default C-string encoding.

Deprecated
func getCString(UnsafeMutablePointer<Int8>)

Invokes getCString(_:maxLength:range:remaining:) with NSMaximumStringLength as the maximum length, the receiver’s entire extent as the range, and NULL for the remaining range.

Deprecated
func getCString(UnsafeMutablePointer<Int8>, maxLength: Int)

Invokes getCString(_:maxLength:range:remaining:) with maxLength as the maximum length in char-sized units, the receiver’s entire extent as the range, and NULL for the remaining range.

Deprecated
func getCString(UnsafeMutablePointer<Int8>, maxLength: Int, range: NSRange, remaining: NSRangePointer?)

Converts the receiver’s content to the default C-string encoding and stores them in a given buffer.

Deprecated
func addingPercentEscapes(using: UInt)

Returns a representation of the receiver using a given encoding to determine the percent escapes necessary to convert the receiver into a legal URL string.

Deprecated
func replacingPercentEscapes(using: UInt)

Returns a new string made by replacing in the receiver all percent escapes with the matching characters as determined by a given encoding.

Deprecated
func draw(with: NSRect, options: NSString.DrawingOptions = [], attributes: [NSAttributedStringKey : Any]? = nil)

Draws the receiver with the specified options and other display characteristics of the given attributes, within the specified rectangle in the current graphics context.

Deprecated
func boundingRect(with: NSSize, options: NSString.DrawingOptions = [], attributes: [NSAttributedStringKey : Any]? = nil)

Calculates and returns the bounding rect for the receiver drawn using the given options and display characteristics, within the specified rectangle in the current graphics context.

Deprecated