NSScanner

NSScanner класс является абстрактным суперклассом кластера класса, объявляющего программируемый интерфейс для объекта, сканирующего значения от NSString объект.

NSScanner объект интерпретирует и преобразовывает символы NSString объект в число и строковые значения. Вы присваиваете строку сканера при создании его, и сканер развивается через символы той строки с начала до конца, поскольку Вы запрашиваете элементы.

Из-за природы кластеров класса объекты сканера не являются фактическими экземплярами NSScanner класс, но один из его частных подклассов. Несмотря на то, что класс объекта сканера является частным, его интерфейс общедоступен, как объявлено этим абстрактным суперклассом, NSScanner. Примитивные методы NSScanner string и все методы, перечисленные при Конфигурировании Сканера. Объекты Вы создаете использование этого класса, упоминаются, поскольку сканер возражает (и когда никакой беспорядок не закончится, просто как сканеры).

Можно установить NSScanner объект проигнорировать ряд изображает, поскольку это сканирует строку с помощью charactersToBeSkipped свойство. Через символы в наборе пропуска перескакивают прежде, чем отсканировать цель. Набор по умолчанию символов для пропуска является набором символа новой строки и пробельным символом.

Для получения неотсканированного остатка от строки использовать [[scanner string] substringFromIndex:[scanner scanLocation]].

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

NSObject
NSScanner

NSObject
NSScanner

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание сканера

scannerWithString: + scannerWithString:

Возвраты NSScanner возразите, что сканирует данную строку.

Объявление

Objective C

+ (instancetype)scannerWithString:(NSString *)aString

Параметры

aString

Строка для сканирования.

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

NSScanner возразите что сканирования aString.

Обсуждение

Устанавливает строку для сканирования путем вызова initWithString: с aString.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
localizedScannerWithString (_:) + localizedScannerWithString:

Возвраты NSScanner возразите, что сканирует данную строку согласно локали пользователя по умолчанию.

Объявление

Swift

class func localizedScannerWithString(_ aString: String) -> AnyObject

Objective C

+ (id)localizedScannerWithString:(NSString *)aString

Параметры

aString

Строка для сканирования.

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

NSScanner возразите что сканирования aString согласно локали пользователя по умолчанию.

Обсуждение

Устанавливает строку для сканирования путем вызова initWithString: с aString. Локаль установлена с setLocale:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
init (строка:) - initWithString: Определяемый инициализатор

Возвраты NSScanner объект, инициализированный для сканирования данной строки.

Объявление

Swift

init(string aString: String)

Objective C

- (instancetype)initWithString:(NSString *)aString

Параметры

aString

Строка для сканирования.

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ localizedScannerWithString:
+ scannerWithString:

Получение строки сканера

строка строка Свойство

Строка сканер отсканирует. (только для чтения)

Объявление

Swift

var string: String { get }

Objective C

@property(readonly, copy) NSString *string

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Конфигурирование сканера

scanLocation scanLocation Свойство

Позиция символа, в которой получатель начнет свою следующую работу сканирования.

Объявление

Swift

var scanLocation: Int

Objective C

@property NSUInteger scanLocation

Обсуждение

Повышения NSRangeException если index вне конца отсканированной строки.

Это свойство полезно для поддержки, чтобы повторно отсканировать после ошибки.

Вместо того, чтобы устанавливать расположение сканирования непосредственно для пропуска известных последовательностей символов использовать scanString:intoString: или scanCharactersFromSet:intoString:, которые позволяют Вам проверять, что фактически присутствует ожидаемая подстрока (или набор символов).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
чувствительный к регистру чувствительный к регистру Свойство

Флаг, указывающий, отличает ли получатель случай в символах, которые это сканирует.

Объявление

Swift

var caseSensitive: Bool

Objective C

@property BOOL caseSensitive

Обсуждение

YEStrue если получатель отличает случай в символах, это сканирует, иначе NOfalse. Значение по умолчанию NOfalse. Обратите внимание на то, что чувствительность к регистру не применяется к символам, которые будут пропущены.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

charactersToBeSkipped
charactersToBeSkipped charactersToBeSkipped Свойство

Набор символов, содержащий символы сканер, игнорирует при поиске поддающегося сканированию элемента.

Объявление

Swift

@NSCopying var charactersToBeSkipped: NSCharacterSet?

Objective C

@property(copy) NSCharacterSet *charactersToBeSkipped

Обсуждение

Символы, которые будут пропущены, пропускаются до сканера, исследующего цель. Например, если сканер игнорирует пробелы, и Вы отправляете ему a scanInt: сообщение, это пропускает пробелы, пока это не находит десятичную цифру или другой символ. В то время как элемент сканируется, никакие символы не пропускаются. Если Вы сканируете для чего-то сделанного из символов в наборе, который будет пропущен (например, с помощью scanInt: когда набор символов, которые будут пропущены, является десятичными цифрами), результат не определен.

Символы, которые будут пропущены, обрабатываются как единственные значения. Сканер не применяет свою установку чувствительности к регистру в эти символы и не пытается соответствовать составленные последовательности символов чему-либо в наборе символов, которые будут пропущены (хотя это действительно соответствует предварительно составленные символы индивидуально). Если Вы хотите пропустить все гласные при сканировании строки, например, можно установить символы, которые будут пропущены тем в строке «AEIOUaeiou» (плюс любые варианты с диакритическим знаком с предсоставленными символами).

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

whitespaceAndNewlineCharacterSet (NSCharacterSet)
локаль локаль Свойство

Локаль для использования при сканировании.

Объявление

Swift

var locale: AnyObject?

Objective C

@property(retain) id locale

Обсуждение

Локаль сканера влияет на способ, которым она интерпретирует числовые значения от строки. В частности сканер использует десятичный разделитель локали для различения целых и дробных частей представлений с плавающей точкой. Сканер без локали установил нелокализованные значения использования. Новые сканеры не имеют никакой локали по умолчанию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Сканирование строки


    
    scanCharactersFromSet (_: intoString:)
    - scanCharactersFromSet:intoString:

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

Объявление

Swift

func scanCharactersFromSet(_ scanSet: NSCharacterSet, intoString stringValue: AutoreleasingUnsafeMutablePointer<NSString?>) -> Bool

Objective C

- (BOOL)scanCharactersFromSet:(NSCharacterSet *)scanSet intoString:(NSString **)stringValue

Параметры

`scanSet`	Набор символов для сканирования.
`stringValue`	По возврату, содержит отсканированные символы.

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

YEStrue если получатель отсканировал какие-либо символы, иначе NOfalse.

Обсуждение

Вызовите этот метод с NULL как stringValue просто отсканировать мимо данного набора символов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanUpToCharactersFromSet:intoString:


    
    scanUpToCharactersFromSet (_: intoString:)
    - scanUpToCharactersFromSet:intoString:

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

Объявление

Swift

func scanUpToCharactersFromSet(_ stopSet: NSCharacterSet, intoString stringValue: AutoreleasingUnsafeMutablePointer<NSString?>) -> Bool

Objective C

- (BOOL)scanUpToCharactersFromSet:(NSCharacterSet *)stopSet intoString:(NSString **)stringValue

Параметры

`stopSet`	Набор символов, до которых можно отсканировать.
`stringValue`	По возврату, содержит отсканированные символы.

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

YEStrue если получатель отсканировал какие-либо символы, иначе NOfalse.

Если единственные отсканированные символы находятся в charactersToBeSkipped набор символов (который является пробельным символом и набором символа новой строки по умолчанию), затем возвращается NOfalse.

Обсуждение

Вызовите этот метод с NULL как stringValue просто отсканировать до данного набора символов.

Если никакие символы в stopSet присутствуют в исходной строке сканера, остаток от исходной строки помещается в stringValue, получатель scanLocation совершенствуется до конца исходной строки и возвратов метода YEStrue.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanCharactersFromSet:intoString:


    
    scanDecimal (_:)
    - scanDecimal:

Сканирования для NSDecimal значение, возвращая найденное значение ссылкой.

Объявление

Swift

func scanDecimal(_ decimalValue: COpaquePointer) -> Bool

Objective C

- (BOOL)scanDecimal:(NSDecimal *)decimalValue

Параметры


      decimalValue

По возврату, содержит отсканированное значение. Посмотрите NSDecimalNumber спецификация класса для получения дополнительной информации о NSDecimal значения.

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

YEStrue если получатель находит допустимое NSDecimal представление, иначе NOfalse.

Обсуждение

Вызовите этот метод с NULL как decimalValue просто отсканировать мимо NSDecimal представление.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    scanDouble (_:)
    - scanDouble:

Сканирования для двойного значения, возвращая найденное значение ссылкой.

Объявление

Swift

func scanDouble(_ doubleValue: UnsafeMutablePointer<Double>) -> Bool

Objective C

- (BOOL)scanDouble:(double *)doubleValue

Параметры


      doubleValue

По возврату, содержит отсканированное значение. Содержит HUGE_VAL или –HUGE_VAL на переполнении, или 0.0 на потере значимости.

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

YEStrue если получатель находит допустимое представление с плавающей точкой, иначе NOfalse. Переполнение или потерю значимости оба считают допустимыми представлениями с плавающей точкой.

Обсуждение

Прошлые избыточные цифры пропусков в случае переполнения, таким образом, позиция сканера проходит все представление с плавающей точкой.

Вызовите этот метод с NULL как doubleValue просто отсканировать мимо двойного представления значения. Представлениями с плавающей точкой, как предполагается, является совместимый IEEE.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

doubleValue (NSString)


    
    scanFloat (_:)
    - scanFloat:

Сканирования для значения плавающего, возвращая найденное значение ссылкой.

Объявление

Swift

func scanFloat(_ floatValue: UnsafeMutablePointer<Float>) -> Bool

Objective C

- (BOOL)scanFloat:(float *)floatValue

Параметры


      floatValue

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

Обсуждение

Вызовите этот метод с NULL как floatValue просто отсканировать мимо представления значения плавающего. Представлениями с плавающей точкой, как предполагается, является совместимый IEEE.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

floatValue (NSString)


    
    scanHexDouble (_:)
    - scanHexDouble:

Сканирования для двойного значения от шестнадцатеричного представления, возвращая найденное значение ссылкой.

Объявление

Swift

func scanHexDouble(_ result: UnsafeMutablePointer<Double>) -> Bool

Objective C

- (BOOL)scanHexDouble:(double *)result

Параметры


      result

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

YEStrue если получатель находит допустимое представление двойной точки, иначе NOfalse. Переполнение или потерю значимости оба считают допустимыми представлениями с плавающей точкой.

Обсуждение

Это соответствует %a или %A форматирование. Шестнадцатеричным двойным представлением нужно предшествовать 0x или 0X.

Вызовите этот метод с NULL как result просто отсканировать мимо шестнадцатеричного двойного представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    scanHexFloat (_:)
    - scanHexFloat:

Объявление

Swift

func scanHexFloat(_ result: UnsafeMutablePointer<Float>) -> Bool

Objective C

- (BOOL)scanHexFloat:(float *)result

Параметры


      result

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

Обсуждение

Это соответствует %a или %A форматирование. Шестнадцатеричным представлением плавающим нужно предшествовать 0x или 0X.

Вызовите этот метод с NULL как result просто отсканировать мимо шестнадцатеричного представления плавающего.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    scanHexInt (_:)
    - scanHexInt:

Сканирования для значения без знака от шестнадцатеричного представления, возвращая найденное значение ссылкой.

Объявление

Swift

func scanHexInt(_ intValue: UnsafeMutablePointer<UInt32>) -> Bool

Objective C

- (BOOL)scanHexInt:(unsigned int *)intValue

Параметры


      intValue

По возврату, содержит отсканированное значение. Содержит UINT_MAX на переполнении.

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

Возвраты YEStrue если получатель находит допустимое шестнадцатеричное целочисленное представление, иначе NOfalse. Переполнение считают допустимым шестнадцатеричным целочисленным представлением.

Обсуждение

Шестнадцатеричным целочисленным представлением можно дополнительно предшествовать 0x или 0X. Прошлые избыточные цифры пропусков в случае переполнения, таким образом, позиция получателя проходит все шестнадцатеричное представление.

Вызовите этот метод с NULL как intValue просто отсканировать мимо шестнадцатеричного целочисленного представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    scanHexLongLong (_:)
    - scanHexLongLong:

Сканирования для длинного длинного значения от шестнадцатеричного представления, возвращая найденное значение ссылкой.

Объявление

Swift

func scanHexLongLong(_ result: UnsafeMutablePointer<UInt64>) -> Bool

Objective C

- (BOOL)scanHexLongLong:(unsigned long long *)result

Параметры


      result

По возврату, содержит отсканированное значение. Содержит HUGE_VAL или –HUGE_VAL на переполнении.

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

YEStrue если получатель находит допустимое шестнадцатеричное долгое долгое представление, иначе NOfalse. Переполнение считают допустимым шестнадцатеричным долгим долгим представлением.

Обсуждение

Вызовите этот метод с NULL как result просто отсканировать мимо шестнадцатеричного долгого долгого представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanLongLong:
– scanUnsignedLongLong:


    
    scanInteger (_:)
    - scanInteger:

Сканирования для NSInteger оценивают от десятичного представления, возвращая найденное значение ссылкой

Объявление

Swift

func scanInteger(_ value: UnsafeMutablePointer<Int>) -> Bool

Objective C

- (BOOL)scanInteger:(NSInteger *)value

Параметры


      value

По возврату, содержит отсканированное значение. Содержит INT_MAX или INT_MIN на переполнении.

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

YEStrue если получатель находит допустимое целочисленное представление, иначе NOfalse. Переполнение считают допустимым целочисленным представлением.

Обсуждение

Прошлые избыточные цифры пропусков в случае переполнения, таким образом, позиция получателя проходит все целочисленное представление.

Вызовите этот метод с NULL как value просто отсканировать мимо десятичного целочисленного представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

integerValue (NSString)
– scanInt:


    
    scanInt (_:)
    - scanInt:

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

Объявление

Swift

func scanInt(_ intValue: UnsafeMutablePointer<Int32>) -> Bool

Objective C

- (BOOL)scanInt:(int *)intValue

Параметры


      intValue

По возврату, содержит отсканированное значение. Содержит INT_MAX или INT_MIN на переполнении.

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

YEStrue если получатель находит допустимое десятичное целочисленное представление, иначе NOfalse. Переполнение считают допустимым целочисленным представлением.

Обсуждение

Прошлые избыточные цифры пропусков в случае переполнения, таким образом, позиция получателя проходит все десятичное представление.

Вызовите этот метод с NULL как intValue просто отсканировать мимо десятичного целочисленного представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

intValue (NSString)
– scanInteger:


    
    scanLongLong (_:)
    - scanLongLong:

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

Объявление

Swift

func scanLongLong(_ longLongValue: UnsafeMutablePointer<Int64>) -> Bool

Objective C

- (BOOL)scanLongLong:(long long *)longLongValue

Параметры


      longLongValue

По возврату, содержит отсканированное значение. Содержит LLONG_MAX или LLONG_MIN на переполнении.

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

YEStrue если получатель находит допустимое десятичное целочисленное представление, иначе NOfalse. Переполнение считают допустимым десятичным целочисленным представлением.

Обсуждение

Все цифры переполнения пропускаются. Прошлые избыточные цифры пропусков в случае переполнения, таким образом, позиция получателя проходит все десятичное представление.

Вызовите этот метод с NULL как longLongValue просто отсканировать мимо долгого десятичного целочисленного представления.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanUnsignedLongLong:
– scanHexLongLong:


    
    scanString (_: intoString:)
    - scanString:intoString:

Если соответствие найдено, сканирует данную строку, возвращая эквивалентный строковый объект ссылкой.

Объявление

Swift

func scanString(_ string: String, intoString stringValue: AutoreleasingUnsafeMutablePointer<NSString?>) -> Bool

Objective C

- (BOOL)scanString:(NSString *)string intoString:(NSString **)stringValue

Параметры

`string`	Строка, для которой можно отсканировать в текущем расположении сканирования.
`stringValue`	По возврату, если получатель содержит строку, эквивалентную `string` в текущем расположении сканирования, содержит строку, эквивалентную `string`.

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

YEStrue если string соответствует символы в расположении сканирования, иначе NOfalse.

Обсуждение

Если string присутствует в текущем расположении сканирования, тогда текущее расположение сканирования совершенствуется к после строки; иначе расположение сканирования не изменяется.

Вызовите этот метод с NULL как stringValue просто отсканировать мимо данной строки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanUpToString:intoString:


    
    scanUnsignedLongLong (_:)
    - scanUnsignedLongLong:

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

Объявление

Swift

func scanUnsignedLongLong(_ unsignedLongLongValue: UnsafeMutablePointer<UInt64>) -> Bool

Objective C

- (BOOL)scanUnsignedLongLong:(unsigned long long *)unsignedLongLongValue

Параметры


      unsignedLongLongValue

По возврату, содержит отсканированное значение. Содержит ULLONG_MAX на переполнении.

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

Обсуждение

Вызовите этот метод с NULL как unsignedLongLongValue просто отсканировать мимо долгого десятичного целочисленного представления без знака.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanLongLong:
– scanHexLongLong:


    
    scanUpToString (_: intoString:)
    - scanUpToString:intoString:

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

Объявление

Swift

func scanUpToString(_ stopString: String, intoString stringValue: AutoreleasingUnsafeMutablePointer<NSString?>) -> Bool

Objective C

- (BOOL)scanUpToString:(NSString *)stopString intoString:(NSString **)stringValue

Параметры

`stopString`	Строка для сканирования до.
`stringValue`	По возврату, содержит любые отсканированные символы.

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

YEStrue если получатель сканирует какие-либо символы, иначе NOfalse.

Если единственные отсканированные символы находятся в charactersToBeSkipped набор символов (который по умолчанию является пробельным символом и набором символа новой строки), тогда этот метод возвраты NOfalse.

Обсуждение

Если stopString присутствует в получателе, затем по возврату, расположение сканирования установлено в начало той строки.

Если stopString первая строка в получателе, тогда возвраты метода NOfalse и stringValue не изменяется.

Если строка поиска (stopString) не присутствует в исходной строке сканера, остаток от исходной строки помещается в stringValue, получатель scanLocation совершенствуется до конца исходной строки и возвратов метода YEStrue.

Вызовите этот метод с NULL как stringValue просто отсканировать до данной строки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– scanString:intoString:

принять участие принять участие Свойство

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

Объявление

Swift

var atEnd: Bool { get }

Objective C

@property(getter=isAtEnd, readonly) BOOL atEnd

Обсуждение

YEStrue если получатель исчерпал все значительные символы в своей строке, иначе NOfalse.

Если только символы от набора, возвраты, который будет пропущен остаются YEStrue.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

charactersToBeSkipped