Ссылка функций основы
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
В этой главе описываются функции и подобные функции макросы, определенные в Платформе Основы.
Для получения дополнительной информации об Утверждениях посмотрите Утверждения и Регистрирующий Руководство по программированию.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert(condition, desc, ...)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для параметров....
Параметры, выведенные на экран в
desc
строка.Обсуждение
NSAssert
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert1(condition, desc, arg1)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителя для отдельного аргумента.arg1
Параметр, который будет вставлен, на месте, в
desc
.Обсуждение
NSAssert1
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания иarg1
как переменная замены.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert2(condition, desc, arg1, arg2)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для двух параметров.arg1
Параметр, который будет вставлен, на месте, в
desc
.arg2
Параметр, который будет вставлен, на месте, в
desc
.Обсуждение
NSAssert2
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания иarg1
иarg2
как переменные замены.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert3(condition, desc, arg1, arg2, arg3)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для трех параметров.arg1
Параметр, который будет вставлен, на месте, в
desc
.arg2
Параметр, который будет вставлен, на месте, в
desc
.arg3
Параметр, который будет вставлен, на месте, в
desc
.Обсуждение
NSAssert3
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания иarg1
,arg2
, иarg3
как переменные замены.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert4(condition, desc, arg1, arg2, arg3, arg4)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для четырех параметров.arg1
Параметр, который будет вставлен, на месте, в
desc
.arg2
Параметр, который будет вставлен, на месте, в
desc
.arg3
Параметр, который будет вставлен, на месте, в
desc
.arg4
Параметр, который будет вставлен, на месте, в
desc
.Обсуждение
NSAssert4
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания иarg1
,arg2
,arg3
, иarg4
как переменные замены.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
#define NSAssert5(condition, desc, arg1, arg2, arg3, arg4, arg5)
Параметры
condition
Выражение, оценивающее к
YES
true
илиNO
false
.desc
NSString
объект, содержащий aprintf
- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для пяти параметров.arg1
Параметр, который будет вставлен, на месте, в
desc
.arg2
Параметр, который будет вставлен, на месте, в
desc
.arg3
Параметр, который будет вставлен, на месте, в
desc
.arg4
Параметр, который будет вставлен, на месте, в
desc
.arg5
Параметр, который будет вставлен, на месте, в
desc
.Обсуждение
NSAssert5
макрос оценивает условие и служит фронтэндом к обработчику утверждения.Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение. Еслиcondition
оценивает кNO
false
, макрос вызываетhandleFailureInMethod:object:file:lineNumber:description:
на обработчике утверждения для текущего потока, передаваяdesc
как строка описания иarg1
,arg2
,arg3
,arg4
, иarg5
как переменные замены.Этот макрос должен использоваться только в методах Objective C.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Если данное условие является ложью, генерирует утверждение.
Объявление
Objective C
NSCAssert(condition, NSString *description)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.NSCAssert
не берет параметров кроме условия и строки формата.condition
должно быть выражение, оценивающее к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
NSCAssert1
одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.Объявление
Objective C
NSCAssert1(condition, NSString *description, arg1)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert1
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.condition
выражение должно оценить к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа.arg1
параметр, который будет вставлен, на месте, в описание.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
NSCAssert2
одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.Объявление
Objective C
NSCAssert2(condition, NSString *description, arg1, arg2)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert2
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.condition
выражение должно оценить к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа. Каждыйargn
параметр, который будет вставлен, на месте, в описание.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
NSCAssert3
одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.Объявление
Objective C
NSCAssert3(condition, NSString *description, arg1, arg2, arg3)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert3
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.condition
выражение должно оценить к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа. Каждыйargn
параметр, который будет вставлен, на месте, в описание.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
NSCAssert4
одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.Объявление
Objective C
NSCAssert4(condition, NSString *description, arg1, arg2, arg3, arg4)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert4
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.condition
выражение должно оценить к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа. Каждыйargn
параметр, который будет вставлен, на месте, в описание.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
NSCAssert5
одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.Объявление
Objective C
NSCAssert5(condition, NSString *description, arg1, arg2, arg3, arg4, arg5)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.NSCAssert5
макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.condition
выражение должно оценить к истине или лжи.description
строка формата printf-стиля, описывающая состояние отказа. Каждыйargn
параметр, который будет вставлен, на месте, в описание.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Оценивает указанный параметр.
Объявление
Objective C
NSCParameterAssert(condition)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.Этот макрос проверяет параметр для функции C. Просто обеспечьте параметр как параметр условия. Макрос оценивает параметр и, если параметр оценивает ко лжи, регистрирует сообщение об ошибке, включающее параметр и затем повышающее исключение.
Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь возврат макросовvoid
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Проверяет указанный параметр.
Объявление
Objective C
NSParameterAssert(condition)
Обсуждение
Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса
NSAssertionHandler
. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышаетNSInternalInconsistencyException
исключение.Этот макрос проверяет параметр для метода Objective C. Просто обеспечьте параметр как
condition
параметр. Макрос оценивает параметр и, если это - ложь, это регистрирует сообщение об ошибке, включающее параметр и затем повышающее исключение.Утверждения отключены если макрос препроцессора
NS_BLOCK_ASSERTIONS
определяется. Весь недействительный возврат макросов утверждения.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
Для получения дополнительной информации о генерации строковых файлов посмотрите Используя Строковые Файлы для Бывшего обращенным к пользователю текста.
-
Возвращает локализованную версию строки.
Объявление
Objective C
NSString *NSLocalizedString(NSString *key, NSString *comment)
Параметры
key
Ключ для строки в таблице по умолчанию.
comment
Комментарий для размещения выше пары ключ/значение в строковом файле.
Возвращаемое значение
Результат вызова
localizedStringForKey:value:table:
на основной передаче пакетаnil
как таблица.Обсуждение
Используйте этот макрос для генерации значения по умолчанию
Localizable.strings
файл от Вашего кода с помощьюgenstrings
утилита. Можно указать символы Unicode вkey
использование\\Uxxxx
— посмотрите-u
опция дляgenstrings
утилита. Начальное значение дляkey
в строках файл будетkey
. ИспользуйтеNSLocalizedStringWithDefaultValue
макрос для указания другого значения дляkey
.Для получения дополнительной информации посмотрите
NSBundle
.Специальные замечания
В OS X v10.4 и ранее, для обеспечения корректного парсинга
genstrings
утилита,key
параметр не должен содержать символы высокого ASCII.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную версию строки от указанной таблицы.
Объявление
Objective C
NSString *NSLocalizedStringFromTable(NSString *key, NSString *tableName, NSString *comment)
Параметры
key
Ключ для строки в указанной таблице.
tableName
Имя таблицы, содержащей пары ключ/значение. Кроме того, суффикс для строкового файла (файл с
.strings
расширение) для хранения локализованной строки.comment
Комментарий для размещения выше пары ключ/значение в строковом файле.
Возвращаемое значение
Результат вызова
localizedStringForKey:value:table:
на основном пакете, передавая его указанноеkey
иtableName
.Обсуждение
Используйте этот макрос для генерации определенных строковых названных файлов
[tableName].strings
от Вашего кода с помощьюgenstrings
утилита. Можно указать символы Unicode вkey
использование\\Uxxxx
— посмотрите-u
опция для дляgenstrings
утилита. Начальное значение дляkey
в строках файл будетkey
. ИспользуйтеNSLocalizedStringWithDefaultValue
макрос для указания другого значения дляkey
.Для получения дополнительной информации посмотрите
NSBundle
.Специальные замечания
В OS X v10.4 и ранее, для обеспечения корректного парсинга
genstrings
утилита,key
параметр не должен содержать символы высокого ASCII.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную версию строки.
Объявление
Objective C
NSString *NSLocalizedStringFromTableInBundle(NSString *key, NSString *tableName, NSBundle *bundle, NSString *comment)
Параметры
key
Ключ для строки в указанной таблице.
tableName
Имя таблицы, содержащей пары ключ/значение. Кроме того, суффикс для строкового файла (файл с
.strings
расширение) для хранения локализованной строки.bundle
Пакет, содержащий строковый файл.
comment
Комментарий для размещения выше пары ключ/значение в строковом файле.
Возвращаемое значение
Результат отправки
localizedStringForKey:value:table:
кbundle
, передача указанногоkey
иtableName
гдеvalue
параметрnil
.Обсуждение
Используйте этот макрос для генерации строковых названных файлов
[tableName].strings
расположенный вbundle
от Вашего кода с помощьюgenstrings
утилита. Можно указать символы Unicode вkey
использование\\Uxxxx
— посмотрите-u
опция для дляgenstrings
утилита. Начальное значение дляkey
в строках файл будетkey
. ИспользуйтеNSLocalizedStringWithDefaultValue
макрос для указания другого значения дляkey
.Для получения дополнительной информации посмотрите
NSBundle
.Специальные замечания
В OS X v10.4 и ранее, для обеспечения корректного парсинга
genstrings
утилита,key
параметр не должен содержать символы высокого ASCII.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную версию строки.
Объявление
Objective C
NSString *NSLocalizedStringWithDefaultValue(NSString *key, NSString *tableName, NSBundle *bundle, NSString *value, NSString *comment)
Параметры
key
Ключ для строки в указанной таблице.
tableName
Имя таблицы, содержащей пары ключ/значение. Кроме того, суффикс для строкового файла (файл с
.strings
расширение) для хранения локализованной строки.bundle
Пакет, содержащий строковый файл.
value
Значение, чтобы возвратиться, если
key
nil
или если локализованная строка дляkey
не может быть найден в таблице.comment
Комментарий для размещения выше пары ключ/значение в строковом файле.
Возвращаемое значение
Результат отправки
localizedStringForKey:value:table:
кbundle
, передача указанногоkey
,value
, иtableName
.Обсуждение
Используйте этот макрос для генерации строковых названных файлов
[tableName].strings
расположенный вbundle
от Вашего кода с помощьюgenstrings
утилита. Начальное значение дляkey
в строках файл будетvalue
. Можно указать символы Unicode вkey
использование\\Uxxxx
— посмотрите-u
опция для дляgenstrings
утилита.Для получения дополнительной информации посмотрите
NSBundle
.Специальные замечания
В OS X v10.4 и ранее, для обеспечения корректного парсинга
genstrings
утилита,key
параметр не должен содержать символы высокого ASCII.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Выполняет преобразование типов.
Объявление
Swift
func NSConvertHostDoubleToSwapped(_
x
: Double) -> NSSwappedDoubleObjective C
NSSwappedDouble NSConvertHostDoubleToSwapped ( double x );
Обсуждение
Преобразовывает двойное значение в
x
к значению, байты которого могут быть подкачаны. Эта функция фактически не подкачивает байтыx
. Вы не должны должны быть вызывать эту функцию непосредственно.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Выполняет преобразование типов.
Объявление
Swift
func NSConvertHostFloatToSwapped(_
x
: Float) -> NSSwappedFloatObjective C
NSSwappedFloat NSConvertHostFloatToSwapped ( float x );
Обсуждение
Преобразовывает значение плавающее в
x
к значению, байты которого могут быть подкачаны. Эта функция фактически не подкачивает байтыx
. Вы не должны должны быть вызывать эту функцию непосредственно.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Выполняет преобразование типов.
Объявление
Swift
func NSConvertSwappedDoubleToHost(_
x
: NSSwappedDouble) -> DoubleObjective C
double NSConvertSwappedDoubleToHost ( NSSwappedDouble x );
Обсуждение
Преобразовывает значение в
x
к двойному значению. Эта функция фактически не подкачивает байтыx
. Вы не должны должны быть вызывать эту функцию непосредственно.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Выполняет преобразование типов.
Объявление
Swift
func NSConvertSwappedFloatToHost(_
x
: NSSwappedFloat) -> FloatObjective C
float NSConvertSwappedFloatToHost ( NSSwappedFloat x );
Обсуждение
Преобразовывает значение в
x
к значению плавающему. Эта функция фактически не подкачивает байтыx
. Вы не должны должны быть вызывать эту функцию непосредственно.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает формат порядка байтов.
Возвращаемое значение
Формат порядка байтов, также
NS_LittleEndian
илиNS_BigEndian
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigDoubleToHost(_
x
: NSSwappedDouble) -> DoubleObjective C
double NSSwapBigDoubleToHost ( NSSwappedDouble x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapDouble
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigFloatToHost(_
x
: NSSwappedFloat) -> FloatObjective C
float NSSwapBigFloatToHost ( NSSwappedFloat x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapFloat
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigIntToHost(_
x
: UInt32) -> UInt32Objective C
unsigned int NSSwapBigIntToHost ( unsigned int x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapInt
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigLongLongToHost(_
x
: UInt64) -> UInt64Objective C
unsigned long long NSSwapBigLongLongToHost ( unsigned long long x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapLongLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigLongToHost(_
x
: UInt) -> UIntObjective C
unsigned long NSSwapBigLongToHost ( unsigned long x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapBigShortToHost(_
x
: UInt16) -> UInt16Objective C
unsigned short NSSwapBigShortToHost ( unsigned short x );
Обсуждение
Преобразовывает значение с обратным порядком байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapShort
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapDouble(_
x
: NSSwappedDouble) -> NSSwappedDoubleObjective C
NSSwappedDouble NSSwapDouble ( NSSwappedDouble x );
Обсуждение
Подкачивает байты
x
и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байтыx
пронумерованы от 1 до 8, эта функция подкачивает байты 1 и 8, байты 2 и 7, байты 3 и 6 и байты 4 и 5.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapFloat(_
x
: NSSwappedFloat) -> NSSwappedFloatObjective C
NSSwappedFloat NSSwapFloat ( NSSwappedFloat x );
Обсуждение
Подкачивает байты
x
и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байтыx
пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostDoubleToBig(_
x
: Double) -> NSSwappedDoubleObjective C
NSSwappedDouble NSSwapHostDoubleToBig ( double x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapDouble
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostDoubleToLittle(_
x
: Double) -> NSSwappedDoubleObjective C
NSSwappedDouble NSSwapHostDoubleToLittle ( double x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapDouble
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostFloatToBig(_
x
: Float) -> NSSwappedFloatObjective C
NSSwappedFloat NSSwapHostFloatToBig ( float x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapFloat
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostFloatToLittle(_
x
: Float) -> NSSwappedFloatObjective C
NSSwappedFloat NSSwapHostFloatToLittle ( float x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapFloat
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostIntToBig(_
x
: UInt32) -> UInt32Objective C
unsigned int NSSwapHostIntToBig ( unsigned int x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapInt
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostIntToLittle(_
x
: UInt32) -> UInt32Objective C
unsigned int NSSwapHostIntToLittle ( unsigned int x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapInt
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostLongLongToBig(_
x
: UInt64) -> UInt64Objective C
unsigned long long NSSwapHostLongLongToBig ( unsigned long long x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapLongLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostLongLongToLittle(_
x
: UInt64) -> UInt64Objective C
unsigned long long NSSwapHostLongLongToLittle ( unsigned long long x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapLongLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostLongToBig(_
x
: UInt) -> UIntObjective C
unsigned long NSSwapHostLongToBig ( unsigned long x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostLongToLittle(_
x
: UInt) -> UIntObjective C
unsigned long NSSwapHostLongToLittle ( unsigned long x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostShortToBig(_
x
: UInt16) -> UInt16Objective C
unsigned short NSSwapHostShortToBig ( unsigned short x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с обратным порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapShort
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapHostShortToLittle(_
x
: UInt16) -> UInt16Objective C
unsigned short NSSwapHostShortToLittle ( unsigned short x );
Обсуждение
Преобразовывает значение в
x
, указанный в текущем формате порядка байтов, к формату с прямым порядком байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapShort
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapInt(_
inv
: UInt32) -> UInt32Objective C
unsigned int NSSwapInt ( unsigned int inv );
Обсуждение
Подкачивает байты
iv
и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байтыinv
пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleDoubleToHost(_
x
: NSSwappedDouble) -> DoubleObjective C
double NSSwapLittleDoubleToHost ( NSSwappedDouble x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapDouble
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleFloatToHost(_
x
: NSSwappedFloat) -> FloatObjective C
float NSSwapLittleFloatToHost ( NSSwappedFloat x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapFloat
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleIntToHost(_
x
: UInt32) -> UInt32Objective C
unsigned int NSSwapLittleIntToHost ( unsigned int x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapInt
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleLongLongToHost(_
x
: UInt64) -> UInt64Objective C
unsigned long long NSSwapLittleLongLongToHost ( unsigned long long x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байты, это вызовы функцииNSSwapLongLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleLongToHost(_
x
: UInt) -> UIntObjective C
unsigned long NSSwapLittleLongToHost ( unsigned long x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байты x, это вызовы функцииNSSwapLong
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLittleShortToHost(_
x
: UInt16) -> UInt16Objective C
unsigned short NSSwapLittleShortToHost ( unsigned short x );
Обсуждение
Преобразовывает отформатированное значение прямого порядка байтов в
x
к текущему формату порядка байтов и возвратам получающееся значение. Если необходимо подкачать байтыx
, это вызовы функцииNSSwapShort
выполнять подкачку.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLong(_
inv
: UInt) -> UIntObjective C
unsigned long NSSwapLong ( unsigned long inv );
Обсуждение
Подкачивает байты
inv
и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байтыinv
пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapLongLong(_
inv
: UInt64) -> UInt64Objective C
unsigned long long NSSwapLongLong ( unsigned long long inv );
Обсуждение
Подкачивает байты
inv
и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байтыinv
пронумерованы от 1 до 8, эта функция подкачивает байты 1 и 8, байты 2 и 7, байты 3 и 6 и байты 4 и 5.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Утилита для свопинга байтов числа.
Объявление
Swift
func NSSwapShort(_
inv
: UInt16) -> UInt16Objective C
unsigned short NSSwapShort ( unsigned short inv );
Обсуждение
Подкачивает и старшие байты младшего разряда
inv
и возвращает получающееся значение.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
Можно также использовать класс NSDecimalNumber
для десятичной системы исчисления.
-
Добавляют два десятичных значения.
Объявление
Swift
func NSDecimalAdd(_
result
: UnsafeMutablePointer<NSDecimal>, _leftOperand
: UnsafePointer<NSDecimal>, _rightOperand
: UnsafePointer<NSDecimal>, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalAdd ( NSDecimal *result, const NSDecimal *leftOperand, const NSDecimal *rightOperand, NSRoundingMode roundingMode );
Обсуждение
Добавляет
leftOperand
кrightOperand
и хранит сумму вresult
.NSDecimal может представлять число максимум с 38 значительными цифрами. Если число более точно, чем это, оно должно быть округлено.
roundingMode
определяет, как округлить его. Существует четыре возможных режима округления:Возвращаемое значение указывает, встретились ли с какими-либо ограничениями машины в дополнении. Если ни с одним не встретились, функциональные возвраты
NSCalculationNoError
. Иначе это может возвратить одно из следующих значений:NSCalculationLossOfPrecision
,NSCalculationOverflow
илиNSCalculationUnderflow
. Для описаний всех этих состояний ошибки посмотритеexceptionDuringOperation:error:leftOperand:rightOperand:
в NSDecimalNumberBehaviors.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Уплотняет десятичную структуру для эффективности.
Объявление
Swift
func NSDecimalCompact(_
number
: UnsafeMutablePointer<NSDecimal>)Objective C
void NSDecimalCompact ( NSDecimal *number );
Обсуждение
Число форматов так, чтобы вычисления с помощью него привели как можно меньше память в рабочее состояние. Весь
NSDecimal...
арифметические функции ожидают компактные параметры NSDecimal.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Сравнивает два десятичных значения.
Объявление
Swift
func NSDecimalCompare(_
leftOperand
: UnsafePointer<NSDecimal>, _rightOperand
: UnsafePointer<NSDecimal>) -> NSComparisonResultObjective C
NSComparisonResult NSDecimalCompare ( const NSDecimal *leftOperand, const NSDecimal *rightOperand );
Возвращаемое значение
NSOrderedDescending
еслиleftOperand
больше, чемrightOperand
;NSOrderedAscending
еслиrightOperand
больше, чемleftOperand
; илиNSOrderedSame
если эти два операнда равны.Обсуждение
Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Копирует значение десятичного числа.
Объявление
Обсуждение
Копирует значение в
source
кdestination
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Делит одно десятичное значение на другого.
Объявление
Swift
func NSDecimalDivide(_
result
: UnsafeMutablePointer<NSDecimal>, _leftOperand
: UnsafePointer<NSDecimal>, _rightOperand
: UnsafePointer<NSDecimal>, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalDivide ( NSDecimal *result, const NSDecimal *leftOperand, const NSDecimal *rightOperand, NSRoundingMode roundingMode );
Обсуждение
Делится
leftOperand
rightOperand
и хранит частное, возможно округленное согласноroundingMode
, вresult
. ЕслиrightOperand
0, возвратыNSDivideByZero
.Для объяснений возможных возвращаемых значений и округления режимов, посмотрите
NSDecimalAdd
.Обратите внимание на то, что периодические десятичные дроби или числа с мантиссой, больше, чем 38 цифр, не могут быть представлены точно.
Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает булевскую переменную, указывающую, содержит ли данное десятичное число верный номер.
Объявление
Swift
func NSDecimalIsNotANumber(_
dcm
: UnsafePointer<NSDecimal>) -> BoolObjective C
BOOL NSDecimalIsNotANumber ( const NSDecimal *dcm );
Возвращаемое значение
YES
true
если значение вdecimal
представляет верный номер, иначеNO
false
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Умножает два десятичных числа вместе.
Объявление
Swift
func NSDecimalMultiply(_
result
: UnsafeMutablePointer<NSDecimal>, _leftOperand
: UnsafePointer<NSDecimal>, _rightOperand
: UnsafePointer<NSDecimal>, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalMultiply ( NSDecimal *result, const NSDecimal *leftOperand, const NSDecimal *rightOperand, NSRoundingMode roundingMode );
Обсуждение
Умножается
rightOperand
leftOperand
и хранит продукт, возможно округленный согласноroundingMode
, вresult
.Для объяснений возможных возвращаемых значений и округления режимов, посмотрите
NSDecimalAdd
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Умножает десятичное число на указанное питание 10.
Объявление
Swift
func NSDecimalMultiplyByPowerOf10(_
result
: UnsafeMutablePointer<NSDecimal>, _number
: UnsafePointer<NSDecimal>, _power
: Int16, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalMultiplyByPowerOf10 ( NSDecimal *result, const NSDecimal *number, short power, NSRoundingMode roundingMode );
Обсуждение
Умножается
number
power
из 10 и хранилища продукт, возможно округленный согласноroundingMode
, вresult
.Для объяснений возможных возвращаемых значений и округления режимов, посмотрите
NSDecimalAdd
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Нормализует внутренний формат двух десятичных чисел для упрощения более поздних операций.
Объявление
Swift
func NSDecimalNormalize(_
number1
: UnsafeMutablePointer<NSDecimal>, _number2
: UnsafeMutablePointer<NSDecimal>, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalNormalize ( NSDecimal *number1, NSDecimal *number2, NSRoundingMode roundingMode );
Обсуждение
NSDecimal представлен в памяти как мантисса и экспонента, выразив мантиссу значения x 10exponent. Число может иметь много представлений NSDecimal; например, следующая таблица приводит несколько допустимых представлений NSDecimal для номера 100:
Мантисса
Экспонента
100
0
10
1
1
2
Формат
number1
иnumber2
так, чтобы у них были равные экспоненты. Этот формат делает дополнение и вычитание очень удобными. ОбаNSDecimalAdd
иNSDecimalSubtract
вызватьNSDecimalNormalize
. Если Вы пишете более сложное дополнение или подпрограммы вычитания, можно хотеть использовать его.Для объяснений возможных возвращаемых значений посмотрите
NSDecimalAdd
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Повышает десятичное значение до указанного питания.
Объявление
Swift
func NSDecimalPower(_
result
: UnsafeMutablePointer<NSDecimal>, _number
: UnsafePointer<NSDecimal>, _power
: Int, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalPower ( NSDecimal *result, const NSDecimal *number, NSUInteger power, NSRoundingMode roundingMode );
Обсуждение
Повышения
number
кpower
, возможно закругление согласноroundingMode
, и хранит получающееся значение вresult
.Для объяснений возможных возвращаемых значений и округления режимов, посмотрите
NSDecimalAdd
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Округляет десятичное значение.
Объявление
Swift
func NSDecimalRound(_
result
: UnsafeMutablePointer<NSDecimal>, _number
: UnsafePointer<NSDecimal>, _scale
: Int, _roundingMode
: NSRoundingMode)Objective C
void NSDecimalRound ( NSDecimal *result, const NSDecimal *number, NSInteger scale, NSRoundingMode roundingMode );
Обсуждение
Раунды
number
прочь согласно параметрамscale
иroundingMode
и хранит результат вresult
.scale
значение указывает число цифрresult
может иметь после его десятичной точки.roundingMode
указывает способ, которым округляется число. Существует четыре возможных значения дляroundingMode
:NSRoundDown
,NSRoundUp
,NSRoundPlain
, иNSRoundBankers
. Для полных обсужденийscale
иroundingMode
, посмотритеNSDecimalNumberBehaviors
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает строковое представление десятичного значения.
Объявление
Обсуждение
Возвращает строковое представление
decimal
.locale
определяет формат десятичного разделителя.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Вычитает одно десятичное значение от другого.
Объявление
Swift
func NSDecimalSubtract(_
result
: UnsafeMutablePointer<NSDecimal>, _leftOperand
: UnsafePointer<NSDecimal>, _rightOperand
: UnsafePointer<NSDecimal>, _roundingMode
: NSRoundingMode) -> NSCalculationErrorObjective C
NSCalculationError NSDecimalSubtract ( NSDecimal *result, const NSDecimal *leftOperand, const NSDecimal *rightOperand, NSRoundingMode roundingMode );
Обсуждение
Вычитает
rightOperand
отleftOperand
и хранит различие, возможно округленное согласноroundingMode
, вresult
.Для объяснений возможных возвращаемых значений и округления режимов, посмотрите
NSDecimalAdd
.Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
Можно счесть следующие макросы реализованными в NSException.h
. Они являются устаревшими и не должны использоваться. Посмотрите, что Исключение Программирует Темы для получения информации о том, как обработать исключения.
-
Отмечает запуск домена обработки исключений.
Объявление
Objective C
NS_DURING
Обсуждение
NS_DURING
макрос отмечает запуск домена обработки исключений для раздела кода. (NS_HANDLER
макрос отмечает конец домена.) В домене обработки исключений можно повысить исключение, дав локальный обработчик исключений (или понизить обработчики исключений), шанс обработать его.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Отмечает конец локального обработчика событий.
Объявление
Objective C
NS_ENDHANDLER
Обсуждение
NS_ENDHANDLER
отмечает конец раздела кода, который является локальным обработчиком исключений. (NS_HANDLER
макросы отмечают начало этого раздела.), Если исключение повышено в домене обработки исключений, отделенномNS_DURING
иNS_HANDLER
, локальному обработчику исключений (если указано) дают шанс обработать исключение.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Отмечает конец домена обработки исключений и запуск локального обработчика исключений.
Объявление
Objective C
NS_HANDLER
Обсуждение
Макрос NS_HANDLER отмечает конец раздела кода, который является доменом обработки исключений, одновременно отмечая начало раздела кода, который является локальным обработчиком исключений для того домена. (
NS_DURING
макрос отмечает начало домена обработки исключений;NS_ENDHANDLER
отмечает конец локального обработчика исключений.), Если исключение повышено в домене обработки исключений, локальному обработчику исключений сначала дают шанс обработать исключение, прежде чем обработчикам низшего уровня дадут шанс.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Программное управление разрешениями для выхода от домена обработки исключений со значением указанного типа.
Объявление
Objective C
NS_VALUERETURN(val, type)
Параметры
val
Значение для сохранения вне домена обработки исключений.
type
Тип значения, указанного в
val
.Обсуждение
NS_VALUERETURN
макрос возвращает программное управление вызывающей стороне из домена обработки исключений — т.е. раздел кода междуNS_DURING
иNS_HANDLER
макросы, которые могли бы повысить исключение. Указанное значение (указанного типа) возвращается к вызывающей стороне. Стандартreturn
оператор не работает как ожидалось в домене обработки исключений.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Программное управление разрешениями для выхода от домена обработки исключений.
Объявление
Objective C
NS_VOIDRETURN
Обсуждение
NS_VOIDRETURN
макрос возвращает программное управление вызывающей стороне из домена обработки исключений — т.е. раздел кода междуNS_DURING
иNS_HANDLER
макросы, которые могли бы повысить исключение. Стандартreturn
оператор не работает как ожидалось в домене обработки исключений.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Создает и возвращает новый экземпляр данного класса.
Объявление
Objective C
id NSAllocateObject ( Class aClass, NSUInteger extraBytes, NSZone *zone );
Параметры
aClass
Класс которого можно создать экземпляр.
extraBytes
Число дополнительных байтов, требуемых для индексируемых переменных экземпляра (это значение обычно
0
).zone
Зона, в которой можно создать новый экземпляр (передача
NULL
указать зону по умолчанию).Возвращаемое значение
Новый экземпляр
aClass
илиnil
если не мог бы быть создан экземпляр.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
NSCopyObject
(iOS 6.0)Создает точную копию объекта.
Объявление
Objective C
id NSCopyObject ( id object, NSUInteger extraBytes, NSZone *zone );
Параметры
object
Объект скопировать.
extraBytes
Число дополнительных байтов, требуемых для индексируемых переменных экземпляра (это значение обычно
0
).zone
Зона, в которой можно создать новый экземпляр (передача
NULL
указать зону по умолчанию).Возвращаемое значение
Новый объект это - точная копия
anObject
, илиnil
еслиobject
nil
или еслиobject
не мог быть скопирован.Специальные замечания
Эта функция является опасной и очень трудной использовать правильно. Это - использование в качестве части
copyWithZone:
любым классом, который может быть разделен на подклассы, очень подвержено ошибкам. Под GC или при использовании Objective C 2.0, полностью проигнорирована зона.Эта функция, вероятно, будет осуждена после OS X v10.6.
Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 6.0.
См. также
-
Уничтожает существующий объект.
Объявление
Objective C
void NSDeallocateObject ( id object );
Параметры
object
Объект.
Обсуждение
Эта функция освобождает
object
, который, должно быть, был выделен с помощьюNSAllocateObject
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Постепенно уменьшает подсчет ссылок указанного объекта.
Объявление
Objective C
BOOL NSDecrementExtraRefCountWasZero ( id object );
Параметры
object
Объект.
Возвращаемое значение
NO
false
еслиanObject
имел дополнительный подсчет ссылок, илиYES
true
еслиanObject
не имел дополнительного подсчета ссылок — указание, что объект должен быть освобожден (сdealloc
).Обсуждение
Постепенно уменьшает “дополнительное ссылочное” количество
anObject
. Недавно созданные объекты имеют только одну фактическую ссылку, так, чтобы единственное сообщение выпуска привело к освобождаемому объекту. Дополнительные ссылки - те вне единственной исходной ссылки и обычно создаются путем отправки объекту сохранить сообщения. Ваш код не должен обычно использовать эти функции, если он не переопределяетretain
илиrelease
методы.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает подсчет ссылок указанного объекта.
Объявление
Objective C
NSUInteger NSExtraRefCount ( id object );
Параметры
object
Объект.
Возвращаемое значение
Текущий подсчет ссылок
object
.Обсуждение
Эта функция используется в сочетании с
NSIncrementExtraRefCount
иNSDecrementExtraRefCountWasZero
в ситуациях, где необходимо переопределить объектretain
иrelease
методы.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Постепенно увеличивает подсчет ссылок указанного объекта.
Объявление
Objective C
void NSIncrementExtraRefCount ( id object );
Параметры
object
Объект.
Обсуждение
Эта функция постепенно увеличивает “дополнительное ссылочное” количество
object
. Недавно созданные объекты имеют только одну фактическую ссылку, так, чтобы единственное сообщение выпуска привело к освобождаемому объекту. Дополнительные ссылки - те вне единственной исходной ссылки и обычно создаются путем отправки объекту сохранить сообщения. Ваш код не должен обычно использовать эти функции, если он не переопределяет методы сохранения или выпуска.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Указывает, должен ли быть сохранен объект.
Объявление
Objective C
BOOL NSShouldRetainWithZone ( id anObject, NSZone *requestedZone );
Параметры
anObject
Объект.
requestedZone
Зона памяти.
Возвращаемое значение
Возвраты
YES
true
еслиrequestedZone
NULL
, зона та по умолчанию или зона, в которыйanObject
был выделен; иначеNO
false
.Обсуждение
Эта функция обычно вызывается изнутри
NSObject
copyWithZone:
, при решении, сохранить лиanObject
в противоположность созданию копии его.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Получает фактический размер и выровненный размер закодированного типа.
Объявление
Swift
func NSGetSizeAndAlignment(_
typePtr
: UnsafePointer<Int8>, _sizep
: UnsafeMutablePointer<Int>, _alignp
: UnsafeMutablePointer<Int>) -> UnsafePointer<Int8>Objective C
const char * NSGetSizeAndAlignment ( const char *typePtr, NSUInteger *sizep, NSUInteger *alignp );
Обсуждение
Получает фактический размер и выровненный размер первого типа данных, представленного
typePtr
и возвращает указатель на позицию следующего типа данных вtypePtr
. Можно указатьNULL
для такжеsizep
илиalignp
проигнорировать соответствующую информацию.Значение возвратилось в
alignp
выровненный размер типа данных; например, на некоторых платформах, выровненном размере achar
в то время как фактический физический размер составляет 1 байт, могли бы быть 2 байта.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Получает класс по имени.
Объявление
Swift
func NSClassFromString(_
aClassName
: String!) -> AnyClass!Objective C
Class NSClassFromString ( NSString *aClassName );
Параметры
aClassName
Имя класса.
Возвращаемое значение
Объект класса, названный
aClassName
, илиnil
если в настоящее время не загружается никакой класс тем именем. ЕслиaClassName
nil
, возвратыnil
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает имя класса как строка.
Объявление
Swift
func NSStringFromClass(_
aClass
: AnyClass!) -> String!Objective C
NSString * NSStringFromClass ( Class aClass );
Параметры
aClass
Класс.
Возвращаемое значение
Строка, содержащая имя
aClass
. ЕслиaClass
nil
, возвратыnil
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает селектор с именем.
Объявление
Swift
func NSSelectorFromString(_
aSelectorName
: String!) -> SelectorObjective C
SEL NSSelectorFromString ( NSString *aSelectorName );
Параметры
aSelectorName
Строка любой длины, с любыми символами, который представляет имя селектора.
Возвращаемое значение
Селектор, названный
aSelectorName
. ЕслиaSelectorName
nil
, или не может быть преобразован в UTF-8 (это должно быть только вследствие недостаточно памяти), возвраты(SEL)0
.Обсуждение
Сделать селектор,
NSSelectorFromString
передает закодированное символьное представление UTF-8aSelectorName
кsel_registerName
и возвращает значение, возвращенное той функцией. Отметьте, поэтому, что, если селектор не существует, он регистрируется, и недавно зарегистрированный селектор возвращается.Вспомните что двоеточие (“”:) часть имени метода;
setHeight
не то же какsetHeight:
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает строковое представление данного селектора.
Объявление
Swift
func NSStringFromSelector(_
aSelector
: Selector) -> String!Objective C
NSString * NSStringFromSelector ( SEL aSelector );
Параметры
aSelector
Селектор.
Возвращаемое значение
Строковое представление
aSelector
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает имя протокола как строка.
Объявление
Swift
func NSStringFromProtocol(_
proto
: Protocol!) -> String!Objective C
NSString * NSStringFromProtocol ( Protocol *proto );
Параметры
proto
Протокол.
Возвращаемое значение
Строка, содержащая имя
proto
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает протокол с именем.
Объявление
Swift
func NSProtocolFromString(_
namestr
: String!) -> Protocol!Objective C
Protocol * NSProtocolFromString ( NSString *namestr );
Параметры
namestr
Имя протокола.
Возвращаемое значение
Объект протокола, названный
namestr
, илиnil
если в настоящее время не загружается никакой протокол тем именем. Еслиnamestr
nil
, возвратыnil
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Регистрирует сообщение об ошибке к Системному средству Журнала Apple.
Объявление
Objective C
void NSLog ( NSString *format, ... );
Обсуждение
Просто вызовы
NSLogv
, передача его переменное число параметров.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Регистрирует сообщение об ошибке к Системному средству Журнала Apple.
Объявление
Swift
func NSLogv(_
format
: String!, _args
: CVaListPointer)Objective C
void NSLogv ( NSString *format, va_list args );
Обсуждение
Регистрирует сообщение об ошибке к Системному средству Журнала Apple (см.
man 3 asl
). ЕслиSTDERR_FILENO
дескриптор файла был перенаправлен далеко от значения по умолчанию или идет в tty, это будет также записано там. Если Вы хотите направить вывод в другом месте, необходимо использовать пользовательское средство журналирования.Сообщение состоит из метки времени и процесса ID, снабженный префиксом к строке, в которой Вы передаете. Вы составляете эту строку со строкой формата,
format
, и один или несколько параметров, которые будут вставлены в строку. Спецификация формата, позволенная этими функциями, является этим, которое понято подNSString
форматирование возможностей (который является не обязательно набором Escape формата и отмечает понятый подprintf
). Спецификаторы поддерживаемого формата описаны в Спецификаторах Формата строки. Заключительный жесткий перевод строки добавляется к сообщению об ошибке, если Вы не присутствуете в формате.В целом необходимо использовать
NSLog
функция вместо того, чтобы вызвать эту функцию непосредственно. При использовании этой функции непосредственно Вы, должно быть, подготовили список аргумента переменной вargs
параметр путем вызова стандарта C макросva_start
. После завершения необходимо так же вызвать стандарт C макросva_end
для этого списка.Вывод от
NSLogv
сериализируется, в том только одном потоке в процессе может делать записи, описанные выше за один раз. Все попытки записи/журналирования сообщения, завершенного перед следующим потоком, могут начать его попытки.Эффекты
NSLogv
не сериализируются с подсистемами кроме обсужденных выше (таких как стандартный пакет I/O) и не производят побочные эффекты на тех подсистемах (таких как то, чтобы заставлять буферизированный вывод быть сброшенным, который может быть нежелательным).Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает строку, содержащую полное имя текущего пользователя.
Возвращаемое значение
Строка, содержащая полное имя текущего пользователя.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает путь или к корневому каталогу пользователя или к приложения, в зависимости от платформы.
Возвращаемое значение
Путь к текущему корневому каталогу..
Обсуждение
В iOS корневой каталог является каталогом песочницы приложения. В OS X это - каталог песочницы приложения или корневой каталог текущего пользователя (если приложение не находится в песочнице),
Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает путь к корневому каталогу данного пользователя.
Объявление
Параметры
userName
Имя пользователя.
Возвращаемое значение
Путь к корневому каталогу для пользователя, указанного
userName
.Обсуждение
Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает корневой каталог системы пользователя.
Объявление
Swift
func NSOpenStepRootDirectory() -> String!
Objective C
NSString * NSOpenStepRootDirectory ( void );
Возвращаемое значение
Строка, идентифицирующая корневой каталог системы пользователя.
Обсуждение
Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Создает список путей поиска каталога.
Объявление
Swift
func NSSearchPathForDirectoriesInDomains(_
directory
: NSSearchPathDirectory, _domainMask
: NSSearchPathDomainMask, _expandTilde
: Bool) -> [AnyObject]!Objective C
NSArray * NSSearchPathForDirectoriesInDomains ( NSSearchPathDirectory directory, NSSearchPathDomainMask domainMask, BOOL expandTilde );
Обсуждение
Создает список строк пути для указанных каталогов в указанных доменах. Список находится в порядке, в котором необходимо искать каталоги. Если
expandTilde
YES
true
, тильды расширены, как описано вstringByExpandingTildeInPath
.Необходимо рассмотреть использование
NSFileManager
методыURLsForDirectory:inDomains:
иURLForDirectory:inDomain:appropriateForURL:create:error:
. которые возвращают URLs, который является предпочтительным форматом.Для получения дополнительной информации об утилитах файловой системы см. Руководство по программированию Файловой системы.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает путь временного каталога для текущего пользователя.
Объявление
Swift
func NSTemporaryDirectory() -> String!
Objective C
NSString * NSTemporaryDirectory ( void );
Возвращаемое значение
Строка, содержащая путь временного каталога для текущего пользователя. Если никакой такой каталог не в настоящее время доступен, возвраты
nil
.Обсуждение
Посмотрите
NSFileManager
методURLForDirectory:inDomain:appropriateForURL:create:error:
для предпочтительных средних значений нахождения корректного временного каталога.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает имя входа в систему текущего пользователя.
Возвращаемое значение
Имя входа в систему текущего пользователя.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает булево значение, указывающее, равны ли два данных диапазона.
Объявление
Возвращаемое значение
YES
true
еслиrange1
иrange2
имейте те же расположения и длины.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает пересечение указанных диапазонов.
Объявление
Возвращаемое значение
Диапазон, описывающий пересечение
range1
иrange2
— т.е. диапазон, содержащий индексы, существующие в обоих диапазонах.Обсуждение
Если поле длины возвращенного диапазона 0, то два диапазона не пересекаются, и значение поля расположения не определено.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает булево значение, указывающее, является ли указанная позиция в данном диапазоне.
Объявление
Objective C
BOOL NSLocationInRange ( NSUInteger loc, NSRange range );
Возвращаемое значение
YES
true
еслиloc
находится вrange
— т.е. если это больше, чем или равноrange.location
и меньше, чемrange.location
плюсrange.length
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Создает новый NSRange из указанных значений.
Объявление
Objective C
NSRange NSMakeRange ( NSUInteger loc, NSUInteger len );
Возвращаемое значение
NSRange
с расположениемlocation
и длинаlength
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает сумму расположения и длину диапазона.
Объявление
Objective C
NSUInteger NSMaxRange ( NSRange range );
Возвращаемое значение
Сумма расположения и длина диапазона — т.е.
range.location
+range.length
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает диапазон от текстового представления.
Объявление
Обсуждение
Сканирования
aString
для двух целых чисел, использующихся в качестве расположения и значений длины, в том порядке, для созданияNSRange
структура. ЕслиaString
только содержит единственное целое число, оно используется в качестве значения расположения. ЕслиaString
не содержит целых чисел, эта функция возвращаетсяNSRange
структура, расположение которой и значения длины оба 0.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает строковое представление диапазона.
Объявление
Возвращаемое значение
Строка формы “{a, b}”, где a и b являются неотрицательным целочисленным представлением
aRange
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает объединение указанных диапазонов.
Объявление
Возвращаемое значение
Диапазон, покрывающий все индексы в и между
range1
иrange2
. Если один диапазон полностью содержится в другом, возвращенный диапазон равен большему диапазону.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
Существует ли функция обработчика необработанных исключений, любые неперехваченные исключения заставляют программу завершаться, если исключение не повышено во время регистрации уведомления.
-
Возвращает обработчик ошибок верхнего уровня.
Объявление
Swift
func NSGetUncaughtExceptionHandler() -> CFunctionPointer<NSUncaughtExceptionHandler>
Objective C
NSUncaughtExceptionHandler * NSGetUncaughtExceptionHandler ( void );
Возвращаемое значение
Указатель на обработку ошибок верхнего уровня функционирует, где можно выполнить журналирование на последней минуте, прежде чем завершится программа.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Изменяет обработчик ошибок верхнего уровня.
Объявление
Swift
func NSSetUncaughtExceptionHandler(_
_
: CFunctionPointer<NSUncaughtExceptionHandler>)Objective C
void NSSetUncaughtExceptionHandler ( NSUncaughtExceptionHandler * );
Обсуждение
Устанавливает функцию обработки ошибок верхнего уровня, где можно выполнить журналирование на последней минуте, прежде чем завершится программа.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Бросает указатель Objective C на Базовый указатель Основы и также передает владение вызывающей стороне.
Объявление
Swift
func CFBridgingRetain(_
X
: AnyObject!) -> AnyObject!Objective C
CFTypeRef CFBridgingRetain ( id X );
Обсуждение
Вы используете эту функцию, чтобы снять объект Objective C в качестве Базового Объекта стиля основы и взять владение объекта так, чтобы можно было управлять его временем жизни. Вы ответственны за то, что впоследствии выпустили объект, как проиллюстрировано в этом примере:
NSString *string = <#Get a string#>;
CFStringRef cfString = (CFStringRef)CFBridgingRetain(string);
// Use the CF string.
CFRelease(cfString);
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 5.0 и позже.
См. также
-
Перемещает указатель неObjective C на Objective C и также передает владение ARC.
Объявление
Objective C
id CFBridgingRelease ( CFTypeRef X );
Обсуждение
Вы используете эту функцию для кастинга Базового Объекта стиля основы в качестве объекта Objective C и владения передачи объекта к ARC, таким образом, что Вы не должны выпускать объект, как проиллюстрировано в этом примере:
CFStringRef cfName = ABRecordCopyValue(person, kABPersonFirstNameProperty);
NSString *name = (NSString *)CFBridgingRelease(cfName);
Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 5.0 и позже.
См. также
-
Выделяет новый блок памяти.
Объявление
Swift
func NSAllocateMemoryPages(_
bytes
: Int) -> UnsafeMutablePointer<Void>Objective C
void * NSAllocateMemoryPages ( NSUInteger bytes );
Обсуждение
Выделяет целое число страниц, общий размер которых является самым близким к, но не меньше, чем,
byteCount
. Выделенные страницы, как гарантируют, будут заполнены нулями. Если выделение перестало работать, повышенияNSInvalidArgumentException
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Копирует блок памяти.
Объявление
Swift
func NSCopyMemoryPages(_
source
: UnsafePointer<Void>, _dest
: UnsafeMutablePointer<Void>, _bytes
: Int)Objective C
void NSCopyMemoryPages ( const void *source, void *dest, NSUInteger bytes );
Обсуждение
Копии (или копии на записи)
byteCount
байты отsource
кdestination
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Освобождает указанный блок памяти.
Объявление
Swift
func NSDeallocateMemoryPages(_
ptr
: UnsafeMutablePointer<Void>, _bytes
: Int)Objective C
void NSDeallocateMemoryPages ( void *ptr, NSUInteger bytes );
Обсуждение
Эта функция освобождает память, выделенную с
NSAllocateMemoryPages
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает двоичный журнал размера страницы.
Возвращаемое значение
Двоичный журнал размера страницы.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает число байтов на странице.
Возвращаемое значение
Число байтов на странице.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
NSRealMemoryAvailable
(iOS 6.0)Информация о возвратах о системе пользователя.
Объявление
Objective C
NSUInteger NSRealMemoryAvailable ( void );
Возвращаемое значение
Число байтов, доступных в RAM.
Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 6.0.
-
Возвращает конкретное количество байтов, округленных в меньшую сторону до кратного числа размера страницы.
Объявление
Objective C
NSUInteger NSRoundDownToMultipleOfPageSize ( NSUInteger bytes );
Возвращаемое значение
В байтах, кратном числе размера страницы, который является самым близким к, но не больше, чем,
byteCount
(т.е. число байтов, округленных в меньшую сторону до кратного числа размера страницы).Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает конкретное количество байтов, окруженных к кратному числу размера страницы.
Объявление
Objective C
NSUInteger NSRoundUpToMultipleOfPageSize ( NSUInteger bytes );
Возвращаемое значение
В байтах, кратном числе размера страницы, который является самым близким к, но не меньше, чем,
byteCount
(т.е. число байтов, окруженных к кратному числу размера страницы).Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.
-
Делает недавно выделенный Базовый объект Основы имеющим право на набор.
Сборка «мусора» осуждается в OS X v10.8; вместо этого, необходимо использовать подсчет AutomaticReference — посмотрите Переход к Информации о версии ARC.
Объявление
Objective C
id NSMakeCollectable ( CFTypeRef cf );
Обсуждение
Эта функция является оберткой для
CFMakeCollectable
, но его тип возвратаid
— предотвращение потребности в кастинге при использовании объектов Какао.Эта функция может быть полезной при возврате Базовых объектов Основы в коде, который должен поддерживать и собрал «мусор» и несобрал «мусор» среды, как проиллюстрировано в следующем примере.
- (CFDateRef)foo {
CFDateRef aCFDate;
// ...
return [NSMakeCollectable(aCFDate) autorelease];
}
Объекты стиля CFTypeRef собраны «мусор», все же только когда-то после последнего
CFRelease
выполняется. Особенно для полностью соединенных мостом объектов CFTypeRef, таких как Кфстрингс и наборы (такие как CFDictionary), необходимо вызвать такжеCFMakeCollectable
или более безопасное с точки зрения типовNSMakeCollectable
, предпочтительно прямо после выделения.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
-
Создает новую зону.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
NSZone * NSCreateZone ( NSUInteger startSize, NSUInteger granularity, BOOL canFree );
Возвращаемое значение
Указатель на новую зону
startSize
байты, которые будут расти и уменьшатьсяgranularity
байты. ЕслиcanFree
0, средство выделения никогда не будет свободная память, иmalloc
будет быстро. ВозвратыNULL
если не могла бы быть создана новая зона.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Освобождает память в зоне.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
void NSRecycleZone ( NSZone *zone );
Обсуждение
Освобождает
zone
после добавления любого из его указателей все еще в использовании к зоне по умолчанию. (Эта стратегия препятствует сохраненным объектам быть непреднамеренно уничтоженной.)Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Определяет имя указанной зоны.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Обсуждение
Определяет имя
zone
кname
, который может помочь в отладке.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Выделяет память в зоне.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
void * NSZoneCalloc ( NSZone *zone, NSUInteger numElems, NSUInteger byteSize );
Обсуждение
Выделяет достаточно памяти от
zone
дляnumElems
элементы, каждый с размеромnumBytes
байты и возвраты указатель на выделенную память. Память инициализируется с нулями. Эта функция возвратыNULL
если это было неспособно выделить требуемую память.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Освобождает блок памяти в указанной зоне.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
void NSZoneFree ( NSZone *zone, void *ptr );
Обсуждение
Память возвратов к
zone
от которого это было выделено. Стандарт C функцияfree
делает то же, но проводит время, находя, которые зонируют память, принадлежит.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Получает зону для данного блока памяти.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
NSZone * NSZoneFromPointer ( void *ptr );
Возвращаемое значение
Зона для блока памяти, обозначенной
pointer
, илиNULL
если блок не был выделен от зоны.Обсуждение
pointer
должен быть тот, возвращенный предшествующим вызовом к функции выделения.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Выделяет память в зоне.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
void * NSZoneMalloc ( NSZone *zone, NSUInteger size );
Обсуждение
Выделяет
size
байты вzone
и возвращает указатель на выделенную память. Эта функция возвратыNULL
если это было неспособно выделить требуемую память.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает имя указанной зоны.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Возвращаемое значение
Строка, содержащая имя, связалась с
zone
. Еслиzone
nil
, зона по умолчанию используется. Если никакое имя не связано сzone
, возвращаемая строка пуста.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Выделяет память в зоне.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Objective C
void * NSZoneRealloc ( NSZone *zone, void *ptr, NSUInteger size );
Обсуждение
Изменяет размер блока памяти, которой указывают
ptr
кsize
байты. Это может выделить новую память для замены старого, когда это перемещает содержание старого блока памяти к новому блоку до максимумаsize
байты.ptr
может бытьNULL
. Эта функция возвратыNULL
если это было неспособно выделить требуемую память.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает зону по умолчанию.
Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.
Объявление
Swift
func NSDefaultMallocZone() -> NSZone
Objective C
NSZone * NSDefaultMallocZone ( void );
Возвращаемое значение
Зона по умолчанию, создающаяся автоматически при запуске.
Обсуждение
Эта зона используется стандартом C функция
malloc
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 2.0 и позже.