[iOS] class NSString : NSObject

Class

NSString

 

String에 연결되는 정적 일반 텍스트 유니 코드 문자열 객체입니다. 참조 의미론 또는 기타 Foundation 특정 동작이 필요한 경우 NSString을 사용하십시오.

A static, plain-text Unicode string object that bridges to String; use NSString when you need reference semantics or other Foundation-specific behavior.

 

Declaration

class NSString : NSObject

 

 

개요

NSString 클래스 및 가변 서브 클래스인 NSMutableString은 문자열 비교, 검색 및 수정을 위한 메소드를 포함하여 문자열 작업을 위한 광범위한 API 세트를 제공합니다. NSString 객체는 Foundation 및 기타 Cocoa 프레임 워크 전체에서 사용되며 플랫폼의 모든 텍스트 및 언어 기능의 기초가 됩니다.

NSString은 Core Foundation 대응 CFString과 무료로 브리지됩니다. 자세한 내용은 무료 브리지를 참조하십시오.

Overview

The NSString class and its mutable subclass, NSMutableString, provide an extensive set of APIs for working with strings, including methods for comparing, searching, and modifying strings. NSString objects are used throughout Foundation and other Cocoa frameworks, serving as the basis for all textual and linguistic functionality on the platform.

NSString is toll-free bridged with its Core Foundation counterpart, CFString. See Toll-Free Bridging for more information.

 

 

문자열 객체

NSString 객체는 UTF-16 코드 단위 시퀀스로 표시되는 유니 코드 호환 텍스트 문자열을 인코딩합니다. 모든 길이, 문자 색인 및 범위는 16 비트 플랫폼 엔디안 값으로 표현되며 색인 값은 0에서 시작합니다.

NSString 객체는 C 버퍼, NSData 객체 또는 NSURL의 내용으로 초기화되거나 기록 될 수 있습니다. 또한 ASCII, UTF–8, UTF–16, UTF–32 또는 NSStringEncoding으로 표시되는 다른 문자열 인코딩간에 인코딩 및 디코딩 될 수 있습니다.

String Objects

An NSString object encodes a Unicode-compliant text string, represented as a sequence of UTF–16 code units. All lengths, character indexes, and ranges are expressed in terms of 16-bit platform-endian values, with index values starting at 0.

An NSString object can be initialized from or written to a C buffer, an NSData object, or the contents of an NSURL. It can also be encoded and decoded to and from ASCII, UTF–8, UTF–16, UTF–32, or any other string encoding represented by NSStringEncoding.

 

노트

변경 불가능한 문자열은 작성 될 때 정의되어 나중에 변경할 수없는 텍스트 문자열입니다. 불변 문자열은 UTF-16 코드 단위의 배열 (즉, 텍스트 문자열)로 구현됩니다. 변경 불가능한 문자열을 만들고 관리하려면 NSString 클래스를 사용하십시오. 작성된 후 변경할 수있는 문자열을 구성하고 관리하려면 NSMutableString을 사용하십시오.

NSString 및 NSMutableString을 사용하여 생성 한 객체를 문자열 객체라고합니다 (또는 혼동이 발생하지 않는 경우 단순히 문자열로 표시). 용어 C 문자열은 표준 char * 유형을 나타냅니다.

클래스 클러스터의 특성으로 인해 문자열 객체는 NSString 또는 NSMutableString 클래스의 실제 인스턴스가 아니라 프라이빗 서브 클래스 중 하나입니다. 문자열 객체의 클래스는 비공개이지만 NSString 및 NSMutableString과 같은 추상 슈퍼 클래스에 의해 선언 된대로 해당 인터페이스는 공용입니다. 문자열 클래스는 NSCopying 및 NSMutableCopying 프로토콜을 채택하여 한 유형의 문자열을 다른 유형으로 편리하게 변환 할 수 있습니다.

Note

An immutable string is a text string that is defined when it is created and subsequently cannot be changed. An immutable string is implemented as an array of UTF–16 code units (in other words, a text string). To create and manage an immutable string, use the NSString class. To construct and manage a string that can be changed after it has been created, use NSMutableString.

The objects you create using NSString and NSMutableString are referred to as string objects (or, when no confusion will result, merely as strings). The term C string refers to the standard char * type.

Because of the nature of class clusters, string objects aren’t actual instances of the NSString or NSMutableString classes but of one of their private subclasses. Although a string object’s class is private, its interface is public, as declared by these abstract superclasses, NSString and NSMutableString. The string classes adopt the NSCopying and NSMutableCopying protocols, making it convenient to convert a string of one type to the other.

 

캐릭터 이해

문자열 객체는 UTF-16 코드 단위의 시퀀스로 표시됩니다. length 메소드를 사용하여 문자열 오브젝트에 포함 된 UTF-16 코드 단위 수를 판별하고 character (at :) 메소드를 사용하여 특정 UTF-16 코드 단위를 검색 할 수 있습니다. 이 두 가지 "기본적인" 방법은 문자열 객체에 대한 기본 액세스를 제공합니다.

그러나 대부분의 문자열 사용은 문자열이 단일 엔티티로 취급되는 수준이 더 높습니다. 문자열을 서로 비교하고, 문자열을 하위 문자열을 검색하고, 새 문자열로 결합하는 등의 작업을 수행합니다. 문자별로 문자열 객체에 액세스해야하는 경우 유니 코드 문자 인코딩, 특히 구성된 문자 시퀀스와 관련된 문제를 이해해야 합니다. 자세한 내용은 유니 코드 표준 버전 4.0 (유니 코드 컨소시엄, 보스턴 : Addison-Wesley, 2003, ISBN 0-321-18578-1) 및 유니 코드 컨소시엄 웹 사이트 http://www.unicode.org/를 참조하십시오. 문자열 프로그래밍 안내서의 문자 및 그래프 클러스터를 참조하십시오.

현지화 된 문자열 비교는 CLDR (Common Locale Data Repository)에 의해 다른 언어에 맞게 유니 코드 데이터 정렬 알고리즘을 기반으로합니다. 둘 다 유니 코드 컨소시엄의 프로젝트입니다. Unicode는 Unicode, Inc.의 등록 상표입니다.

Understanding Characters

A string object presents itself as a sequence of UTF–16 code units. You can determine how many UTF-16 code units a string object contains with the length method and can retrieve a specific UTF-16 code unit with the character(at:) method. These two “primitive” methods provide basic access to a string object.

Most use of strings, however, is at a higher level, with the strings being treated as single entities: You compare strings against one another, search them for substrings, combine them into new strings, and so on. If you need to access string objects character by character, you must understand the Unicode character encoding, specifically issues related to composed character sequences. For details see The Unicode Standard, Version 4.0 (The Unicode Consortium, Boston: Addison-Wesley, 2003, ISBN 0-321-18578-1) and the Unicode Consortium web site: http://www.unicode.org/. See also Characters and Grapheme Clusters in String Programming Guide.

Localized string comparisons are based on the Unicode Collation Algorithm, as tailored for different languages by CLDR (Common Locale Data Repository). Both are projects of the Unicode Consortium. Unicode is a registered trademark of Unicode, Inc.

 

 

UTF-16으로 인코딩 된 데이터 해석

UTF-16으로 인코딩 된 문자열 (또는 UTF-16으로 해석되는 바이트 스트림)에서 NSString 객체를 생성 할 때 바이트 순서가 다르게 지정되지 않으면 NSString은 UTF-16 문자가 빅 엔디안이라고 가정합니다. BOM (바이트 순서 표시). 이 경우 BOM은 바이트 순서를 지시합니다. unichar 값의 배열에서 NSString 객체를 만들 때 배열은 항상 기본 바이트 순서로 UTF-16 코드 단위를 포함하므로 반환 된 문자열은 항상 기본 엔디안입니다.

Interpreting UTF-16-Encoded Data

When creating an NSString object from a UTF-16-encoded string (or a byte stream interpreted as UTF-16), if the byte order is not otherwise specified, NSString assumes that the UTF-16 characters are big-endian, unless there is a BOM (byte-order mark), in which case the BOM dictates the byte order. When creating an NSString object from an array of unichar values, the returned string is always native-endian, since the array always contains UTF–16 code units in native byte order.

 

서브 클래싱 노트

NSString (및 NSMutableString)을 서브 클래싱 할 수 있지만, 이를 위해서는 문자열 (서브 클래스에 의해 상속되지 않음)에 대한 스토리지 기능을 제공하고 두 가지 기본 메소드를 구현해야합니다. 추상 NSString 및 NSMutableString 클래스는 주어진 상황에 적합한 문자열 객체를 생성하고 반환하는 대부분의 프라이빗 클래스로 구성된 클래스 클러스터의 공용 인터페이스입니다. 이 클러스터의 고유한 하위 클래스를 만들면 특정 요구 사항이 적용됩니다.(재정의 방법에서 논의 됨.)

NSString을 서브 클래싱하는 이유가 유효한지 확인하십시오. 서브 클래스의 인스턴스는 다른 문자열이 아닌 문자열을 나타내야합니다. 따라서 서브 클래스가 가지고 있어야 하는 속성은 관리하는 문자 버퍼의 길이와 버퍼의 개별 문자에 대한 액세스입니다. NSString의 서브 클래스를 만드는 유효한 이유는 다른 백업 저장소를 제공하거나 (아마도 성능 향상을 위해) 메모리 관리와 같은 객체 동작의 일부 측면을 다르게 구현하는 것입니다. NSString의 서브 클래스에 필수가 아닌 속성이나 메타 데이터를 추가하려는 경우 객체 구성이 더 좋습니다 (서브 클래 싱의 대안 참조). Cocoa는 이미 NSAttributedString 클래스와 함께 이에 대한 예제를 제공합니다.

Subclassing Notes

It is possible to subclass NSString (and NSMutableString), but doing so requires providing storage facilities for the string (which is not inherited by subclasses) and implementing two primitive methods. The abstract NSString and NSMutableString classes are the public interface of a class cluster consisting mostly of private, concrete classes that create and return a string object appropriate for a given situation. Making your own concrete subclass of this cluster imposes certain requirements (discussed in Methods to Override).

Make sure your reasons for subclassing NSString are valid. Instances of your subclass should represent a string and not something else. Thus the only attributes the subclass should have are the length of the character buffer it’s managing and access to individual characters in the buffer. Valid reasons for making a subclass of NSString include providing a different backing store (perhaps for better performance) or implementing some aspect of object behavior differently, such as memory management. If your purpose is to add non-essential attributes or metadata to your subclass of NSString, a better alternative would be object composition (see Alternatives to Subclassing). Cocoa already provides an example of this with the NSAttributedString class.

 

재정의하는 방법

NSString의 모든 하위 클래스는 기본 인스턴스 메소드 길이 및 문자 (at :)를 대체해야합니다. 이 메소드는 문자열의 문자를 제공하는 백업 저장소에서 작동해야합니다. 이 백업 저장소의 경우 정적 배열, 동적으로 할당 된 버퍼, 표준 NSString 객체 또는 기타 데이터 유형 또는 메커니즘을 사용할 수 있습니다. 대체 구현을 제공하려는 다른 NSString 메소드를 부분적으로 또는 완전히 대체하도록 선택할 수도 있습니다. 예를 들어, 성능을 향상 시키려면 getCharacters (_ : range :)를 대체하고 더 빠른 구현을 권장합니다.

서브 클래스가 관리하는 백업 저장소에 적합한 서브 클래스에 대한 이니셜 라이저를 구현할 수 있습니다. NSString 클래스에는 지정된 이니셜 라이저가 없으므로 이니셜 라이저는 super의 init () 메소드 만 호출하면됩니다. NSString 클래스는 NSCopying, NSMutableCopying 및 NSCoding 프로토콜을 채택합니다. 복사 또는 코딩에서 생성 된 사용자 정의 서브 클래스의 인스턴스를 원하는 경우 이러한 프로토콜의 메소드를 대체하십시오.

Methods to Override

Any subclass of NSString must override the primitive instance methods length and character(at:). These methods must operate on the backing store that you provide for the characters of the string. For this backing store you can use a static array, a dynamically allocated buffer, a standard NSString object, or some other data type or mechanism. You may also choose to override, partially or fully, any other NSString method for which you want to provide an alternative implementation. For example, for better performance it is recommended that you override getCharacters(_:range:) and give it a faster implementation.

You might want to implement an initializer for your subclass that is suited to the backing store that the subclass is managing. The NSString class does not have a designated initializer, so your initializer need only invoke the init() method of super. The NSString class adopts the NSCopying, NSMutableCopying, and NSCoding protocols; if you want instances of your own custom subclass created from copying or coding, override the methods in these protocols.

 

서브 클래싱의 대안

NSString의 서브 클래스 또는 클래스 클러스터의 추상 클래스 인 서브 클래스를 만드는 보다 나은 대안은 종종 객체 구성입니다. 이것은 특히 서브 클래스 메타 데이터 또는 문자열 객체에 필수적이지 않은 다른 속성에 추가하려는 경우에 해당됩니다. 객체 구성에서는 NSString 객체를 사용자 정의 클래스의 하나의 인스턴스 변수 (일반적으로 NSObject의 서브 클래스)로 만들고 사용자 정의 객체에 대해 원하는 메타 데이터를 저장하는 하나 이상의 인스턴스 변수를 갖습니다. 그런 다음 포함 된 문자열 객체 및 메타 데이터에 대한 접근자 메서드를 포함하도록 서브 클래스 인터페이스를 설계하십시오.

추가하려는 동작이 기존 클래스의 동작을 보완하는 경우 NSString에 범주를 작성할 수 있습니다. 그러나 이 범주는 사용하는 모든 NSString 인스턴스에 적용되며 의도하지 않은 결과가 발생할 수 있습니다.

Alternatives to Subclassing

Often a better and easier alternative to making a subclass of NSString—or of any other abstract, public class of a class cluster, for that matter—is object composition. This is especially the case when your intent is to add to the subclass metadata or some other attribute that is not essential to a string object. In object composition, you would have an NSString object as one instance variable of your custom class (typically a subclass of NSObject) and one or more instance variables that store the metadata that you want for the custom object. Then just design your subclass interface to include accessor methods for the embedded string object and the metadata.

If the behavior you want to add supplements that of the existing class, you could write a category on NSString. Keep in mind, however, that this category will be in effect for all instances of NSString that you use, and this might have unintended consequences.

 

토픽

문자열 생성 및 초기화

Topics

Creating and Initializing Strings

 

init ()

문자가 없는 초기화 된 NSString 객체를 반환합니다.

init()

Returns an initialized NSString object that contains no characters.

 

init?(bytes: UnsafeRawPointer, length: Int, encoding: UInt)

주어진 인코딩으로 해석된 주어진 바이트 버퍼에서 주어진 바이트 수를 포함하는 초기화 된 NSString 객체를 반환합니다.

init?(bytes: UnsafeRawPointer, length: Int, encoding: UInt)

Returns an initialized NSString object containing a given number of bytes from a given buffer of bytes interpreted in a given encoding.

 

init?(bytesNoCopy: UnsafeMutableRawPointer, length: Int, encoding: UInt, freeWhenDone: Bool)

지정된 인코딩으로 해석 된 지정된 바이트 버퍼에서 지정된 바이트 수를 포함하는 초기화 된 NSString 객체를 반환하고 선택적으로 버퍼를 해제합니다.

init?(bytesNoCopy: UnsafeMutableRawPointer, length: Int, encoding: UInt, freeWhenDone: Bool)

Returns an initialized NSString object that contains a given number of bytes from a given buffer of bytes interpreted in a given encoding, and optionally frees the buffer.

 

init(characters: UnsafePointer<unichar>, length: Int)

UTF-16 코드 단위의 지정된 C 배열에서 지정된 수의 문자를 포함하는 초기화 된 NSString 객체를 반환합니다.

init(characters: UnsafePointer<unichar>, length: Int)

Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units.

 

init(charactersNoCopy: UnsafeMutablePointer<unichar>, length: Int, freeWhenDone: Bool)
UTF-16 코드 단위의 지정된 C 배열에서 지정된 수의 문자를 포함하는 초기화 된 NSString 객체를 반환합니다.

init(charactersNoCopy: UnsafeMutablePointer<unichar>, length: Int, freeWhenDone: Bool)

Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units.

 

init(string: String)

주어진 다른 문자열에서 문자를 복사하여 초기화 된 NSString 객체를 반환합니다.

init(string: String)

Returns an NSString object initialized by copying the characters from another given string.

 

init?(cString: UnsafePointer<Int8>, encoding: UInt)

주어진 인코딩에 따라 해석되어 주어진 C 배열의 문자를 사용하여 초기화 된 NSString 객체를 반환합니다.

init?(cString: UnsafePointer<Int8>, encoding: UInt)

Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding.

 

init?(utf8String: UnsafePointer<Int8>)

주어진 UTF8 인코딩 된 바이트의 C 배열에서 문자를 복사하여 초기화 된 NSString 객체를 반환합니다.

init?(utf8String: UnsafePointer<Int8>)

Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes.

 

 

init(format: String, arguments: CVaListPointer)

주어진 형식 문자열을 템플릿으로 사용하여 초기화 된 NSString 객체를 반환합니다. 여기에는 나머지 인수 값이 현지화없이 대체됩니다.

init(format: String, arguments: CVaListPointer)

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted without any localization.

 

init(format: String, locale: Any?, arguments: CVaListPointer)

주어진 로케일 정보에 따라 나머지 인수 값이 대체되는 템플리트로 지정된 형식 문자열을 사용하여 초기화 된 NSString 오브젝트를 리턴합니다. 이 메소드는 인수 목록을 사용할 수있는 가변 함수 내에서 호출됩니다.

init(format: String, locale: Any?, arguments: CVaListPointer)

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted according to given locale information. This method is meant to be called from within a variadic function, where the argument list will be available.

 

init?(data: Data, encoding: UInt)

주어진 인코딩을 사용하여 주어진 데이터를 UTF-16 코드 단위로 변환하여 초기화 된 NSString 객체를 반환합니다.

init?(data: Data, encoding: UInt)

Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding.

 

class func localizedUserNotificationString(forKey: String, arguments: [Any]?) -> String

알림 경고에 표시하기 위해 지역화 된 문자열을 반환합니다.

class func localizedUserNotificationString(forKey: String, arguments: [Any]?) -> String

Returns a localized string intended for display in a notification alert.

 

class func localizedStringWithFormat(NSString, CVarArg...) -> Self

typealias unichar

UTF-16 코드 단위를 입력하십시오.

파일에서 문자열 생성 및 초기화

class func localizedStringWithFormat(NSString, CVarArg...) -> Self

typealias unichar

Type for UTF-16 code units.

 

 

Creating and Initializing a String from a File

 

 

init(contentsOfFile: String, encoding: UInt)

지정된 인코딩을 사용하여 지정된 경로의 파일에서 데이터를 읽어 초기화 된 NSString 객체를 반환합니다.

init(contentsOfFile: String, encoding: UInt)

Returns an NSString object initialized by reading data from the file at a given path using a given encoding.

 

 

init(contentsOfFile: String, usedEncoding: UnsafeMutablePointer<UInt>?)

주어진 경로에서 파일에서 데이터를 읽어 초기화 된 NSString 객체를 반환하고 문자를 해석하는 데 사용되는 인코딩을 참조로 반환합니다.

init(contentsOfFile: String, usedEncoding: UnsafeMutablePointer<UInt>?)

Returns an NSString object initialized by reading data from the file at a given path and returns by reference the encoding used to interpret the characters.

 

 

URL에서 문자열 생성 및 초기화

Creating and Initializing a String from an URL

 

init(contentsOf: URL, encoding: UInt)

지정된 인코딩을 사용하여 해석된 지정된 URL에서 데이터를 읽어 초기화 된 NSString 객체를 반환합니다.

init(contentsOf: URL, encoding: UInt)

Returns an NSString object initialized by reading data from a given URL interpreted using a given encoding.

 

init(contentsOf: URL, usedEncoding: UnsafeMutablePointer<UInt>?)

지정된 URL에서 데이터를 읽어 초기화 된 NSString 객체를 반환하고 데이터를 해석하는 데 사용되는 인코딩을 참조로 반환합니다.

init(contentsOf: URL, usedEncoding: UnsafeMutablePointer<UInt>?)

Returns an NSString object initialized by reading data from a given URL and returns by reference the encoding used to interpret the data.

 

 

문자열의 길이를 가져옵니다.

Getting a String’s Length

 

var length: Int

수신자의 UTF-16 코드 단위 수입니다.

var length: Int

The number of UTF-16 code units in the receiver.

 

func lengthOfBytes(using: UInt) -> Int

주어진 인코딩으로 수신자를 저장하는 데 필요한 바이트 수를 리턴합니다.

func lengthOfBytes(using: UInt) -> Int

Returns the number of bytes required to store the receiver in a given encoding.

 

func maximumLengthOfBytes(using: UInt) -> Int

지정된 인코딩으로 수신자를 저장하는 데 필요한 최대 바이트 수를 리턴합니다.

func maximumLengthOfBytes(using: UInt) -> Int

Returns the maximum number of bytes needed to store the receiver in a given encoding.

 

 

문자 및 바이트를 가져옵니다.

Getting Characters and Bytes

 

func character (at : Int)-> unichar

주어진 UTF-16 코드 단위 색인에서 문자를 리턴합니다.

func character(at: Int) -> unichar

Returns the character at a given UTF-16 code unit index.

 

func getCharacters(UnsafeMutablePointer<unichar>, range: NSRange)

수신자의 지정된 범위에서 지정된 버퍼로 문자를 복사합니다.

func getCharacters(UnsafeMutablePointer<unichar>, range: NSRange)

Copies characters from a given range in the receiver into a given buffer.

 

func getBytes(UnsafeMutableRawPointer?, maxLength: Int, usedLength: UnsafeMutablePointer<Int>?, encoding: UInt, options: NSString.EncodingConversionOptions, range: NSRange, remaining: NSRangePointer?) -> Bool

지정된 인코딩에서 지정된 문자 범위를 바이트로 가져옵니다.

func getBytes(UnsafeMutableRawPointer?, maxLength: Int, usedLength: UnsafeMutablePointer<Int>?, encoding: UInt, options: NSString.EncodingConversionOptions, range: NSRange, remaining: NSRangePointer?) -> Bool

Gets a given range of characters as bytes in a specified encoding.

 

 

 

C 문자열을 가져옵니다.

Getting C Strings

 

func cString(using: UInt) -> UnsafePointer<Int8>?

주어진 인코딩을 사용하여 문자열 표현을 C 문자열로 반환합니다.

func cString(using: UInt) -> UnsafePointer<Int8>?

Returns a representation of the string as a C string using a given encoding.

 

func getCString(UnsafeMutablePointer<Int8>, maxLength: Int, encoding: UInt) -> Bool

문자열을 주어진 인코딩으로 변환하여 버퍼에 저장합니다.

func getCString(UnsafeMutablePointer<Int8>, maxLength: Int, encoding: UInt) -> Bool

Converts the string to a given encoding and stores it in a buffer.

 

var utf8String: UnsafePointer<Int8>?

문자열로 끝나는 null로 끝나는 UTF8 표현입니다.

var utf8String: UnsafePointer<Int8>?

A null-terminated UTF8 representation of the string.

 

 

문자열 식별 및 비교

Identifying and Comparing Strings

 

func caseInsensitiveCompare(String) -> ComparisonResult

NSCaseInsensitiveSearch를 유일한 옵션으로 사용하여 compare (_ : options :)를 호출 한 결과를 리턴합니다.

func caseInsensitiveCompare(String) -> ComparisonResult

Returns the result of invoking compare(_:options:) with NSCaseInsensitiveSearch as the only option.

 

func localizedCaseInsensitiveCompare(String) -> ComparisonResult

대소문자를 구분하지 않고 지역화 된 비교를 사용하여 문자열을 주어진 문자열과 비교합니다.

func localizedCaseInsensitiveCompare(String) -> ComparisonResult

Compares the string with a given string using a case-insensitive, localized, comparison.

 

func compare(String) -> ComparisonResult

옵션이 없는 compare (_ : options : range :) 및 수신자의 전체 범위를 범위로 호출 한 결과를 반환합니다.

func compare(String) -> ComparisonResult

Returns the result of invoking compare(_:options:range:) with no options and the receiver’s full extent as the range.

 

func localizedCompare(String) -> ComparisonResult

지역화 된 비교를 사용하여 문자열과 주어진 문자열을 비교합니다.

func localizedCompare(String) -> ComparisonResult

Compares the string and a given string using a localized comparison.

 

func compare(String, options: NSString.CompareOptions) -> ComparisonResult

주어진 옵션을 사용하여 문자열을 지정된 문자열과 비교합니다.

func compare(String, options: NSString.CompareOptions) -> ComparisonResult

Compares the string with the specified string using the given options.

 

func compare(String, options: NSString.CompareOptions, range: NSRange) -> ComparisonResult

nil 로케일로 compare (_ : options : range : locale :)을 호출 한 결과를 리턴합니다.

func compare(String, options: NSString.CompareOptions, range: NSRange) -> ComparisonResult

Returns the result of invoking compare(_:options:range:locale:) with a nil locale.

 

func compare(String, options: NSString.CompareOptions, range: NSRange, locale: Any?) -> ComparisonResult

지정된 옵션을 사용하여 문자열을 비교하고 범위의 어휘 순서를 반환합니다.

func compare(String, options: NSString.CompareOptions, range: NSRange, locale: Any?) -> ComparisonResult

Compares the string using the specified options and returns the lexical ordering for the range.

 

 

func localizedStandardCompare(String) -> ComparisonResult

Finder별로 정렬한 문자열을 비교합니다.

func localizedStandardCompare(String) -> ComparisonResult

Compares strings as sorted by the Finder.

 

func hasPrefix(String) -> Bool

주어진 문자열이 수신자의 시작 문자와 일치하는지 여부를 나타내는 부울 값을 리턴합니다.

func hasPrefix(String) -> Bool

Returns a Boolean value that indicates whether a given string matches the beginning characters of the receiver.

 

func hasSuffix(String) -> Bool

주어진 문자열이 수신자의 끝 문자와 일치하는지 여부를 나타내는 부울 값을 리턴합니다.

func hasSuffix(String) -> Bool

Returns a Boolean value that indicates whether a given string matches the ending characters of the receiver.

 

func isEqual(to: String) -> Bool

리터럴 유니 코드 기반 비교를 사용하여 지정된 문자열이 수신자와 같은지 여부를 나타내는 부울 값을 리턴합니다.

func isEqual(to: String) -> Bool

Returns a Boolean value that indicates whether a given string is equal to the receiver using a literal Unicode-based comparison.

 

var hash: Int

해시 테이블 주소로 사용할 수있는 부호없는 정수입니다.

var hash: Int

An unsigned integer that can be used as a hash table address.

 

struct NSString.CompareOptions

이 값은 많은 문자열 클래스의 검색 및 비교 방법에서 사용할 수 있는 옵션을 나타냅니다.

struct NSString.CompareOptions

These values represent the options available to many of the string classes’ search and comparison methods.

 

struct NSString.EncodingConversionOptions

문자열 인코딩 변환 옵션.

struct NSString.EncodingConversionOptions

Options for converting string encodings.

 

 

문자열 결합

Combining Strings

 

func appendingFormat(NSString, CVarArg...) -> NSString

func appending(String) -> String

수신자에게 주어진 문자열을 추가하여 만들어진 새로운 문자열을 반환합니다.

func appendingFormat(NSString, CVarArg...) -> NSString

func appending(String) -> String

Returns a new string made by appending a given string to the receiver.

 

func padding(toLength: Int, withPad: String, startingAt: Int) -> String

끝에서 문자를 제거하거나 주어진 패드 문자열에 필요한 만큼을 추가하여 수신자로부터 형성된 새 문자열을 리턴합니다.

func padding(toLength: Int, withPad: String, startingAt: Int) -> String

Returns a new string formed from the receiver by either removing characters from the end, or by appending as many occurrences as necessary of a given pad string.

 

 

대소문자를 바꿉니다.

Changing Case

 

var lowercased: String

문자열을 소문자로 표현합니다.

var lowercased: String

A lowercase representation of the string.

 

var localizedLowercase: String

현재 로케일을 고려하여 모든 문자를 소문자로 변환 한 문자열 버전을 리턴합니다.

var localizedLowercase: String

Returns a version of the string with all letters converted to lowercase, taking into account the current locale.

 

func lowercased(with: Locale?) -> String

지정된 로케일을 고려하여 모든 문자가 소문자로 변환 된 문자열 버전을 리턴합니다.

func lowercased(with: Locale?) -> String

Returns a version of the string with all letters converted to lowercase, taking into account the specified locale.

 

var uppercased: String

문자열의 대문자 표현.

var uppercased: String

An uppercase representation of the string.

 

var localizedUppercase: String

현재 로케일을 고려하여 모든 문자를 대문자로 변환한 문자열 버전을 리턴합니다.

var localizedUppercase: String

Returns a version of the string with all letters converted to uppercase, taking into account the current locale.

 

func uppercased(with: Locale?) -> String

지정된 로케일을 고려하여 모든 문자를 대문자로 변환한 문자열 버전을 리턴합니다.

func uppercased(with: Locale?) -> String

Returns a version of the string with all letters converted to uppercase, taking into account the specified locale.

 

var capitalized: String

문자열을 대문자로 표시합니다.

var capitalized: String

A capitalized representation of the string.

 

var localizedCapitalized: String

현재 로케일을 사용하여 수신자의 대문자 표시를 리턴합니다.

var localizedCapitalized: String

Returns a capitalized representation of the receiver using the current locale.

 

func capitalized(with: Locale?) -> String

지정된 로케일을 사용하여 수신자의 대문자 표시를 리턴합니다.

func capitalized(with: Locale?) -> String

Returns a capitalized representation of the receiver using the specified locale.

 

문자열 나누기

Dividing Strings

 

func components(separatedBy: String) -> [String]

주어진 분리자로 나눈 수신자의 서브 스트링을 포함하는 배열을 리턴합니다.

func components(separatedBy: String) -> [String]

Returns an array containing substrings from the receiver that have been divided by a given separator.

 

func components(separatedBy: CharacterSet) -> [String]

주어진 세트에서 문자로 분할된 수신자의 서브 스트링을 포함하는 배열을 리턴합니다.

func components(separatedBy: CharacterSet) -> [String]

Returns an array containing substrings from the receiver that have been divided by characters in a given set.

 

func trimmingCharacters(in: CharacterSet) -> String

지정된 문자 세트에 포함 된 수신자 문자의 양쪽 끝을 제거하여 작성된 새 문자열을 리턴합니다.

func trimmingCharacters(in: CharacterSet) -> String

Returns a new string made by removing from both ends of the receiver characters contained in a given character set.

 

func substring(from: Int) -> String

주어진 색인에서 끝까지 수신자의 문자를 포함하는 새 문자열을 리턴합니다.

func substring(from: Int) -> String

Returns a new string containing the characters of the receiver from the one at a given index to the end.

 

func substring(with: NSRange) -> String

주어진 범위 내에있는 수신자의 문자를 포함하는 문자열 객체를 반환합니다.

func substring(with: NSRange) -> String

Returns a string object containing the characters of the receiver that lie within a given range.

 

func substring(to: Int) -> String

수신자의 문자를 포함하지만 주어진 색인의 문자를 포함하지 않는 새로운 문자열을 리턴합니다.

func substring(to: Int) -> String

Returns a new string containing the characters of the receiver up to, but not including, the one at a given index.

 

 

 

문자열 정규화

Normalizing Strings

 

var decomposedStringWithCanonicalMapping: String

유니 코드 정규화 형식 D를 사용하여 문자열의 내용을 정규화 하여 만든 문자열

var decomposedStringWithCanonicalMapping: String

A string made by normalizing the string’s contents using the Unicode Normalization Form D.

 

var decomposedStringWithCompatibilityMapping: String

유니 코드 정규화 양식 KD를 사용하여 수신자의 내용을 정규화하여 만든 문자열입니다.

var decomposedStringWithCompatibilityMapping: String

A string made by normalizing the receiver’s contents using the Unicode Normalization Form KD.

 

var precomposedStringWithCanonicalMapping: String

유니 코드 정규화 형식 C를 사용하여 문자열의 내용을 정규화하여 만든 문자열

var precomposedStringWithCanonicalMapping: String

A string made by normalizing the string’s contents using the Unicode Normalization Form C.

 

var precomposedStringWithCompatibilityMapping: String

Unicode Normalization Form KC를 사용하여 수신자의 내용을 표준화하여 만든 문자열입니다.

var precomposedStringWithCompatibilityMapping: String

A string made by normalizing the receiver’s contents using the Unicode Normalization Form KC.

 

 

폴딩 문자열입니다.

Folding Strings

 

func folding(options: NSString.CompareOptions, locale: Locale?) -> String

문자열에서 지정된 문자 구별을 제거하여 비교에 적합한 문자열을 작성합니다.

func folding(options: NSString.CompareOptions, locale: Locale?) -> String

Creates a string suitable for comparison by removing the specified character distinctions from a string.

 

 

문자열 변환

Transforming Strings

 

func applyingTransform(StringTransform, reverse: Bool) -> String?

지정된 변환을 문자열에 적용하여 새 문자열을 반환합니다.

func applyingTransform(StringTransform, reverse: Bool) -> String?

Returns a new string by applying a specified transform to the string.

 

struct StringTransform

ICU 문자열 변환을 나타내는 상수입니다.

struct StringTransform

Constants representing an ICU string transform.

 

 

문자와 부분 문자열 찾기

Finding Characters and Substrings

 

func contains(String) -> Bool

대소문자를 구분하여 로캘을 인식하지 못하여 문자열에 지정된 문자열이 포함되어 있는지 여부를 나타내는 부울 값을 반환합니다.

func contains(String) -> Bool

Returns a Boolean value indicating whether the string contains a given string by performing a case-sensitive, locale-unaware search.

 

func localizedCaseInsensitiveContains(String) -> Bool

대소문자를 구분하지 않는 로캘 인식 검색을 수행하여 문자열에 지정된 문자열이 포함되어 있는지 여부를 나타내는 부울 값을 반환합니다.

func localizedCaseInsensitiveContains(String) -> Bool

Returns a Boolean value indicating whether the string contains a given string by performing a case-insensitive, locale-aware search.

 

func localizedStandardContains(String) -> Bool

대소문자를 구분하지 않고 분음 부호를 구분하지 않는 로케일 인식 검색을 수행하여 문자열에 지정된 문자열이 포함되어 있는지 여부를 나타내는 부울 값을 반환합니다.

( 대/소문자 구분 없이 로캘 인식 검색을 수행하여 문자열에 지정된 문자열이 포함되어 있는지 여부를 나타내는 부울 값을 반환합니다. )

func localizedStandardContains(String) -> Bool

Returns a Boolean value indicating whether the string contains a given string by performing a case and diacritic insensitive, locale-aware search.

 

func rangeOfCharacter (from : CharacterSet)-> NSRange

주어진 문자 집합에서 첫 번째 문자의 문자열 범위를 찾아 반환합니다.

func rangeOfCharacter(from: CharacterSet) -> NSRange

Finds and returns the range in the string of the first character from a given character set.

 

 

func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions) -> NSRange

주어진 문자 세트에서 주어진 옵션을 사용하여 첫 번째 문자의 문자열 범위를 찾아 반환합니다.

func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions) -> NSRange

Finds and returns the range in the string of the first character, using given options, from a given character set.

 

func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions, range: NSRange) -> NSRange

주어진 옵션으로 주어진 범위에서 발견 된 주어진 문자 세트에서 첫 번째 문자의 문자열 범위를 찾아 리턴합니다.

func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions, range: NSRange) -> NSRange

Finds and returns the range in the string of the first character from a given character set found in a given range with given options.

 

func range (of : String)-> NSRange

문자열 내에서 주어진 문자열이 처음 나타나는 범위를 찾아 반환합니다.

func range(of: String) -> NSRange

Finds and returns the range of the first occurrence of a given string within the string.

 

func range(of: String, options: NSString.CompareOptions) -> NSRange

주어진 옵션에 따라 문자열 내에서 주어진 문자열이 처음 나타나는 범위를 찾아 반환합니다.

func range(of: String, options: NSString.CompareOptions) -> NSRange

Finds and returns the range of the first occurrence of a given string within the string, subject to given options.

 

func range(of: String, options: NSString.CompareOptions, range: NSRange) -> NSRange

주어진 옵션에 따라 주어진 문자열 범위 내에서 주어진 문자열이 처음 나타나는 범위를 찾아 반환합니다.

func range(of: String, options: NSString.CompareOptions, range: NSRange) -> NSRange

Finds and returns the range of the first occurrence of a given string, within the given range of the string, subject to given options.

 

func range (of : String, options : NSString.CompareOptions, range : NSRange, locale : Locale?)-> NSRange

지정된 로케일 (있는 경우)을 사용하여 주어진 옵션에 따라 주어진 문자열 범위 내에서 주어진 문자열이 처음 나타나는 범위를 찾아 리턴합니다.

func range(of: String, options: NSString.CompareOptions, range: NSRange, locale: Locale?) -> NSRange

Finds and returns the range of the first occurrence of a given string within a given range of the string, subject to given options, using the specified locale, if any.

 

func localizedStandardRange (of : String)-> NSRange

대소문자를 구분하지 않는 로케일 인식 검색을 수행하여 문자열 내에서 지정된 문자열이 처음 나타나는 범위를 찾아 리턴합니다.

func localizedStandardRange(of: String) -> NSRange

Finds and returns the range of the first occurrence of a given string within the string by performing a case and diacritic insensitive, locale-aware search.

 

func enumerateLines((String, UnsafeMutablePointer<ObjCBool>) -> Void)

문자열의 모든 줄을 열거합니다.

func enumerateLines((String, UnsafeMutablePointer<ObjCBool>) -> Void)

Enumerates all the lines in the string.

 

func enumerateSubstrings(in: NSRange, options: NSString.EnumerationOptions, using: (String?, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

지정된 문자열 범위에서 지정된 유형의 하위 문자열을 열거합니다.

func enumerateSubstrings(in: NSRange, options: NSString.EnumerationOptions, using: (String?, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

Enumerates the substrings of the specified type in the specified range of the string.

 

 

 

부분 문자열 교체

Replacing Substrings

 

func replacingOccurrences(of: String, with: String) -> String

수신자에서 대상 문자열의 모든 항목이 지정된 다른 문자열로 대체되는 새 문자열을 리턴합니다.

func replacingOccurrences(of: String, with: String) -> String

Returns a new string in which all occurrences of a target string in the receiver are replaced by another given string.

 

func replacingOccurrences(of: String, with: String, options: NSString.CompareOptions, range: NSRange) -> String

수신자의 지정된 범위에서 대상 문자열의 모든 항목이 다른 지정된 문자열로 대체되는 새 문자열을 리턴합니다.

func replacingOccurrences(of: String, with: String, options: NSString.CompareOptions, range: NSRange) -> String

Returns a new string in which all occurrences of a target string in a specified range of the receiver are replaced by another given string.

 

func replacingCharacters(in: NSRange, with: String) -> String

지정된 수신자 범위의 문자가 지정된 문자열로 대체되는 새 문자열을 리턴합니다.

func replacingCharacters(in: NSRange, with: String) -> String

Returns a new string in which the characters in a specified range of the receiver are replaced by a given string.

 

 

공유 접두사 얻기

Getting a Shared Prefix

 

func commonPrefix(with: String, options: NSString.CompareOptions) -> String

수신자와 지정된 문자열이 공통적으로 시작하는 문자부터 시작하여 동일하지 않은 첫 문자까지 문자열을 반환합니다.

func commonPrefix(with: String, options: NSString.CompareOptions) -> String

Returns a string containing characters the receiver and a given string have in common, starting from the beginning of each up to the first characters that aren’t equivalent.

 

 

언어 분석 수행

Performing Linguistic Analysis

 

func enumerateLinguisticTags(in: NSRange, scheme: NSLinguisticTagScheme, options: NSLinguisticTagger.Options, orthography: NSOrthography?, using: (NSLinguisticTag?, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

문자열의 특정 범위를 열거하고 지정된 태그를 블록에 제공하여 지정된 문자열에 대한 언어 분석을 수행합니다.

func enumerateLinguisticTags(in: NSRange, scheme: NSLinguisticTagScheme, options: NSLinguisticTagger.Options, orthography: NSOrthography?, using: (NSLinguisticTag?, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

Performs linguistic analysis on the specified string by enumerating the specific range of the string, providing the Block with the located tags.

 

func linguisticTags(in: NSRange, scheme: NSLinguisticTagScheme, options: NSLinguisticTagger.Options, orthography: NSOrthography?, tokenRanges: AutoreleasingUnsafeMutablePointer<NSArray?>?) -> [NSLinguisticTag]

수신 문자열 내에서 지정된 범위 및 요청된 태그에 대한 언어 태그 배열을 반환합니다.

func linguisticTags(in: NSRange, scheme: NSLinguisticTagScheme, options: NSLinguisticTagger.Options, orthography: NSOrthography?, tokenRanges: AutoreleasingUnsafeMutablePointer<NSArray?>?) -> [NSLinguisticTag]

Returns an array of linguistic tags for the specified range and requested tags within the receiving string.

 

struct NSString.EnumerationOptions

하위 문자열의 종류와 열거 스타일을 지정하는 상수입니다.

struct NSString.EnumerationOptions

Constants to specify kinds of substrings and styles of enumeration.

 

 

선 및 단락 범위를 결정합니다.

Determining Line and Paragraph Ranges

 

func getLineStart(UnsafeMutablePointer<Int>?, end: UnsafeMutablePointer<Int>?, contentsEnd: UnsafeMutablePointer<Int>?, for: NSRange)

주어진 범위에 의해 터치된 첫 번째 줄의 시작과 마지막 줄의 끝을 참조로 반환합니다.

func getLineStart(UnsafeMutablePointer<Int>?, end: UnsafeMutablePointer<Int>?, contentsEnd: UnsafeMutablePointer<Int>?, for: NSRange)

Returns by reference the beginning of the first line and the end of the last line touched by the given range.

 

func lineRange (for : NSRange)-> NSRange

주어진 범위를 포함하는 행을 나타내는 문자 범위를 리턴합니다.

func lineRange(for: NSRange) -> NSRange

Returns the range of characters representing the line or lines containing a given range.

 

func getParagraphStart(UnsafeMutablePointer<Int>?, end: UnsafeMutablePointer<Int>?, contentsEnd: UnsafeMutablePointer<Int>?, for: NSRange)

주어진 범위에 의해 터치된 첫 번째 단락의 시작과 마지막 단락의 끝을 참조로 반환합니다.

func getParagraphStart(UnsafeMutablePointer<Int>?, end: UnsafeMutablePointer<Int>?, contentsEnd: UnsafeMutablePointer<Int>?, for: NSRange)

Returns by reference the beginning of the first paragraph and the end of the last paragraph touched by the given range.

 

func paragraphRange(for: NSRange) -> NSRange

주어진 범위를 포함하는 단락을 나타내는 문자 범위를 반환합니다.

func paragraphRange(for: NSRange) -> NSRange

Returns the range of characters representing the paragraph or paragraphs containing a given range.

 

 

구성된 문자 순서 결정

Determining Composed Character Sequences

 

func rangeOfComposedCharacterSequence (at : Int)-> NSRange

주어진 인덱스에 있는 구성된 문자 시퀀스의 수신자 범위를 리턴합니다.

func rangeOfComposedCharacterSequence(at: Int) -> NSRange

Returns the range in the receiver of the composed character sequence located at a given index.

 

func rangeOfComposedCharacterSequences (for : NSRange)-> NSRange

주어진 범위에 대해 구성된 문자 시퀀스의 문자열 범위를 반환합니다.

func rangeOfComposedCharacterSequences(for: NSRange) -> NSRange

Returns the range in the string of the composed character sequences for a given range.

 

 

 

파일 또는 URL에 쓰기

Writing to a File or URL

 

func write(toFile: String, atomically: Bool, encoding: UInt)

지정된 인코딩을 사용하여 수신자의 내용을 지정된 경로의 파일에 씁니다.

func write(toFile: String, atomically: Bool, encoding: UInt)

Writes the contents of the receiver to a file at a given path using a given encoding.

 

func write(to: URL, atomically: Bool, encoding: UInt)

지정된 인코딩을 사용하여 url로 지정된 URL에 수신자의 내용을 씁니다.

func write(to: URL, atomically: Bool, encoding: UInt)

Writes the contents of the receiver to the URL specified by url using the specified encoding.

 

 

문자열 내용을 속성 목록으로 변환

Converting String Contents Into a Property List

 

func propertyList() -> Any

수신자를 속성 목록의 텍스트 표현으로 구문 분석하여 최상위 요소에 따라 NSString, NSData, NSArray 또는 NSDictionary 객체를 반환합니다.

func propertyList() -> Any

Parses the receiver as a text representation of a property list, returning an NSString, NSData, NSArray, or NSDictionary object, according to the topmost element.

 

func propertyListFromStringsFileFormat ()-> [AnyHashable : Any]?

수신자에서 찾은 키와 값으로 초기화 된 사전 객체를 반환합니다.

func propertyListFromStringsFileFormat() -> [AnyHashable : Any]?

Returns a dictionary object initialized with the keys and values found in the receiver.

 

 

문자열 크기 및 그리기

Sizing and Drawing Strings

 

func draw(at: CGPoint, withAttributes: [NSAttributedString.Key : Any]?)

현재 그래픽 컨텍스트의 지정된 지점에서 지정된 속성의 글꼴 및 기타 디스플레이 특성을 사용하여 수신자를 그립니다.

func draw(at: CGPoint, withAttributes: [NSAttributedString.Key : Any]?)

Draws the receiver with the font and other display characteristics of the given attributes, at the specified point in the current graphics context.

 

func draw (in : CGRect, withAttributes : [NSAttributedString.Key : Any]?)

지정된 경계 사각형 안에 속성 문자열을 그립니다.

func draw(in: CGRect, withAttributes: [NSAttributedString.Key : Any]?)

Draws the attributed string inside the specified bounding rectangle.

 

func draw(with: CGRect, options: NSStringDrawingOptions, attributes: [NSAttributedString.Key : Any]?, context: NSStringDrawingContext?)

제공된 옵션을 사용하여 지정된 경계 사각형에 표시된 문자열을 그립니다.

func draw(with: CGRect, options: NSStringDrawingOptions, attributes: [NSAttributedString.Key : Any]?, context: NSStringDrawingContext?)

Draws the attributed string in the specified bounding rectangle using the provided options.

 

func boundingRect(with: CGSize, options: NSStringDrawingOptions, attributes: [NSAttributedString.Key : Any]?, context: NSStringDrawingContext?) -> CGRect

현재 그래픽 컨텍스트에서 지정된 사각형 내에서 주어진 옵션 및 표시 특성을 사용하여 그려진 수신기의 경계 사각형을 계산하고 반환합니다.

func boundingRect(with: CGSize, options: NSStringDrawingOptions, attributes: [NSAttributedString.Key : Any]?, context: NSStringDrawingContext?) -> CGRect

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.

 

func size(withAttributes: [NSAttributedString.Key : Any]?) -> CGSize

지정된 속성으로 그릴 때 수신자가 차지하는 경계 상자 크기를 반환합니다.

func size(withAttributes: [NSAttributedString.Key : Any]?) -> CGSize

Returns the bounding box size the receiver occupies when drawn with the given attributes.

 

func variantFittingPresentationWidth(Int) -> String

지정된 표현 폭에 적합한 문자열 변형을 반환합니다.

func variantFittingPresentationWidth(Int) -> String

Returns a string variation suitable for the specified presentation width.

 

struct NSStringDrawingOptions

문자열을 그릴 때 렌더링 옵션에 대한 상수입니다.

struct NSStringDrawingOptions

Constants for the rendering options for a string when it is drawn.

 

 

숫자 값 얻기

Getting Numeric Values

 

var doubleValue: Double

문자열의 부동 소수점 값 (더블)입니다.

var doubleValue: Double

The floating-point value of the string as a double.

 

var floatValue: Float

문자열의 부동 소수점 값입니다 (float).

var floatValue: Float

The floating-point value of the string as a float.

 

var intValue : Int32

문자열의 정수 값입니다.

var intValue: Int32

The integer value of the string.

 

var integerValue : Int

문자열의 NSInteger 값입니다.

var integerValue: Int

The NSInteger value of the string.

 

var longLongValue : Int64

문자열의 긴 long 값입니다.

var longLongValue: Int64

The long long value of the string.

 

 

var boolValue: Bool

문자열의 부울 값입니다.

인코딩 작업

var boolValue: Bool

The Boolean value of the string.

 

인코딩 작업

Working with Encodings

 

class var availableStringEncodings: UnsafePointer<UInt>

응용 프로그램 환경에서 지원되는 인코딩 문자열 객체가 0으로 끝나는 목록을 반환합니다.

class var availableStringEncodings: UnsafePointer<UInt>

Returns a zero-terminated list of the encodings string objects support in the application’s environment.

 

 

class var defaultCStringEncoding: UInt

C 문자열을 인수로 승인하는 모든 메소드에 대해 가정된 C 문자열 인코딩을 리턴합니다.

class var defaultCStringEncoding: UInt

Returns the C-string encoding assumed for any method accepting a C string as an argument.

 

 

class func stringEncoding(for: Data, encodingOptions: [StringEncodingDetectionOptionsKey : Any]?, convertedString: AutoreleasingUnsafeMutablePointer<NSString?>?, usedLossyConversion: UnsafeMutablePointer<ObjCBool>?) -> UInt

지정된 인코딩 옵션에 따라 문자열을 작성하여 감지된대로 주어진 데이터에 대한 문자열 인코딩을 리턴합니다.

class func stringEncoding(for: Data, encodingOptions: [StringEncodingDetectionOptionsKey : Any]?, convertedString: AutoreleasingUnsafeMutablePointer<NSString?>?, usedLossyConversion: UnsafeMutablePointer<ObjCBool>?) -> UInt

Returns the string encoding for the given data as detected by attempting to create a string according to the specified encoding options.

 

 

class func localizedName(of: UInt) -> String

주어진 인코딩의 이름을 제공하는 사람이 읽을 수있는 문자열을 반환합니다.

class func localizedName(of: UInt) -> String

Returns a human-readable string giving the name of a given encoding.

 

 

func canBeConverted(to: UInt) -> Bool

수신기가 정보 손실없이 주어진 인코딩으로 변환 될 수 있는지 여부를 나타내는 부울 값을 반환합니다.

func canBeConverted(to: UInt) -> Bool

Returns a Boolean value that indicates whether the receiver can be converted to a given encoding without loss of information.

 

 

func data(using: UInt) -> Data?

주어진 인코딩을 사용하여 인코딩 된 수신자의 표현이 포함 된 NSData 객체를 반환합니다.

func data(using: UInt) -> Data?

Returns an NSData object containing a representation of the receiver encoded using a given encoding.

 

 

func data(using: UInt, allowLossyConversion: Bool) -> Data?

주어진 인코딩을 사용하여 인코딩 된 수신자의 표현이 포함 된 NSData 객체를 반환합니다.

func data(using: UInt, allowLossyConversion: Bool) -> Data?

Returns an NSData object containing a representation of the receiver encoded using a given encoding.

 

var description: String

이것은 NSString 객체입니다.

var description: String

This NSString object.

 

var fastestEncoding: UInt

정보 손실없이 수신기를 변환 할 수있는 가장 빠른 인코딩입니다.

var fastestEncoding: UInt

The fastest encoding to which the receiver may be converted without loss of information.

 

var smallestEncoding: UInt

정보 손실없이 수신기를 변환 할 수있는 가장 작은 인코딩입니다.

var smallestEncoding: UInt

The smallest encoding to which the receiver can be converted without loss of information.

 

 

 

struct StringEncodingDetectionOptionsKey

NSString 처리 예외 이름

이 상수는 NSString이 주어진 인코딩에서 문자열을 나타낼 수 없거나 문자열을 속성 목록으로 구문 분석 할 수없는 경우 발생하는 예외 이름을 정의합니다.

struct StringEncodingDetectionOptionsKey

NSString Handling Exception Names

These constants define the names of exceptions raised if NSString cannot represent a string in a given encoding, or parse a string as a property list.

 

 

 

Working with Paths

 

class func path(withComponents: [String]) -> String

주어진 배열의 문자열에서 각 쌍 사이의 경로 구분 기호로 연결하여 작성된 문자열을 반환합니다.

class func path(withComponents: [String]) -> String

Returns a string built from the strings in a given array by concatenating them with a path separator between each pair.

 

 

var pathComponents: [String]

수신자의 파일 시스템 경로 구성 요소.

var pathComponents: [String]

The file-system path components of the receiver.

 

func completePath(into: AutoreleasingUnsafeMutablePointer<NSString?>?, caseSensitive: Bool, matchesInto: AutoreleasingUnsafeMutablePointer<NSArray?>?, filterTypes: [String]?) -> Int

수신자를 파일 시스템의 경로로 해석하고 파일 이름 완성을 시도하여 일치 여부를 나타내는 숫자 값을 반환하고 수신자와 일치하는 가장 긴 경로를 참조합니다.

func completePath(into: AutoreleasingUnsafeMutablePointer<NSString?>?, caseSensitive: Bool, matchesInto: AutoreleasingUnsafeMutablePointer<NSArray?>?, filterTypes: [String]?) -> Int

Interprets the receiver as a path in the file system and attempts to perform filename completion, returning a numeric value that indicates whether a match was possible, and by reference the longest path that matches the receiver.

 

var fileSystemRepresentation: UnsafePointer<Int8>

수신자의 파일 시스템 특정 표현.

var fileSystemRepresentation: UnsafePointer<Int8>

A file system-specific representation of the receiver.

 

func getFileSystemRepresentation(UnsafeMutablePointer<Int8>, maxLength: Int) -> Bool

수신자를 시스템 독립 경로로 해석하고 파일 시스템 호출에 사용하기에 적합한 형식 및 인코딩으로 C- 문자열로 버퍼를 채웁니다.

func getFileSystemRepresentation(UnsafeMutablePointer<Int8>, maxLength: Int) -> Bool

Interprets the receiver as a system-independent path and fills a buffer with a C-string in a format and encoding suitable for use with file-system calls.

 

var isAbsolutePath: Bool

수신자가 절대 경로를 나타내는지 여부를 나타내는 부울 값입니다.

var isAbsolutePath: Bool

A Boolean value that indicates whether the receiver represents an absolute path.

 

var lastPathComponent: String

수신자의 마지막 경로 구성 요소.

var lastPathComponent: String

The last path component of the receiver.

 

var pathExtension: String

경로로 해석되는 문자열의 경로 확장 (있는 경우) 입니다 .

var pathExtension: String

The path extension, if any, of the string as interpreted as a path.

 

var abbreviatingWithTildeInPath: String

현재 경로의 현재 홈 디렉토리 부분을 물결표 (~) 문자로 바꾸는 새 문자열.

var abbreviatingWithTildeInPath: String

A new string that replaces the current home directory portion of the current path with a tilde (~) character.

 

func appendingPathComponent(String) -> String

수신자에게 주어진 문자열을 추가하여 만들어진 새로운 문자열을 반환합니다.

func appendingPathComponent(String) -> String

Returns a new string made by appending to the receiver a given string.

 

func appendingPathExtension(String) -> String?

수신기에 확장 분리기를 추가하고 지정된 확장자를 추가하여 만든 새 문자열을 반환합니다.

func appendingPathExtension(String) -> String?

Returns a new string made by appending to the receiver an extension separator followed by a given extension.

 

var deletingLastPathComponent: String

최종 경로 구분 기호와 함께 수신자에서 마지막 경로 구성 요소를 삭제하여 만든 새 문자열입니다.

var deletingLastPathComponent: String

A new string made by deleting the last path component from the receiver, along with any final path separator.

 

var deletingPathExtension: String

수신자에서 확장 (있는 경우)을 삭제하여 만든 새 문자열입니다.

var deletingPathExtension: String

A new string made by deleting the extension (if any, and only the last) from the receiver.

 

var expandingTildeInPath: String

수신자의 초기 구성 요소를 전체 경로 값으로 확장하여 작성된 새 문자열.

var expandingTildeInPath: String

A new string made by expanding the initial component of the receiver to its full path value.

 

var resolvingSymlinksInPath: String

모든 심볼릭 링크를 해결하고 경로를 표준화하여 수신기에서 만든 새 문자열입니다.

var resolvingSymlinksInPath: String

A new string made from the receiver by resolving all symbolic links and standardizing path.

 

var standardizingPath: String

수신기에서 외부 경로 구성 요소를 제거하여 만든 새 문자열입니다.

var standardizingPath: String

A new string made by removing extraneous path components from the receiver.

 

func strings(byAppendingPaths: [String]) -> [String]

주어진 배열에서 각 문자열을 수신자에게 별도로 추가하여 작성된 문자열 배열을 리턴합니다.

func strings(byAppendingPaths: [String]) -> [String]

Returns an array of strings made by separately appending to the receiver each string in a given array.

 

 

URL 문자열을 사용한 작업

Working with URL Strings

 

func addingPercentEncoding(withAllowedCharacters: CharacterSet) -> String?

지정된 세트에 없는 모든 문자를 퍼센트로 인코딩 된 문자로 바꾸어 수신자가 작성한 새 문자열을 리턴합니다.

func addingPercentEncoding(withAllowedCharacters: CharacterSet) -> String?

Returns a new string made from the receiver by replacing all characters not in the specified set with percent-encoded characters.

 

var removingPercentEncoding: String?

인코딩 된 모든 퍼센트 시퀀스를 일치하는 UTF-8 문자로 바꾸어 수신기에서 만든 새 문자열을 반환합니다.

var removingPercentEncoding: String?

Returns a new string made from the receiver by replacing all percent encoded sequences with the matching UTF-8 characters.

 

유형 별칭

Type Aliases

 

typealias NSString.ExtendedGraphemeClusterLiteralType

typealias NSString.StringLiteralType

typealias NSString.UnicodeScalarLiteralType

 

 

Initializers

init?(coder: NSCoder)

init(format: NSString, CVarArg...)

init(format: NSString, locale: Locale?, CVarArg...)

init(string: NSString)

 

init(stringLiteral: StaticString)

값으로 초기화 된 인스턴스를 만듭니다.

init(stringLiteral: StaticString)

Create an instance initialized to value.

 

 

Type Methods

 

class func deferredLocalizedIntentsString(with: String, CVarArg...) -> NSString

class func deferredLocalizedIntentsString(with: String, table: String, CVarArg...) -> NSString

class func deferredLocalizedIntentsString(with: String, table: String, arguments: CVaListPointer) -> NSString

 

 

RelationshipsInherits From

NSObject

 

 

Conforms To

• CKRecordValueProtocol
• CVarArg
• Equatable
• ExpressibleByStringLiteral
• Hashable
• NSCopying
• NSItemProviderReading
• NSItemProviderWriting
• NSMutableCopying
• NSPasteboardReading
• NSPasteboardWriting
• NSSecureCoding