NSLengthFormatter
NSLengthFormatter
класс предоставляет должным образом отформатированные, локализованные описания линейных расстояний (например, длина и измерения высоты). Используйте этот класс для создания локализованных строк длины при отображении информации о расстоянии пользователям.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
Печатаемый
-
NSCoding
-
NSCopying
-
NSObject
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.10 и позже.
-
forPersonHeightUse forPersonHeightUse
СвойствоБулево значение, указывающее, представляет ли получившая строка высоту лица.
Объявление
Swift
var forPersonHeightUse: Bool
Objective C
@property(getter=isForPersonHeightUse) BOOL forPersonHeightUse
Обсуждение
YES
true
, если значение передалоstringFromMeters:
илиunitStringFromMeters:usedUnit:
высота лица; иначе,NO
false
. Это свойство значения по умолчанию кNO
false
.Средство форматирования длины использует это свойство при определении лучшего модуля для данной локали (например, в
stringFromMeters:
метод).Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Этот метод не поддерживается для
NSLengthFormatter
класс.Объявление
Параметры
obj
Выходной параметр. Если переопределено, этот параметр должен содержать объект, создаваемый из предоставленной строки.
string
Строковое представление объекта.
error
Выходной параметр. Если переопределено, этот параметр должен содержать описание любых происходящих ошибок. Если Вы не хотите получать сообщения об ошибках, установите этот параметр на
NULL
.Возвращаемое значение
YES
true
если преобразование из строки было успешно; иначе,NO
false
.Обсуждение
Можно переопределить этот метод в подклассе. Для получения дополнительной информации см. Ссылку класса NSFormatter.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
numberFormatter numberFormatter
СвойствоСредство форматирования числа раньше форматировало числа в строках длины.
Объявление
Swift
@NSCopying var numberFormatter: NSNumberFormatter!
Objective C
@property(copy) NSNumberFormatter *numberFormatter
Обсуждение
Это свойство значения по умолчанию к средству форматирования числа с помощью
NSNumberFormatterDecimalStyle
. Можно обеспечить различное средство форматирования числа для настройки появления строки длины.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Возвращает строку длины для предоставленного значения.
Объявление
Objective C
- (NSString *)stringFromMeters:(double)
numberInMeters
Параметры
numberInMeters
Значение длины в метрах.
Возвращаемое значение
Строка, комбинирующая значение и строку модуля, подходящую для локали средства форматирования.
Обсуждение
Этот метод преобразовывает предоставленную длину в модули, подходящие для локали средства форматирования.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Возвращает должным образом отформатированную строку длины для данного значения и модуля.
Объявление
Swift
func stringFromValue(_
value
: Double, unitunit
: NSLengthFormatterUnit) -> StringObjective C
- (NSString *)stringFromValue:(double)
value
unit:(NSLengthFormatterUnit)unit
Параметры
value
Значение длины в данном модуле.
unit
Модуль используется в получающейся строке длины.
Возвращаемое значение
Локализованная строка, комбинирующая предоставленное значение и модуль.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Возвращает строку модуля для предоставленного значения.
Объявление
Swift
func unitStringFromMeters(_
numberInMeters
: Double, usedUnitunitp
: UnsafeMutablePointer<NSLengthFormatterUnit>) -> StringObjective C
- (NSString *)unitStringFromMeters:(double)
numberInMeters
usedUnit:(NSLengthFormatterUnit *)unitp
Параметры
numberInMeters
Значение длины в метрах.
unitp
Выходной параметр. Это будет содержать
NSLengthFormatterUnit
значение, соответствующее возвращенным модулям.Возвращаемое значение
Локализованная строка, представляющая модуль.
Обсуждение
Этот метод выбирает корректный модуль на основе локали средства форматирования, величины значения, и
forPersonHeightUse
свойство.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Возвращает строку модуля на основе предоставленного значения и модуля.
Объявление
Swift
func unitStringFromValue(_
value
: Double, unitunit
: NSLengthFormatterUnit) -> StringObjective C
- (NSString *)unitStringFromValue:(double)
value
unit:(NSLengthFormatterUnit)unit
Параметры
value
Значение длины для предоставленного модуля.
unit
Модуль для использования в получающейся строке длины.
Возвращаемое значение
Локализованная строка, представляющая данный модуль. Предоставленное значение определяет, является ли модуль множественным числом или исключительный.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Стиль модуля используется этим средством форматирования.
Объявление
Swift
var unitStyle: NSFormattingUnitStyle
Objective C
@property NSFormattingUnitStyle unitStyle
Обсуждение
Это свойство значения по умолчанию к
NSFormattingUnitStyleMedium
. Для полного списка стилей модуля посмотритеFormatting Units
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Модули, поддерживаемые
NSLengthFormatter
класс.Объявление
Swift
enum NSLengthFormatterUnit : Int { case Millimeter case Centimeter case Meter case Kilometer case Inch case Foot case Yard case Mile }
Objective C
typedef enum : NSInteger { NSLengthFormatterUnitMillimeter = 8, NSLengthFormatterUnitCentimeter = 9, NSLengthFormatterUnitMeter = 11, NSLengthFormatterUnitKilometer = 14, NSLengthFormatterUnitInch = (5 << 8) + 1, NSLengthFormatterUnitFoot = (5 << 8) + 2, NSLengthFormatterUnitYard = (5 << 8) + 3, NSLengthFormatterUnitMile = (5 << 8) + 4, } NSLengthFormatterUnit;
Константы
-
Millimeter
NSLengthFormatterUnitMillimeter
Модуль миллиметра.
Доступный в OS X v10.10 и позже.
-
Centimeter
NSLengthFormatterUnitCentimeter
Модуль сантиметра.
Доступный в OS X v10.10 и позже.
-
Meter
NSLengthFormatterUnitMeter
Модуль метра.
Доступный в OS X v10.10 и позже.
-
Kilometer
NSLengthFormatterUnitKilometer
Модуль километра.
Доступный в OS X v10.10 и позже.
-
Inch
NSLengthFormatterUnitInch
Модуль дюйма.
Доступный в OS X v10.10 и позже.
-
Foot
NSLengthFormatterUnitFoot
Модуль ноги.
Доступный в OS X v10.10 и позже.
-
Yard
NSLengthFormatterUnitYard
Модуль двора.
Доступный в OS X v10.10 и позже.
-
Mile
NSLengthFormatterUnitMile
Модуль мили.
Доступный в OS X v10.10 и позже.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-