NSMutableString

NSMutableString класс объявляет программируемый интерфейс к объекту, управляющему непостоянной строкой — т.е. строка, содержание которой может быть отредактировано — который концептуально представляет массив символов Unicode. Чтобы создать и управлять неизменной строкой — или строкой, которая не может быть изменена после того, как это было создано — используют объект NSString класс.

NSMutableString класс добавляет один примитивный метод —replaceCharactersInRange:withString:— к основному обрабатывающему строку поведению, наследованному от NSString. Все другие методы, изменяющие строковую работу через этот метод. Например, insertString:atIndex: просто заменяет символы в диапазоне 0 длина, в то время как deleteCharactersInRange: заменяет символы в данном диапазоне без символов.

NSMutableString “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFMutableStringRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации.

Наследование

NSObject
NSString
NSMutableString

NSObject
NSString
NSMutableString

Соответствует

AnyObject
CKRecordValue
CVarArgType
Сопоставимый
Hashable
NSCoding
NSCopying
NSMutableCopying
NSObjectProtocol
NSPasteboardReading
NSPasteboardWriting
NSSecureCoding
Печатаемый
Reflectable
StringLiteralConvertible
NSCopying
NSMutableCopying
NSObject
NSSecureCoding

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.

Создание и инициализация непостоянной строки

stringWithCapacity: + stringWithCapacity:

Возвращает пустое NSMutableString объект с исходной системой хранения для данного числа символов.

Объявление

Objective C

+ (NSMutableString *)stringWithCapacity:(NSUInteger)capacity

Параметры

capacity

Число символов строка, как ожидают, первоначально будет содержать.

Возвращаемое значение

Пустое NSMutableString объект с исходной системой хранения для capacity символы.

Обсуждение

Число символов, обозначенных capacity просто подсказка для увеличения эффективности хранения данных. Значение не ограничивает длину строки.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
init (способность:) - initWithCapacity:

Возвраты NSMutableString объект, инициализированный с исходной системой хранения для данного числа символов,

Объявление

Swift

init(capacity capacity: Int)

Objective C

- (NSMutableString *)initWithCapacity:(NSUInteger)capacity

Параметры

capacity

Число символов строка, как ожидают, первоначально будет содержать.

Возвращаемое значение

Инициализированный NSMutableString объект с исходной системой хранения для capacity символы. Возвращенный объект мог бы отличаться, чем исходный получатель.

Обсуждение

Число символов, обозначенных capacity просто подсказка для увеличения эффективности хранения данных. Значение не ограничивает длину строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.

Изменение строки


    
    appendFormat:
    - appendFormat:

Добавляет созданная строка к получателю.

Объявление

Objective C

- (void)appendFormat:(NSString *)format, ...

Параметры

`format`	Строка формата. Посмотрите Строковые Объекты Форматирования для получения дополнительной информации. Это значение не должно быть `nil`. Важный Повышения `NSInvalidArgumentException` если `format` `nil`.
`...`	Список разделенных запятой значений параметров для замены в `format`.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.

См. также

– appendString:

appendString (_:) - appendString:

Добавляет до конца получателя символы данной строки.

Объявление

Swift

func appendString(_ aString: String)

Objective C

- (void)appendString:(NSString *)aString

Параметры

aString

Строка для добавления к получателю. aString не должен быть nil

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.

См. также

– appendFormat:


    
    deleteCharactersInRange (_:)
    - deleteCharactersInRange:

Удаляет из получателя символы в данном диапазоне.

Объявление

Swift

func deleteCharactersInRange(_ aRange: NSRange)

Objective C

- (void)deleteCharactersInRange:(NSRange)aRange

Параметры


      aRange

Диапазон символов для удаления. aRange не должен превышать границы получателя.

Обсуждение

Этот метод обрабатывает длину строки как допустимое значение диапазона, возвращающее пустую строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.


    
    insertString (_: atIndex:)
    - insertString:atIndex:

Вставляет в получатель символы данной строки в данном расположении.

Объявление

Swift

func insertString(_ aString: String, atIndex anIndex: Int)

Objective C

- (void)insertString:(NSString *)aString atIndex:(NSUInteger)anIndex

Параметры

`aString`	Строка для вставки в получатель. `aString` не должен быть `nil`.
`anIndex`	Расположение то, в который `aString` вставляется. Расположение не должно превышать границы получателя. Важный Повышения `NSRangeException` если `anIndex` лежит за пределами конца строки.

Обсуждение

Новые символы начинаются в anIndex и существующие символы от anIndex до конца смещаются на длину aString.

Этот метод обрабатывает длину строки как допустимое индексное значение, возвращающее пустую строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.


    
    replaceCharactersInRange (_: withString:)
    - replaceCharactersInRange:withString:

Заменяет символы от aRange с теми в aString.

Объявление

Swift

func replaceCharactersInRange(_ aRange: NSRange, withString aString: String)

Objective C

- (void)replaceCharactersInRange:(NSRange)aRange withString:(NSString *)aString

Параметры

`aRange`	Диапазон символов для замены. `aRange` не должен превышать границы получателя. Важный Повышения `NSRangeException` если любая часть `aRange` лежит за пределами конца получателя.
`aString`	Строка, которой можно заменить символы в `aRange`. `aString` не должен быть `nil`.

Обсуждение

Этот метод обрабатывает длину строки как допустимое значение диапазона, возвращающее пустую строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.


    
    replaceOccurrencesOfString (_: withString:options:range:)
    - replaceOccurrencesOfString:withString:options:range:

Замены все случаи данной строки в данном диапазоне с другой данной строкой, возвращая число замен.

Объявление

Swift

func replaceOccurrencesOfString(_ target: String, withString replacement: String, options opts: NSStringCompareOptions, range searchRange: NSRange) -> Int

Objective C

- (NSUInteger)replaceOccurrencesOfString:(NSString *)target withString:(NSString *)replacement options:(NSStringCompareOptions)opts range:(NSRange)searchRange

Параметры

`target`	Строка для замены. Важный Повышения `NSInvalidArgumentException` если `target` `nil`.
`replacement`	Строка, которой можно заменить `target`. Важный Повышения `NSInvalidArgumentException` если `replacement` `nil`.
`opts`	Маска, указывающая параметры поиска. См. Строковое Руководство по программированию для подробных данных. Если `opts` `NSBackwardsSearch`, поиск сделан от конца диапазона. Если `opts` `NSAnchoredSearch`, только привязанный (но потенциально многократный) экземпляры заменяются. `NSLiteralSearch` и `NSCaseInsensitiveSearch` также применяйтесь.
`searchRange`	Диапазон символов для замены. `aRange` не должен превышать границы получателя. Указать `searchRange` как `NSMakeRange(0, [receiver length])` обработать всю строку. Важный Повышения `NSRangeException` если любая часть `searchRange` лежит за пределами конца получателя.

Возвращаемое значение

Число замен сделано.

Обсуждение

Этот метод обрабатывает длину строки как допустимое значение диапазона, возвращающее пустую строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 и позже.


    
    setString (_:)
    - setString:

Заменяет символы получателя с теми в данной строке.

Объявление

Swift

func setString(_ aString: String)

Objective C

- (void)setString:(NSString *)aString

Параметры


      aString

Строка, которой можно заменить содержание получателя. aString не должен быть nil.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.