Ссылка функций основы

В этой главе описываются функции и подобные функции макросы, определенные в Платформе Основы.

Функции

Утверждения

Для получения дополнительной информации об Утверждениях посмотрите Утверждения и Регистрирующий Руководство по программированию.


    
    NSAssert
    NSAssert

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert(condition, desc, ...)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для параметров.
`...`	Параметры, выведенные на экран в `desc` строка.

Обсуждение

NSAssert макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение. Если condition оценивает к NOfalse, макрос вызывает handleFailureInMethod:object:file:lineNumber:description: на обработчике утверждения для текущего потока, передавая desc как строка описания.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert1
NSCAssert
NSCParameterAssert
NSParameterAssert


    
    NSAssert1
    NSAssert1

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert1(condition, desc, arg1)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителя для отдельного аргумента.
`arg1`	Параметр, который будет вставлен, на месте, в `desc`.

Обсуждение

NSAssert1 макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSAssert2
NSAssert3
NSAssert4
NSAssert5
NSCAssert
NSCParameterAssert
NSParameterAssert


    
    NSAssert2
    NSAssert2

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert2(condition, desc, arg1, arg2)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для двух параметров.
`arg1`	Параметр, который будет вставлен, на месте, в `desc`.
`arg2`	Параметр, который будет вставлен, на месте, в `desc`.

Обсуждение

NSAssert2 макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSAssert1
NSAssert3
NSAssert4
NSAssert5
NSCAssert
NSCParameterAssert
NSParameterAssert


    
    NSAssert3
    NSAssert3

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert3(condition, desc, arg1, arg2, arg3)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для трех параметров.
`arg1`	Параметр, который будет вставлен, на месте, в `desc`.
`arg2`	Параметр, который будет вставлен, на месте, в `desc`.
`arg3`	Параметр, который будет вставлен, на месте, в `desc`.

Обсуждение

NSAssert3 макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSAssert1
NSAssert2
NSAssert4
NSAssert5
NSCAssert
NSCParameterAssert
NSParameterAssert


    
    NSAssert4
    NSAssert4

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert4(condition, desc, arg1, arg2, arg3, arg4)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для четырех параметров.
`arg1`	Параметр, который будет вставлен, на месте, в `desc`.
`arg2`	Параметр, который будет вставлен, на месте, в `desc`.
`arg3`	Параметр, который будет вставлен, на месте, в `desc`.
`arg4`	Параметр, который будет вставлен, на месте, в `desc`.

Обсуждение

NSAssert4 макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSAssert1
NSAssert2
NSAssert3
NSAssert5
NSCAssert
NSCParameterAssert
NSParameterAssert


    
    NSAssert5
    NSAssert5

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

#define NSAssert5(condition, desc, arg1, arg2, arg3, arg4, arg5)

Параметры

`condition`	Выражение, оценивающее к `YEStrue` или `NOfalse`.
`desc`	`NSString` объект, содержащий a `printf`- строка стиля, содержащая сообщение об ошибке, описывающее состояние отказа и заполнителей для пяти параметров.
`arg1`	Параметр, который будет вставлен, на месте, в `desc`.
`arg2`	Параметр, который будет вставлен, на месте, в `desc`.
`arg3`	Параметр, который будет вставлен, на месте, в `desc`.
`arg4`	Параметр, который будет вставлен, на месте, в `desc`.
`arg5`	Параметр, который будет вставлен, на месте, в `desc`.

Обсуждение

NSAssert5 макрос оценивает условие и служит фронтэндом к обработчику утверждения.

Этот макрос должен использоваться только в методах Objective C.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSAssert1
NSAssert2
NSAssert3
NSAssert4
NSCAssert
NSCParameterAssert
NSParameterAssert

NSCAssert NSCAssert

Если данное условие является ложью, генерирует утверждение.

Объявление

Objective C

NSCAssert(condition, NSString *description)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C. NSCAssert не берет параметров кроме условия и строки формата.

condition должно быть выражение, оценивающее к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSCAssert1
NSCParameterAssert
NSParameterAssert
NSCAssert1 NSCAssert1

NSCAssert1 одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.

Объявление

Objective C

NSCAssert1(condition, NSString *description, arg1)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert1 макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.

condition выражение должно оценить к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа. arg1 параметр, который будет вставлен, на месте, в описание.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSCAssert
NSCAssert2
NSCAssert3
NSCAssert4
NSCAssert5
NSCParameterAssert
NSParameterAssert
NSCAssert2 NSCAssert2

NSCAssert2 одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.

Объявление

Objective C

NSCAssert2(condition, NSString *description, arg1, arg2)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert2 макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.

condition выражение должно оценить к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа. Каждый argn параметр, который будет вставлен, на месте, в описание.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSCAssert
NSCAssert1
NSCAssert3
NSCAssert4
NSCAssert5
NSCParameterAssert
NSParameterAssert
NSCAssert3 NSCAssert3

NSCAssert3 одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.

Объявление

Objective C

NSCAssert3(condition, NSString *description, arg1, arg2, arg3)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert3 макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.

condition выражение должно оценить к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа. Каждый argn параметр, который будет вставлен, на месте, в описание.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSCAssert
NSCAssert1
NSCAssert2
NSCAssert4
NSCAssert5
NSCParameterAssert
NSParameterAssert
NSCAssert4 NSCAssert4

NSCAssert4 одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.

Объявление

Objective C

NSCAssert4(condition, NSString *description, arg1, arg2, arg3, arg4)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert4 макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.

condition выражение должно оценить к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа. Каждый argn параметр, который будет вставлен, на месте, в описание.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSCAssert
NSCAssert1
NSCAssert2
NSCAssert3
NSCAssert5
NSCParameterAssert
NSParameterAssert
NSCAssert5 NSCAssert5

NSCAssert5 одна из серии макросов, которые генерируют утверждения, если данное условие является ложью.

Объявление

Objective C

NSCAssert5(condition, NSString *description, arg1, arg2, arg3, arg4, arg5)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

NSCAssert5 макрос оценивает условие и служит фронтэндом к обработчику утверждения. Этот макрос должен использоваться только в функциях C.

condition выражение должно оценить к истине или лжи. description строка формата printf-стиля, описывающая состояние отказа. Каждый argn параметр, который будет вставлен, на месте, в описание.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSCAssert
NSCAssert1
NSCAssert2
NSCAssert3
NSCAssert4
NSCParameterAssert
NSParameterAssert
NSCParameterAssert NSCParameterAssert

Оценивает указанный параметр.

Объявление

Objective C

NSCParameterAssert(condition)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

Этот макрос проверяет параметр для функции C. Просто обеспечьте параметр как параметр условия. Макрос оценивает параметр и, если параметр оценивает ко лжи, регистрирует сообщение об ошибке, включающее параметр и затем повышающее исключение.

Утверждения отключены если макрос препроцессора NS_BLOCK_ASSERTIONS определяется. Весь возврат макросов void.

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSCAssert
NSParameterAssert
NSParameterAssert NSParameterAssert

Проверяет указанный параметр.

Объявление

Objective C

NSParameterAssert(condition)

Обсуждение

Утверждения оценивают условие и, если условие оценивает ко лжи, вызовите обработчик утверждения для текущего потока, передав его строка формата и переменное число параметров. Каждый поток имеет свой собственный обработчик утверждения, который является объектом класса NSAssertionHandler. Когда вызвано, обработчик утверждения распечатывает сообщение об ошибке, включающее имена методов и имена классов (или имя функции). Это тогда повышает NSInternalInconsistencyException исключение.

Этот макрос проверяет параметр для метода Objective C. Просто обеспечьте параметр как condition параметр. Макрос оценивает параметр и, если это - ложь, это регистрирует сообщение об ошибке, включающее параметр и затем повышающее исключение.

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

Важный

Не вызывайте функции с побочными эффектами в condition параметр этого макроса. condition параметр не оценен, когда утверждения отключены, поэтому если Вы вызываете функции с побочными эффектами, те функции никогда не могут вызываться, когда Вы разрабатываете проект в ненастройке отладочного процесса.

Примечание:

Не все конфигурации выпуска отключают утверждения по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLog
NSLogv
NSAssert
NSCAssert
NSCParameterAssert

Пакеты

Для получения дополнительной информации о генерации строковых файлов посмотрите Используя Строковые Файлы для Бывшего обращенным к пользователю текста.


    
    NSLocalizedString
    NSLocalizedString

Возвращает локализованную версию строки.

Объявление

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;

Доступность

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


    
    NSLocalizedStringFromTable
    NSLocalizedStringFromTable

Возвращает локализованную версию строки от указанной таблицы.

Объявление

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.

Специальные замечания

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

Objective C

@import Foundation;

Доступность

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


    
    NSLocalizedStringFromTableInBundle
    NSLocalizedStringFromTableInBundle

Возвращает локализованную версию строки.

Объявление

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.

Специальные замечания

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

Objective C

@import Foundation;

Доступность

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


    
    NSLocalizedStringWithDefaultValue
    NSLocalizedStringWithDefaultValue

Возвращает локализованную версию строки.

Объявление

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.

Специальные замечания

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

Objective C

@import Foundation;

Доступность

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

Порядок байтов

NSConvertHostDoubleToSwapped (_:) NSConvertHostDoubleToSwapped

Выполняет преобразование типов.

Объявление

Swift

func NSConvertHostDoubleToSwapped(_ x: Double) -> NSSwappedDouble

Objective C

NSSwappedDouble NSConvertHostDoubleToSwapped ( double x );

Обсуждение

Преобразовывает двойное значение в x к значению, байты которого могут быть подкачаны. Эта функция фактически не подкачивает байты x. Вы не должны должны быть вызывать эту функцию непосредственно.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostDoubleToBig
NSSwapHostDoubleToLittle
NSConvertHostFloatToSwapped (_:) NSConvertHostFloatToSwapped

Выполняет преобразование типов.

Объявление

Swift

func NSConvertHostFloatToSwapped(_ x: Float) -> NSSwappedFloat

Objective C

NSSwappedFloat NSConvertHostFloatToSwapped ( float x );

Обсуждение

Преобразовывает значение плавающее в x к значению, байты которого могут быть подкачаны. Эта функция фактически не подкачивает байты x. Вы не должны должны быть вызывать эту функцию непосредственно.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostFloatToBig
NSSwapHostFloatToLittle
NSConvertSwappedDoubleToHost (_:) NSConvertSwappedDoubleToHost

Выполняет преобразование типов.

Объявление

Swift

func NSConvertSwappedDoubleToHost(_ x: NSSwappedDouble) -> Double

Objective C

double NSConvertSwappedDoubleToHost ( NSSwappedDouble x );

Обсуждение

Преобразовывает значение в x к двойному значению. Эта функция фактически не подкачивает байты x. Вы не должны должны быть вызывать эту функцию непосредственно.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigDoubleToHost
NSSwapLittleDoubleToHost
NSConvertSwappedFloatToHost (_:) NSConvertSwappedFloatToHost

Выполняет преобразование типов.

Объявление

Swift

func NSConvertSwappedFloatToHost(_ x: NSSwappedFloat) -> Float

Objective C

float NSConvertSwappedFloatToHost ( NSSwappedFloat x );

Обсуждение

Преобразовывает значение в x к значению плавающему. Эта функция фактически не подкачивает байты x. Вы не должны должны быть вызывать эту функцию непосредственно.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigFloatToHost
NSSwapLittleFloatToHost
NSHostByteOrder () NSHostByteOrder

Возвращает формат порядка байтов.

Объявление

Swift

func NSHostByteOrder() -> Int

Objective C

long NSHostByteOrder ( void );

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

Формат порядка байтов, также NS_LittleEndian или NS_BigEndian.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigDoubleToHost(_ x: NSSwappedDouble) -> Double

Objective C

double NSSwapBigDoubleToHost ( NSSwappedDouble x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostDoubleToBig
NSSwapLittleDoubleToHost
NSSwapBigFloatToHost (_:) NSSwapBigFloatToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigFloatToHost(_ x: NSSwappedFloat) -> Float

Objective C

float NSSwapBigFloatToHost ( NSSwappedFloat x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostFloatToBig
NSSwapLittleFloatToHost
NSSwapBigIntToHost (_:) NSSwapBigIntToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigIntToHost(_ x: UInt32) -> UInt32

Objective C

unsigned int NSSwapBigIntToHost ( unsigned int x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostIntToBig
NSSwapLittleIntToHost
NSSwapBigLongLongToHost (_:) NSSwapBigLongLongToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigLongLongToHost(_ x: UInt64) -> UInt64

Objective C

unsigned long long NSSwapBigLongLongToHost ( unsigned long long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostLongLongToBig
NSSwapLittleLongLongToHost
NSSwapBigLongToHost (_:) NSSwapBigLongToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigLongToHost(_ x: UInt) -> UInt

Objective C

unsigned long NSSwapBigLongToHost ( unsigned long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostLongToBig
NSSwapLittleLongToHost
NSSwapBigShortToHost (_:) NSSwapBigShortToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapBigShortToHost(_ x: UInt16) -> UInt16

Objective C

unsigned short NSSwapBigShortToHost ( unsigned short x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostShortToBig
NSSwapLittleShortToHost
NSSwapDouble (_:) NSSwapDouble

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapDouble(_ x: NSSwappedDouble) -> NSSwappedDouble

Objective C

NSSwappedDouble NSSwapDouble ( NSSwappedDouble x );

Обсуждение

Подкачивает байты x и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байты x пронумерованы от 1 до 8, эта функция подкачивает байты 1 и 8, байты 2 и 7, байты 3 и 6 и байты 4 и 5.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLongLong
NSSwapFloat
NSSwapFloat (_:) NSSwapFloat

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapFloat(_ x: NSSwappedFloat) -> NSSwappedFloat

Objective C

NSSwappedFloat NSSwapFloat ( NSSwappedFloat x );

Обсуждение

Подкачивает байты x и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байты x пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLong
NSSwapDouble
NSSwapHostDoubleToBig (_:) NSSwapHostDoubleToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostDoubleToBig(_ x: Double) -> NSSwappedDouble

Objective C

NSSwappedDouble NSSwapHostDoubleToBig ( double x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigDoubleToHost
NSSwapHostDoubleToLittle
NSSwapHostDoubleToLittle (_:) NSSwapHostDoubleToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostDoubleToLittle(_ x: Double) -> NSSwappedDouble

Objective C

NSSwappedDouble NSSwapHostDoubleToLittle ( double x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleDoubleToHost
NSSwapHostDoubleToBig
NSSwapHostFloatToBig (_:) NSSwapHostFloatToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostFloatToBig(_ x: Float) -> NSSwappedFloat

Objective C

NSSwappedFloat NSSwapHostFloatToBig ( float x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigFloatToHost
NSSwapHostFloatToLittle
NSSwapHostFloatToLittle (_:) NSSwapHostFloatToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostFloatToLittle(_ x: Float) -> NSSwappedFloat

Objective C

NSSwappedFloat NSSwapHostFloatToLittle ( float x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleFloatToHost
NSSwapHostFloatToBig
NSSwapHostIntToBig (_:) NSSwapHostIntToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostIntToBig(_ x: UInt32) -> UInt32

Objective C

unsigned int NSSwapHostIntToBig ( unsigned int x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigIntToHost
NSSwapHostIntToLittle
NSSwapHostIntToLittle (_:) NSSwapHostIntToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostIntToLittle(_ x: UInt32) -> UInt32

Objective C

unsigned int NSSwapHostIntToLittle ( unsigned int x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleIntToHost
NSSwapHostIntToBig
NSSwapHostLongLongToBig (_:) NSSwapHostLongLongToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostLongLongToBig(_ x: UInt64) -> UInt64

Objective C

unsigned long long NSSwapHostLongLongToBig ( unsigned long long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigLongLongToHost
NSSwapHostLongLongToLittle
NSSwapHostLongLongToLittle (_:) NSSwapHostLongLongToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostLongLongToLittle(_ x: UInt64) -> UInt64

Objective C

unsigned long long NSSwapHostLongLongToLittle ( unsigned long long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleLongLongToHost
NSSwapHostLongLongToBig
NSSwapHostLongToBig (_:) NSSwapHostLongToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostLongToBig(_ x: UInt) -> UInt

Objective C

unsigned long NSSwapHostLongToBig ( unsigned long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigLongToHost
NSSwapHostLongToLittle
NSSwapHostLongToLittle (_:) NSSwapHostLongToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostLongToLittle(_ x: UInt) -> UInt

Objective C

unsigned long NSSwapHostLongToLittle ( unsigned long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleLongToHost
NSSwapHostLongToBig
NSSwapHostShortToBig (_:) NSSwapHostShortToBig

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostShortToBig(_ x: UInt16) -> UInt16

Objective C

unsigned short NSSwapHostShortToBig ( unsigned short x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapBigShortToHost
NSSwapHostShortToLittle
NSSwapHostShortToLittle (_:) NSSwapHostShortToLittle

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapHostShortToLittle(_ x: UInt16) -> UInt16

Objective C

unsigned short NSSwapHostShortToLittle ( unsigned short x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLittleShortToHost
NSSwapHostShortToBig
NSSwapInt (_:) NSSwapInt

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapInt(_ inv: UInt32) -> UInt32

Objective C

unsigned int NSSwapInt ( unsigned int inv );

Обсуждение

Подкачивает байты iv и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байты inv пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapShort
NSSwapLong
NSSwapLongLong
NSSwapLittleDoubleToHost (_:) NSSwapLittleDoubleToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleDoubleToHost(_ x: NSSwappedDouble) -> Double

Objective C

double NSSwapLittleDoubleToHost ( NSSwappedDouble x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostDoubleToLittle
NSSwapBigDoubleToHost
NSConvertSwappedDoubleToHost
NSSwapLittleFloatToHost (_:) NSSwapLittleFloatToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleFloatToHost(_ x: NSSwappedFloat) -> Float

Objective C

float NSSwapLittleFloatToHost ( NSSwappedFloat x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostFloatToLittle
NSSwapBigFloatToHost
NSConvertSwappedFloatToHost
NSSwapLittleIntToHost (_:) NSSwapLittleIntToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleIntToHost(_ x: UInt32) -> UInt32

Objective C

unsigned int NSSwapLittleIntToHost ( unsigned int x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostIntToLittle
NSSwapBigIntToHost
NSSwapLittleLongLongToHost (_:) NSSwapLittleLongLongToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleLongLongToHost(_ x: UInt64) -> UInt64

Objective C

unsigned long long NSSwapLittleLongLongToHost ( unsigned long long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostLongLongToLittle
NSSwapBigLongLongToHost
NSSwapLittleLongToHost (_:) NSSwapLittleLongToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleLongToHost(_ x: UInt) -> UInt

Objective C

unsigned long NSSwapLittleLongToHost ( unsigned long x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostLongToLittle
NSSwapBigLongToHost
NSSwapLong
NSSwapLittleShortToHost (_:) NSSwapLittleShortToHost

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLittleShortToHost(_ x: UInt16) -> UInt16

Objective C

unsigned short NSSwapLittleShortToHost ( unsigned short x );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapHostShortToLittle
NSSwapBigShortToHost
NSSwapLong (_:) NSSwapLong

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLong(_ inv: UInt) -> UInt

Objective C

unsigned long NSSwapLong ( unsigned long inv );

Обсуждение

Подкачивает байты inv и возвращает получающееся значение. Байты подкачиваются от каждой позиции младшего разряда до соответствующей старшей позиции и наоборот. Например, если байты inv пронумерованы от 1 до 4, эта функция подкачивает байты 1 и 4 и байты 2 и 3.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapLongLong
NSSwapInt
NSSwapFloat
NSSwapLongLong (_:) NSSwapLongLong

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapLongLong(_ inv: UInt64) -> UInt64

Objective 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

Доступность

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

См. также

NSSwapLong
NSSwapDouble
NSSwapShort (_:) NSSwapShort

Утилита для свопинга байтов числа.

Объявление

Swift

func NSSwapShort(_ inv: UInt16) -> UInt16

Objective C

unsigned short NSSwapShort ( unsigned short inv );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSwapInt
NSSwapLong

Десятичные числа

Можно также использовать класс NSDecimalNumber для десятичной системы исчисления.

NSDecimalAdd (_: _: _: _:) NSDecimalAdd

Добавляют два десятичных значения.

Объявление

Swift

func NSDecimalAdd(_ result: COpaquePointer, _ leftOperand: COpaquePointer, _ rightOperand: COpaquePointer, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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

Уплотняет десятичную структуру для эффективности.

Объявление

Swift

func NSDecimalCompact(_ number: COpaquePointer)

Objective C

void NSDecimalCompact ( NSDecimal *number );

Обсуждение

Число форматов так, чтобы вычисления с помощью него привели как можно меньше память в рабочее состояние. Весь NSDecimal... арифметические функции ожидают компактные параметры NSDecimal.

Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Сравнивает два десятичных значения.

Объявление

Swift

func NSDecimalCompare(_ leftOperand: COpaquePointer, _ rightOperand: COpaquePointer) -> NSComparisonResult

Objective C

NSComparisonResult NSDecimalCompare ( const NSDecimal *leftOperand, const NSDecimal *rightOperand );

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

NSOrderedDescending если leftOperand больше, чем rightOperand; NSOrderedAscending если rightOperand больше, чем leftOperand; или NSOrderedSame если эти два операнда равны.

Обсуждение

Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Копирует значение десятичного числа.

Объявление

Swift

func NSDecimalCopy(_ destination: COpaquePointer, _ source: COpaquePointer)

Objective C

void NSDecimalCopy ( NSDecimal *destination, const NSDecimal *source );

Обсуждение

Копирует значение в source к destination.

Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Делит одно десятичное значение на другого.

Объявление

Swift

func NSDecimalDivide(_ result: COpaquePointer, _ leftOperand: COpaquePointer, _ rightOperand: COpaquePointer, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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

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

Объявление

Swift

func NSDecimalIsNotANumber(_ dcm: COpaquePointer) -> Bool

Objective C

BOOL NSDecimalIsNotANumber ( const NSDecimal *dcm );

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

YEStrue если значение в decimal представляет верный номер, иначе NOfalse.
Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Умножает два десятичных числа вместе.

Объявление

Swift

func NSDecimalMultiply(_ result: COpaquePointer, _ leftOperand: COpaquePointer, _ rightOperand: COpaquePointer, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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

Умножает десятичное число на указанное питание 10.

Объявление

Swift

func NSDecimalMultiplyByPowerOf10(_ result: COpaquePointer, _ number: COpaquePointer, _ power: Int16, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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


    
    NSDecimalNormalize (_: _: _:)
    NSDecimalNormalize

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

Объявление

Swift

func NSDecimalNormalize(_ number1: COpaquePointer, _ number2: COpaquePointer, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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

NSDecimalPower (_: _: _: _:) NSDecimalPower

Повышает десятичное значение до указанного питания.

Объявление

Swift

func NSDecimalPower(_ result: COpaquePointer, _ number: COpaquePointer, _ power: Int, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective C

NSCalculationError NSDecimalPower ( NSDecimal *result, const NSDecimal *number, NSUInteger power, NSRoundingMode roundingMode );

Обсуждение

Повышения number к power, возможно закругление согласно roundingMode, и хранит получающееся значение в result.

Для объяснений возможных возвращаемых значений и округления режимов, посмотрите NSDecimalAdd.

Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Округляет десятичное значение.

Объявление

Swift

func NSDecimalRound(_ result: COpaquePointer, _ number: COpaquePointer, _ 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

Доступность

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

Возвращает строковое представление десятичного значения.

Объявление

Swift

func NSDecimalString(_ dcm: COpaquePointer, _ locale: AnyObject!) -> String!

Objective C

NSString * NSDecimalString ( const NSDecimal *dcm, id locale );

Обсуждение

Возвращает строковое представление decimal. locale определяет формат десятичного разделителя.

Для получения дополнительной информации посмотрите Темы Программирования Числа и Значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Вычитает одно десятичное значение от другого.

Объявление

Swift

func NSDecimalSubtract(_ result: COpaquePointer, _ leftOperand: COpaquePointer, _ rightOperand: COpaquePointer, _ roundingMode: NSRoundingMode) -> NSCalculationError

Objective 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

Доступность

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

Обработка исключений

Можно счесть следующие макросы реализованными в NSException.h. Они являются устаревшими и не должны использоваться. Посмотрите, что Исключение Программирует Темы для получения информации о том, как обработать исключения.

NS_DURING NS_DURING

Отмечает запуск домена обработки исключений.

Объявление

Objective C

NS_DURING

Обсуждение

NS_DURING макрос отмечает запуск домена обработки исключений для раздела кода. ( NS_HANDLERмакрос отмечает конец домена.) В домене обработки исключений можно повысить исключение, дав локальный обработчик исключений (или понизить обработчики исключений), шанс обработать его.

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

Objective C

@import Foundation;

Доступность

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

Отмечает конец локального обработчика событий.

Объявление

Objective C

NS_ENDHANDLER

Обсуждение

NS_ENDHANDLER отмечает конец раздела кода, который является локальным обработчиком исключений. ( NS_HANDLERмакросы отмечают начало этого раздела.), Если исключение повышено в домене обработки исключений, отделенном NS_DURING и NS_HANDLER, локальному обработчику исключений (если указано) дают шанс обработать исключение.

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

Objective C

@import Foundation;

Доступность

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

Отмечает конец домена обработки исключений и запуск локального обработчика исключений.

Объявление

Objective C

NS_HANDLER

Обсуждение

Макрос NS_HANDLER отмечает конец раздела кода, который является доменом обработки исключений, одновременно отмечая начало раздела кода, который является локальным обработчиком исключений для того домена. ( NS_DURING макрос отмечает начало домена обработки исключений; NS_ENDHANDLER отмечает конец локального обработчика исключений.), Если исключение повышено в домене обработки исключений, локальному обработчику исключений сначала дают шанс обработать исключение, прежде чем обработчикам низшего уровня дадут шанс.

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

Objective C

@import Foundation;

Доступность

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


    
    NS_VALUERETURN
    NS_VALUERETURN

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

Объявление

Objective C

NS_VALUERETURN(val, type)

Параметры

`val`	Значение для сохранения вне домена обработки исключений.
`type`	Тип значения, указанного в `val`.

Обсуждение

NS_VALUERETURN макрос возвращает программное управление вызывающей стороне из домена обработки исключений — т.е. раздел кода между NS_DURING и NS_HANDLER макросы, которые могли бы повысить исключение. Указанное значение (указанного типа) возвращается к вызывающей стороне. Стандарт return оператор не работает как ожидалось в домене обработки исключений.

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

Objective C

@import Foundation;

Доступность

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

NS_VOIDRETURN NS_VOIDRETURN

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

Объявление

Objective C

NS_VOIDRETURN

Обсуждение

NS_VOIDRETURN макрос возвращает программное управление вызывающей стороне из домена обработки исключений — т.е. раздел кода между NS_DURING и NS_HANDLER макросы, которые могли бы повысить исключение. Стандарт return оператор не работает как ожидалось в домене обработки исключений.

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

Objective C

@import Foundation;

Доступность

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

Установка Java

NSJavaBundleCleanup NSJavaBundleCleanup Доступный в OS X v10.2 через OS X v10.5

Эта функция была осуждена.

Объявление

Objective C

void NSJavaBundleCleanup ( NSBundle *bundle, NSDictionary *plist );

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaBundleSetup NSJavaBundleSetup Доступный в OS X v10.2 через OS X v10.5

Эта функция была осуждена.

Объявление

Objective C

id NSJavaBundleSetup ( NSBundle *bundle, NSDictionary *plist );

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaClassesForBundle NSJavaClassesForBundle Доступный в OS X v10.2 через OS X v10.5

Загружает классы Java, расположенные в указанном пакете.

Объявление

Objective C

NSArray * NSJavaClassesForBundle ( NSBundle *bundle, BOOL usesyscl, id *vm );

Обсуждение

Загрузки и возвраты классы Java в указанном пакете. Если виртуальная машина Java не загружается, загрузите ее сначала. Ссылка на виртуальную машину Java возвращается в vm параметр. Можно передать nil для vm параметр, если Вы не хотите эту информацию. Передача NOfalse для usesyscl если Вы хотите использовать новый экземпляр загрузчика класса для загрузки классов; иначе, система может снова использовать существующий экземпляр загрузчика класса. Если Вы передаете NOfalse для usesyscl, новый загрузчик класса будет выпущен, когда Вы будете сделаны с ним; иначе, загрузчик класса будет кэшироваться для использования в следующий раз.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaClassesFromPath NSJavaClassesFromPath Доступный в OS X v10.2 через OS X v10.5

Загружает классы Java, расположенные в указанном пути.

Объявление

Objective C

NSArray * NSJavaClassesFromPath ( NSArray *path, NSArray *wanted, BOOL usesyscl, id *vm );

Обсуждение

Загрузки и возвраты классы Java в указанном пакете. Если виртуальная машина Java не загружается, загрузите ее сначала. Ссылка на виртуальную машину Java возвращается в vm параметр. Можно передать nil для vm параметр, если Вы не хотите эту информацию. Передайте массив имен классов для загрузки в wanted параметр. Если Вы передаете nil для wanted параметр, все классы в указанном пути будут загружены. Передача NOfalse для usesyscl если Вы хотите использовать новый экземпляр загрузчика класса для загрузки классов; иначе, система может снова использовать существующий экземпляр загрузчика класса. Если Вы передаете NOfalse для usesyscl, новый загрузчик класса будет выпущен, когда Вы будете сделаны с ним; иначе, загрузчик класса будет кэшироваться для использования в следующий раз.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaNeedsToLoadClasses NSJavaNeedsToLoadClasses Доступный в OS X v10.0 через OS X v10.5

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

Объявление

Objective C

BOOL NSJavaNeedsToLoadClasses ( NSDictionary *plist );

Обсуждение

Возвраты YEStrue если виртуальная машина необходима или если виртуальная машина уже существует и существует индикация, что предоставлены классы Java.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaNeedsVirtualMachine NSJavaNeedsVirtualMachine Доступный в OS X v10.0 через OS X v10.5

Возвращает булево значение, указывающее, требуется ли виртуальная машина Java.

Объявление

Objective C

BOOL NSJavaNeedsVirtualMachine ( NSDictionary *plist );

Обсуждение

Возвраты YEStrue если plist содержит ключ, говоря, что он требует Java.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaObjectNamedInPath NSJavaObjectNamedInPath Доступный в OS X v10.2 через OS X v10.5

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

Объявление

Objective C

id NSJavaObjectNamedInPath ( NSString *name, NSArray *path );

Обсуждение

Возвращает новый экземпляр класса name. Загрузчик класса должен быть уже быть установленным для указанного path (можно сделать это использование функции такой как NSJavaClassesFromPath).

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaProvidesClasses NSJavaProvidesClasses Доступный в OS X v10.0 через OS X v10.5

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

Объявление

Objective C

BOOL NSJavaProvidesClasses ( NSDictionary *plist );

Обсуждение

Возвраты YEStrue если plist содержит NSJavaPath ключ.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaSetup NSJavaSetup Доступный в OS X v10.2 через OS X v10.5
Загружает виртуальную машину Java указанными параметрами.

Объявление

Objective C

id NSJavaSetup ( NSDictionary *plist );
Обсуждение

Часть Java к цели C мост. Вы обычно не должны использовать его сами.

Можно передать nil для plist словарь, когда виртуальная машина Java не будет загружена, таким образом, необходимо будет, вероятно, просто использовать NSJavaSetupVirtualMachine вместо этого. plist словарь может содержать следующие пары ключ/значение.
- NSJavaRoot— Указание NSString корня расположения, где классы приложения.
- NSJavaPath— NSArray Нсстрингса, каждая строка, содержащая один компонент пути к классу, компоненты которого будут предварительно ожидаться NSJavaRoot если они не абсолютные расположения.
- NSJavaUserPath— Указание NSString другого сегмента пути к классу так, чтобы разработчик приложений мог настроить, где загрузчик класса должен искать классы. При поиске классов этот путь ищется после пути к классу приложения так, чтобы нельзя было заменить классы, используемые приложением.
- NSJavaLibraryPath— NSArray Нсстрингса, каждая строка, содержащая один компонент пути для поиска динамические совместно используемые библиотеки, необходимые оберткам Java.
- NSJavaClasses— NSArray Нсстрингса, каждая строка, содержащая имя одного класса, который должен загрузить VM так, чтобы были загружены их связанные платформы.
Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.
NSJavaSetupVirtualMachine NSJavaSetupVirtualMachine Доступный в OS X v10.2 через OS X v10.5

Устанавливает виртуальную машину Java.

Объявление

Objective C

id NSJavaSetupVirtualMachine ( void );

Обсуждение

Устанавливает и возвращает ссылку на виртуальную машину Java.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 через OS X v10.5.
Осуждаемый в OS X v10.5.

Хэш-таблицы

NSAllHashTableObjects (_:) NSAllHashTableObjects

Возвраты все элементы в указанной хэш-таблице.

Объявление

Swift

func NSAllHashTableObjects(_ table: NSHashTable!) -> [AnyObject]!

Objective C

NSArray * NSAllHashTableObjects ( NSHashTable *table );

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

Объект массива, содержащий все элементы table.

Обсуждение

Эта функция должна быть вызвана только, когда табличные элементы являются объектами, не, когда они - любой другой тип данных.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateHashTable
NSFreeHashTable
NSCompareHashTables (_: _:) NSCompareHashTables

Возвращает булево значение, указывающее, равны ли элементы двух хэш-таблиц.

Объявление

Swift

func NSCompareHashTables(_ table1: NSHashTable!, _ table2: NSHashTable!) -> Bool

Objective C

BOOL NSCompareHashTables ( NSHashTable *table1, NSHashTable *table2 );

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

YEStrue если эти две хэш-таблицы равны — т.е. если каждый элемент table1 находится в table2 и эти две таблицы являются тем же размером, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateHashTable
NSCreateHashTableWithZone
NSCopyHashTableWithZone (_: _:) NSCopyHashTableWithZone

Выполняет мелкую копию указанной хэш-таблицы.

Объявление

Swift

func NSCopyHashTableWithZone(_ table: NSHashTable!, _ zone: NSZone) -> NSHashTable!

Objective C

NSHashTable * NSCopyHashTableWithZone ( NSHashTable *table, NSZone *zone );

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

Указатель на новую копию table, создаваемый в zone и содержание указателей на элементы данных table.

Обсуждение

Если zone NULL, новая таблица составлена в зоне по умолчанию.

Новая таблица принимает функции обратного вызова table и вызовы hash и retain функции обратного вызова как надлежащие при вставке элементов в новую таблицу.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateHashTable
NSCreateHashTableWithZone
NSHashTableCallBacks (структура)
NSCountHashTable (_:) NSCountHashTable

Возвращает число элементов в хэш-таблице.

Объявление

Swift

func NSCountHashTable(_ table: NSHashTable!) -> Int

Objective C

NSUInteger NSCountHashTable ( NSHashTable *table );

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

Число элементов в настоящее время в table.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Создает и возвращает новую хэш-таблицу.

Объявление

Swift

func NSCreateHashTable(_ callBacks: NSHashTableCallBacks, _ capacity: Int) -> NSHashTable!

Objective C

NSHashTable * NSCreateHashTable ( NSHashTableCallBacks callBacks, NSUInteger capacity );

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

Указатель на NSHashTable создается в зоне по умолчанию.

Обсуждение

Размер таблицы зависит от (но обычно не равен), capacity. Если capacity 0, маленькая хэш-таблица создается. NSHashTableCallBacks структура callBacks имеет пять указателей на функции, со следующими значениями по умолчанию: хеширование указателя, если hash NULL; равенство указателя, если isEqual NULL; никакой обратный вызов после добавления элемента, если retain NULL; никакой обратный вызов после удаления элемента, если release NULL; и функция, возвращая шестнадцатеричное значение указателя как строку, если describe NULL. Хеш-функция должна быть определена таким образом, что, если два элемента данных равны, как определено функцией сравнения, значения, произведенные путем хеширования на этих элементах, должны также быть равными. Кроме того, элементы данных должны остаться инвариантными, если значение хеш-функции зависит от них; например, если хеш-функция воздействует непосредственно на символы строки, та строка не может измениться.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCopyHashTableWithZone
NSCreateHashTableWithZone
NSCreateHashTableWithZone (_: _: _:) NSCreateHashTableWithZone

Создает новую хэш-таблицу в данной зоне.

Объявление

Swift

func NSCreateHashTableWithZone(_ callBacks: NSHashTableCallBacks, _ capacity: Int, _ zone: NSZone) -> NSHashTable!

Objective C

NSHashTable * NSCreateHashTableWithZone ( NSHashTableCallBacks callBacks, NSUInteger capacity, NSZone *zone );

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

Указатель на новую хэш-таблицу создается в указанной зоне. Если zone NULL, хэш-таблица создается в зоне по умолчанию.

Обсуждение

Размер таблицы зависит от (но обычно не равен), capacity. Если capacity 0, маленькая хэш-таблица создается. NSHashTableCallBacks структура callBacks имеет пять указателей на функции, со следующими значениями по умолчанию: хеширование указателя, если hash NULL; равенство указателя, если isEqual NULL; никакой обратный вызов после добавления элемента, если retain NULL; никакой обратный вызов после удаления элемента, если release NULL; и функция, возвращая шестнадцатеричное значение указателя как строку, если describe NULL. Хеш-функция должна быть определена таким образом, что, если два элемента данных равны, как определено функцией сравнения, значения, произведенные путем хеширования на этих элементах, должны также быть равными. Кроме того, элементы данных должны остаться инвариантными, если значение хеш-функции зависит от них; например, если хеш-функция воздействует непосредственно на символы строки, та строка не может измениться.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateHashTable
NSEndHashTableEnumeration (_:) NSEndHashTableEnumeration

Используемый по окончании с перечислителем.

Объявление

Swift

func NSEndHashTableEnumeration(_ enumerator: UnsafeMutablePointer<NSHashEnumerator>)

Objective C

void NSEndHashTableEnumeration ( NSHashEnumerator *enumerator );

Обсуждение

Когда Вы закончили использовать структуру перечисления, эта функция должна быть вызвана enumerator.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Создает перечислитель для указанной хэш-таблицы.

Объявление

Swift

func NSEnumerateHashTable(_ table: NSHashTable!) -> NSHashEnumerator

Objective C

NSHashEnumerator NSEnumerateHashTable ( NSHashTable *table );

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

Структура NSHashEnumerator, которая вызовет последовательные элементы table чтобы быть возвращенным каждый раз, этот перечислитель передается NSNextHashEnumeratorItem.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSNextHashEnumeratorItem
NSFreeHashTable (_:) NSFreeHashTable

Удаляет указанную хэш-таблицу.

Объявление

Swift

func NSFreeHashTable(_ table: NSHashTable!)

Objective C

void NSFreeHashTable ( NSHashTable *table );

Обсуждение

Выпуски каждый элемент указанной хэш-таблицы и освобождают саму таблицу.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSResetHashTable
NSHashGet (_: _:) NSHashGet

Возвращает элемент хэш-таблицы.

Объявление

Swift

func NSHashGet(_ table: NSHashTable!, _ pointer: UnsafePointer<Void>) -> UnsafeMutablePointer<Void>

Objective C

void * NSHashGet ( NSHashTable *table, const void *pointer );

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

Указатель в соответствующей таблице pointer (как определено isEqual функция обратного вызова). Если нет никакого элемента соответствия, возвратов NULL.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Добавляет элемент к указанной хэш-таблице.

Объявление

Swift

func NSHashInsert(_ table: NSHashTable!, _ pointer: UnsafePointer<Void>)

Objective C

void NSHashInsert ( NSHashTable *table, const void *pointer );

Обсуждение

Вставляет pointer, который не должен быть NULL, в table. Если pointer уже соответствует элемент в таблице, предыдущий указатель выпущен с помощью release функция обратного вызова, указанная, когда была составлена таблица.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSHashRemove
NSHashInsertKnownAbsent
NSHashInsertIfAbsent
NSHashInsertIfAbsent (_: _:) NSHashInsertIfAbsent

Добавляет элемент к указанной хэш-таблице, только если таблица уже не содержит элемент.

Объявление

Swift

func NSHashInsertIfAbsent(_ table: NSHashTable!, _ pointer: UnsafePointer<Void>) -> UnsafeMutablePointer<Void>

Objective C

void * NSHashInsertIfAbsent ( NSHashTable *table, const void *pointer );

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

Если pointer уже соответствует элемент в table, возвращает существующий ранее указатель; иначе, pointer добавляется к table и возвраты NULL.

Обсуждение

Вы не должны указывать NULL для pointer.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSHashRemove
NSHashInsert
NSHashInsertKnownAbsent
NSHashInsertKnownAbsent (_: _:) NSHashInsertKnownAbsent

Добавляет элемент к указанной хэш-таблице.

Объявление

Swift

func NSHashInsertKnownAbsent(_ table: NSHashTable!, _ pointer: UnsafePointer<Void>)

Objective C

void NSHashInsertKnownAbsent ( NSHashTable *table, const void *pointer );

Обсуждение

Вставляет pointer, который не должен быть NULL, в table. В отличие от этого NSHashInsert, эта функция повышения NSInvalidArgumentException если table уже включает соответствующий элемент pointer.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSHashRemove
NSHashInsert
NSHashInsertIfAbsent
NSHashRemove (_: _:) NSHashRemove

Удаляет элемент из указанной хэш-таблицы.

Объявление

Swift

func NSHashRemove(_ table: NSHashTable!, _ pointer: UnsafePointer<Void>)

Objective C

void NSHashRemove ( NSHashTable *table, const void *pointer );

Обсуждение

Если pointer уже соответствует элемент в table, эта функция выпускает существующий ранее элемент.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSHashInsert
NSHashInsertKnownAbsent
NSHashInsertIfAbsent
NSNextHashEnumeratorItem (_:) NSNextHashEnumeratorItem

Возвращает следующий элемент хеш-таблицы в перечислении.

Объявление

Swift

func NSNextHashEnumeratorItem(_ enumerator: UnsafeMutablePointer<NSHashEnumerator>) -> UnsafeMutablePointer<Void>

Objective C

void * NSNextHashEnumeratorItem ( NSHashEnumerator *enumerator );

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

Следующий элемент в таблице это enumerator связан с, или NULL если enumerator уже выполнил итерации по всем элементам.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSEnumerateHashTable
NSResetHashTable (_:) NSResetHashTable

Удаляет элементы указанной хэш-таблицы.

Объявление

Swift

func NSResetHashTable(_ table: NSHashTable!)

Objective C

void NSResetHashTable ( NSHashTable *table );

Обсуждение

Выпуски каждый элемент, но не освобождают table. Эта функция полезна для сохранения способности table.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSFreeHashTable
NSStringFromHashTable (_:) NSStringFromHashTable

Возвращает строку, описывающую содержание хэш-таблицы.

Объявление

Swift

func NSStringFromHashTable(_ table: NSHashTable!) -> String!

Objective C

NSString * NSStringFromHashTable ( NSHashTable *table );

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

Строковое описание tableсодержание.

Обсуждение

Функция выполняет итерации по элементам table, и поскольку каждый добавляет строку, возвращенную describe функция обратного вызова. Если NULL был указан для функции обратного вызова, шестнадцатеричное значение каждого указателя добавляется к строке.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Типы файлов HFS

NSFileTypeForHFSTypeCode (_:) NSFileTypeForHFSTypeCode

Возвращает строку, кодирующую код типа файла.

Объявление

Swift

func NSFileTypeForHFSTypeCode(_ hfsFileTypeCode: OSType) -> String!

Objective C

NSString * NSFileTypeForHFSTypeCode ( OSType hfsFileTypeCode );

Параметры

hfsFileTypeCode

Код типа файла HFS.

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

Кодирующая строка hfsFileTypeCode.

Обсуждение

Для получения дополнительной информации см. Типы файлов HFS.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает код типа файла.

Объявление

Swift

func NSHFSTypeCodeFromFileType(_ fileTypeString: String!) -> OSType

Objective C

OSType NSHFSTypeCodeFromFileType ( NSString *fileTypeString );

Параметры

fileTypeString

Строка вида, закодированного NSFileTypeForHFSTypeCode().

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

Соответствие кода типа файла HFS fileTypeString, или 0 если это не может быть найдено.

Обсуждение

Для получения дополнительной информации см. Типы файлов HFS.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает строку, кодирующую тип файла.

Объявление

Swift

func NSHFSTypeOfFile(_ fullFilePath: String!) -> String!

Objective C

NSString * NSHFSTypeOfFile ( NSString *fullFilePath );

Параметры

fullFilePath

Полный абсолютный путь файла.

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

Кодирующая строка fullFilePathтип файла HFS, или nil если работа не была успешна

Обсуждение

Для получения дополнительной информации см. Типы файлов HFS.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление таблицами карты

NSAllMapTableKeys (_:) NSAllMapTableKeys

Возвраты все ключи в указанной таблице карты.

Объявление

Swift

func NSAllMapTableKeys(_ table: NSMapTable!) -> [AnyObject]!

Objective C

NSArray * NSAllMapTableKeys ( NSMapTable *table );

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

Объект массива, содержащий все ключи table. Эта функция должна быть вызвана только когда table ключи являются объектами, не, когда они - любой другой тип указателя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapMember
NSMapGet
NSEnumerateMapTable
NSNextMapEnumeratorPair
NSAllMapTableValues
NSAllMapTableValues (_:) NSAllMapTableValues

Возвраты все значения в указанной таблице.

Объявление

Swift

func NSAllMapTableValues(_ table: NSMapTable!) -> [AnyObject]!

Objective C

NSArray * NSAllMapTableValues ( NSMapTable *table );

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

Объект массива, содержащий все значения в table. Эта функция должна быть вызвана только когда table значения являются объектами, не, когда они - любой другой тип указателя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapMember
NSMapGet
NSEnumerateMapTable
NSNextMapEnumeratorPair
NSAllMapTableKeys
NSCompareMapTables (_: _:) NSCompareMapTables

Сравнивает элементы двух таблиц карты для равенства.

Объявление

Swift

func NSCompareMapTables(_ table1: NSMapTable!, _ table2: NSMapTable!) -> Bool

Objective C

BOOL NSCompareMapTables ( NSMapTable *table1, NSMapTable *table2 );

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

YEStrue если ключи и соответствующие значения table1 и table2 то же, и эти две таблицы являются тем же размером, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateMapTable
NSCreateMapTableWithZone
NSCopyMapTableWithZone (_: _:) NSCopyMapTableWithZone

Выполняет мелкую копию указанной таблицы карты.

Объявление

Swift

func NSCopyMapTableWithZone(_ table: NSMapTable!, _ zone: NSZone) -> NSMapTable!

Objective C

NSMapTable * NSCopyMapTableWithZone ( NSMapTable *table, NSZone *zone );

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

Указатель на новую копию table, создаваемый в zone и содержание указателей на ключи и значения table.

Обсуждение

Если zone NULL, новая таблица составлена в зоне по умолчанию.

Новая таблица принимает функции обратного вызова table и вызовы hash и retain функции обратного вызова как надлежащие при вставке элементов в новую таблицу.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCreateMapTable
NSCreateMapTableWithZone
NSMapTableKeyCallBacks (структура)
NSMapTableValueCallBacks (структура)
NSCountMapTable (_:) NSCountMapTable

Возвращает число элементов в таблице карты.

Объявление

Swift

func NSCountMapTable(_ table: NSMapTable!) -> Int

Objective C

NSUInteger NSCountMapTable ( NSMapTable *table );

Параметры

table

Ссылка на структуру таблицы карты.

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

Число пар ключ/значение в настоящее время в table.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Составляет новую таблицу карты в зоне по умолчанию.

Объявление

Swift

func NSCreateMapTable(_ keyCallBacks: NSMapTableKeyCallBacks, _ valueCallBacks: NSMapTableValueCallBacks, _ capacity: Int) -> NSMapTable!

Objective C

NSMapTable * NSCreateMapTable ( NSMapTableKeyCallBacks keyCallBacks, NSMapTableValueCallBacks valueCallBacks, NSUInteger capacity );

Обсуждение

Создает и возвращает указатель на NSMapTable структура в зоне по умолчанию; размер таблицы зависит от (но обычно не равен), capacity. Если capacity 0, маленькая таблица карты составлена. NSMapTableKeyCallBacks параметрами являются структуры, которые очень подобны структуре обратного вызова, используемой NSCreateHashTable— у них есть те же значения по умолчанию, как задокументировано для той функции.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCopyMapTableWithZone
NSCreateMapTableWithZone
NSCreateMapTableWithZone (_: _: _: _:) NSCreateMapTableWithZone

Составляет новую таблицу карты в указанной зоне.

Объявление

Swift

func NSCreateMapTableWithZone(_ keyCallBacks: NSMapTableKeyCallBacks, _ valueCallBacks: NSMapTableValueCallBacks, _ capacity: Int, _ zone: NSZone) -> NSMapTable!

Objective C

NSMapTable * NSCreateMapTableWithZone ( NSMapTableKeyCallBacks keyCallBacks, NSMapTableValueCallBacks valueCallBacks, NSUInteger capacity, NSZone *zone );

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

Новая таблица карты в выделенном в zone. Если zone NULL, хэш-таблица создается в зоне по умолчанию.

Обсуждение

Размер таблицы зависит от (но обычно не равен), capacity. Если capacity 0, маленькая таблица карты составлена. NSMapTableKeyCallBacks параметрами являются структуры, которые очень подобны структуре обратного вызова, используемой NSCreateHashTable; фактически, у них есть те же значения по умолчанию, как задокументировано для той функции.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCopyMapTableWithZone
NSCreateMapTable
NSEndMapTableEnumeration (_:) NSEndMapTableEnumeration

Используемый по окончании с перечислителем.

Объявление

Swift

func NSEndMapTableEnumeration(_ enumerator: UnsafeMutablePointer<NSMapEnumerator>)

Objective C

void NSEndMapTableEnumeration ( NSMapEnumerator *enumerator );

Обсуждение

Когда Вы закончили использовать структуру перечисления, эта функция должна быть вызвана enumerator.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Создает перечислитель для указанной таблицы карты.

Объявление

Swift

func NSEnumerateMapTable(_ table: NSMapTable!) -> NSMapEnumerator

Objective C

NSMapEnumerator NSEnumerateMapTable ( NSMapTable *table );

Параметры

table

Ссылка на структуру таблицы карты.

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

NSMapEnumerator структура, которая вызовет последовательные пары ключ/значение table чтобы быть посещенным каждый раз, этот перечислитель передается NSNextMapEnumeratorPair.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSNextMapEnumeratorPair
NSMapMember
NSMapGet
NSAllMapTableKeys
NSAllMapTableValues
NSFreeMapTable (_:) NSFreeMapTable

Удаляет указанную таблицу карты.

Объявление

Swift

func NSFreeMapTable(_ table: NSMapTable!)

Objective C

void NSFreeMapTable ( NSMapTable *table );

Параметры

table

Ссылка на структуру таблицы карты.

Обсуждение

Отпускает каждую клавишу и значение указанной таблицы карты и освобождает саму таблицу.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSResetMapTable
NSMapGet (_: _:) NSMapGet

Возвращает табличное значение карты для указанного ключа.

Объявление

Swift

func NSMapGet(_ table: NSMapTable!, _ key: UnsafePointer<Void>) -> UnsafeMutablePointer<Void>

Objective C

void * NSMapGet ( NSMapTable *table, const void *key );

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

Значение это table карты к key, или NULL если table не содержит key.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapMember
NSEnumerateMapTable
NSNextMapEnumeratorPair
NSAllMapTableKeys
NSAllMapTableValues
NSMapInsert (_: _: _:) NSMapInsert

Вставляет пару ключ/значение в указанную таблицу.

Объявление

Swift

func NSMapInsert(_ table: NSMapTable!, _ key: UnsafePointer<Void>, _ value: UnsafePointer<Void>)

Objective C

void NSMapInsert ( NSMapTable *table, const void *key, const void *value );

Обсуждение

Вставляет key и value в table. Если key уже соответствует ключ в table, value сохраняется и предыдущее значение выпущено, с помощью retain и release функции обратного вызова, указанные, когда была составлена таблица. Повышения NSInvalidArgumentException если key равно notAKeyMarker поле таблицы NSMapTableKeyCallBacks структура.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapRemove
NSMapInsertIfAbsent
NSMapInsertKnownAbsent
NSMapInsertIfAbsent (_: _: _:) NSMapInsertIfAbsent

Вставляет пару ключ/значение в указанную таблицу.

Объявление

Swift

func NSMapInsertIfAbsent(_ table: NSMapTable!, _ key: UnsafePointer<Void>, _ value: UnsafePointer<Void>) -> UnsafeMutablePointer<Void>

Objective C

void * NSMapInsertIfAbsent ( NSMapTable *table, const void *key, const void *value );

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

Если key уже соответствует ключ в table, существующее ранее значение; иначе, key и value добавляются к table и возвраты NULL.

Обсуждение

Повышения NSInvalidArgumentException если key равно notAKeyMarker поле таблицы NSMapTableKeyCallBacks структура.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapRemove
NSMapInsert
NSMapInsertKnownAbsent
NSMapInsertKnownAbsent (_: _: _:) NSMapInsertKnownAbsent

Если пара не была ранее добавлена, вставляет пару ключ/значение в указанную таблицу.

Объявление

Swift

func NSMapInsertKnownAbsent(_ table: NSMapTable!, _ key: UnsafePointer<Void>, _ value: UnsafePointer<Void>)

Objective C

void NSMapInsertKnownAbsent ( NSMapTable *table, const void *key, const void *value );

Обсуждение

Вставляет key (который не должен быть notAKeyMarker) и value в table. В отличие от этого NSMapInsert, эта функция повышения NSInvalidArgumentException если table уже включает соответствующий ключ key.

key по сравнению с notAKeyMarker использование сравнения указателя; если key идентично notAKeyMarker, повышения NSInvalidArgumentException.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapRemove
NSMapInsert
NSMapInsertIfAbsent
NSMapMember (_: _: _: _:) NSMapMember

Указывает, содержит ли данная таблица данный ключ.

Объявление

Swift

func NSMapMember(_ table: NSMapTable!, _ key: UnsafePointer<Void>, _ originalKey: UnsafeMutablePointer<UnsafeMutablePointer<Void>>, _ value: UnsafeMutablePointer<UnsafeMutablePointer<Void>>) -> Bool

Objective C

BOOL NSMapMember ( NSMapTable *table, const void *key, void **originalKey, void **value );

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

YEStrue если table содержит ключ, равный key, иначе NOfalse.

Обсуждение

Если table содержит ключ, равный key, originalKey установлен в key, и value установлен в значение это table карты к key.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapGet
NSEnumerateMapTable
NSNextMapEnumeratorPair
NSAllMapTableKeys
NSAllMapTableValues
NSMapRemove (_: _:) NSMapRemove

Удаляет ключевое и соответствующее значение из указанной таблицы.

Объявление

Swift

func NSMapRemove(_ table: NSMapTable!, _ key: UnsafePointer<Void>)

Objective C

void NSMapRemove ( NSMapTable *table, const void *key );

Обсуждение

Если key уже соответствует ключ в table, эта функция отпускает существующую ранее клавишу и ее соответствующее значение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMapInsert
NSMapInsertIfAbsent
NSMapInsertKnownAbsent
NSNextMapEnumeratorPair (_: _: _:) NSNextMapEnumeratorPair

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

Объявление

Swift

func NSNextMapEnumeratorPair(_ enumerator: UnsafeMutablePointer<NSMapEnumerator>, _ key: UnsafeMutablePointer<UnsafeMutablePointer<Void>>, _ value: UnsafeMutablePointer<UnsafeMutablePointer<Void>>) -> Bool

Objective C

BOOL NSNextMapEnumeratorPair ( NSMapEnumerator *enumerator, void **key, void **value );

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

NOfalse если enumerator уже выполнил итерации по всем элементам в таблице этого enumerator связан с; иначе, наборы key и value соответствовать следующую пару ключ/значение в таблице и возвратах YEStrue.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSEnumerateMapTable
NSMapMember
NSMapGet
NSAllMapTableKeys
NSAllMapTableValues
NSResetMapTable (_:) NSResetMapTable

Удаляет элементы указанной таблицы карты.

Объявление

Swift

func NSResetMapTable(_ table: NSMapTable!)

Objective C

void NSResetMapTable ( NSMapTable *table );

Параметры

table

Ссылка на структуру таблицы карты.

Обсуждение

Отпускает каждую клавишу и значение, но не освобождает table. Этот метод полезен для сохранения способности table.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSFreeMapTable
NSStringFromMapTable (_:) NSStringFromMapTable

Возвращает строку, описывающую содержание таблицы карты.

Объявление

Swift

func NSStringFromMapTable(_ table: NSMapTable!) -> String!

Objective C

NSString * NSStringFromMapTable ( NSMapTable *table );

Параметры

table

Ссылка на структуру таблицы карты.

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

Строка, описывающая содержание таблицы карты.

Обсуждение

Функция выполняет итерации по парам ключ/значение table и поскольку каждый добавляет строку “= b; \n”, где a и b являются ключом и оценивают строки, возвращенные соответствием describe функции обратного вызова. Если NULL был указан для функции обратного вызова, a, и b являются ключом и оценивают указатели, выраженные как шестнадцатеричные числа.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление объектным выделением и освобождением


    
    NSAllocateObject
    NSAllocateObject

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

Объявление

Objective C

id NSAllocateObject ( Class aClass, NSUInteger extraBytes, NSZone *zone );

Параметры

`aClass`	Класс которого можно создать экземпляр.
`extraBytes`	Число дополнительных байтов, требуемых для индексируемых переменных экземпляра (это значение обычно `0`).
`zone`	Зона, в которой можно создать новый экземпляр (передача `NULL` указать зону по умолчанию).

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

Новый экземпляр aClass или nil если не мог бы быть создан экземпляр.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSDeallocateObject


    
    NSCopyObject
    NSCopyObject

(OS X v10.8)

Создает точную копию объекта.

Объявление

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;

Доступность

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

Осуждаемый в OS X v10.8.

См. также

NSAllocateObject
NSDeallocateObject

NSDeallocateObject NSDeallocateObject

Уничтожает существующий объект.

Объявление

Objective C

void NSDeallocateObject ( id object );

Параметры

object

Объект.

Обсуждение

Эта функция освобождает object, который, должно быть, был выделен с помощью NSAllocateObject.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSAllocateObject
NSDecrementExtraRefCountWasZero NSDecrementExtraRefCountWasZero

Постепенно уменьшает подсчет ссылок указанного объекта.

Объявление

Objective C

BOOL NSDecrementExtraRefCountWasZero ( id object );

Параметры

object

Объект.

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

NOfalse если anObject имел дополнительный подсчет ссылок, или YEStrue если anObject не имел дополнительного подсчета ссылок — указание, что объект должен быть освобожден (с dealloc).

Обсуждение

Постепенно уменьшает “дополнительное ссылочное” количество anObject. Недавно созданные объекты имеют только одну фактическую ссылку, так, чтобы единственное сообщение выпуска привело к освобождаемому объекту. Дополнительные ссылки - те вне единственной исходной ссылки и обычно создаются путем отправки объекту сохранить сообщения. Ваш код не должен обычно использовать эти функции, если он не переопределяет retain или release методы.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSExtraRefCount
NSIncrementExtraRefCount
NSExtraRefCount NSExtraRefCount

Возвращает подсчет ссылок указанного объекта.

Объявление

Objective C

NSUInteger NSExtraRefCount ( id object );

Параметры

object

Объект.

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

Текущий подсчет ссылок object.

Обсуждение

Эта функция используется в сочетании с NSIncrementExtraRefCount и NSDecrementExtraRefCountWasZero в ситуациях, где необходимо переопределить объект retain и release методы.

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

Objective C

@import Foundation;

Доступность

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

Постепенно увеличивает подсчет ссылок указанного объекта.

Объявление

Objective C

void NSIncrementExtraRefCount ( id object );

Параметры

object

Объект.

Обсуждение

Эта функция постепенно увеличивает “дополнительное ссылочное” количество object. Недавно созданные объекты имеют только одну фактическую ссылку, так, чтобы единственное сообщение выпуска привело к освобождаемому объекту. Дополнительные ссылки - те вне единственной исходной ссылки и обычно создаются путем отправки объекту сохранить сообщения. Ваш код не должен обычно использовать эти функции, если он не переопределяет методы сохранения или выпуска.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSExtraRefCount
NSDecrementExtraRefCountWasZero
NSShouldRetainWithZone NSShouldRetainWithZone

Указывает, должен ли быть сохранен объект.

Объявление

Objective C

BOOL NSShouldRetainWithZone ( id anObject, NSZone *requestedZone );

Параметры

anObject

Объект.

requestedZone

Зона памяти.

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

Возвраты YEStrue если requestedZone NULL, зона та по умолчанию или зона, в который anObject был выделен; иначе NOfalse.

Обсуждение

Эта функция обычно вызывается изнутри NSObject copyWithZone:, при решении, сохранить ли anObject в противоположность созданию копии его.

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

Objective C

@import Foundation;

Доступность

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

Взаимодействие со временем выполнения Objective C

NSGetSizeAndAlignment (_: _: _:) NSGetSizeAndAlignment

Получает фактический размер и выровненный размер закодированного типа.

Объявление

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 выровненный размер типа данных; например, на некоторых платформах, выровненном размере a char в то время как фактический физический размер составляет 1 байт, могли бы быть 2 байта.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Получает класс по имени.

Объявление

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

Доступность

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

См. также

NSStringFromClass
NSProtocolFromString
NSSelectorFromString
NSStringFromClass (_:) NSStringFromClass

Возвращает имя класса как строка.

Объявление

Swift

func NSStringFromClass(_ aClass: AnyClass!) -> String!

Objective C

NSString * NSStringFromClass ( Class aClass );

Параметры

aClass

Класс.

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

Строка, содержащая имя aClass. Если aClass nil, возвраты nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSClassFromString
NSStringFromProtocol
NSStringFromSelector


    
    NSSelectorFromString (_:)
    NSSelectorFromString

Возвращает селектор с именем.

Объявление

Swift

func NSSelectorFromString(_ aSelectorName: String!) -> Selector

Objective C

SEL NSSelectorFromString ( NSString *aSelectorName );

Параметры


      aSelectorName

Строка любой длины, с любыми символами, который представляет имя селектора.

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

Селектор, названный aSelectorName. Если aSelectorName nil, или не может быть преобразован в UTF-8 (это должно быть только вследствие недостаточно памяти), возвраты (SEL)0.

Обсуждение

Сделать селектор, NSSelectorFromString передает закодированное символьное представление UTF-8 aSelectorName к sel_registerName и возвращает значение, возвращенное той функцией. Отметьте, поэтому, что, если селектор не существует, он регистрируется, и недавно зарегистрированный селектор возвращается.

Вспомните что двоеточие (“”:) часть имени метода; setHeight не то же как setHeight:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSStringFromSelector
NSProtocolFromString
NSClassFromString

NSStringFromSelector (_:) NSStringFromSelector

Возвращает строковое представление данного селектора.

Объявление

Swift

func NSStringFromSelector(_ aSelector: Selector) -> String!

Objective C

NSString * NSStringFromSelector ( SEL aSelector );

Параметры

aSelector

Селектор.

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

Строковое представление aSelector.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSelectorFromString
NSStringFromProtocol
NSStringFromClass
NSStringFromProtocol (_:) NSStringFromProtocol

Возвращает имя протокола как строка.

Объявление

Swift

func NSStringFromProtocol(_ proto: Protocol!) -> String!

Objective C

NSString * NSStringFromProtocol ( Protocol *proto );

Параметры

proto

Протокол.

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

Строка, содержащая имя proto.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSProtocolFromString
NSStringFromClass
NSStringFromSelector
NSProtocolFromString (_:) NSProtocolFromString

Возвращает протокол с именем.

Объявление

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

Доступность

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

См. также

NSStringFromProtocol
NSClassFromString
NSSelectorFromString

Журналирование вывода

NSLog NSLog

Регистрирует сообщение об ошибке к Системному средству Журнала Apple.

Объявление

Objective C

void NSLog ( NSString *format, ... );

Обсуждение

Просто вызовы NSLogv, передача его переменное число параметров.

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

Objective C

@import Foundation;

Доступность

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

См. также

NSLogv
NSLogv (_: _:) NSLogv

Регистрирует сообщение об ошибке к Системному средству Журнала 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

Доступность

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

См. также

NSLog

Управление путями к файлам

NSFullUserName () NSFullUserName

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

Объявление

Swift

func NSFullUserName() -> String!

Objective C

NSString * NSFullUserName ( void );

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSUserName
NSHomeDirectory () NSHomeDirectory

Возвращает путь или к корневому каталогу пользователя или к приложения, в зависимости от платформы.

Объявление

Swift

func NSHomeDirectory() -> String!

Objective C

NSString * NSHomeDirectory ( void );

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

Путь к текущему корневому каталогу..

Обсуждение

В iOS корневой каталог является каталогом песочницы приложения. В OS X это - каталог песочницы приложения или корневой каталог текущего пользователя (если приложение не находится в песочнице),

Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSFullUserName
NSUserName
NSHomeDirectoryForUser
NSHomeDirectoryForUser (_:) NSHomeDirectoryForUser

Возвращает путь к корневому каталогу данного пользователя.

Объявление

Swift

func NSHomeDirectoryForUser(_ userName: String!) -> String!

Objective C

NSString * NSHomeDirectoryForUser ( NSString *userName );

Параметры

userName

Имя пользователя.

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

Путь к корневому каталогу для пользователя, указанного userName.

Обсуждение

Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSFullUserName
NSUserName
NSHomeDirectory
NSOpenStepRootDirectory () NSOpenStepRootDirectory

Возвращает корневой каталог системы пользователя.

Объявление

Swift

func NSOpenStepRootDirectory() -> String!

Objective C

NSString * NSOpenStepRootDirectory ( void );

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

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

Обсуждение

Для получения дополнительной информации об утилитах файловой системы посмотрите, что Низкоуровневое управление файлами Программирует Темы.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSHomeDirectory
NSHomeDirectoryForUser
NSSearchPathForDirectoriesInDomains (_: _: _:) NSSearchPathForDirectoriesInDomains

Создает список путей поиска каталога.

Объявление

Swift

func NSSearchPathForDirectoriesInDomains(_ directory: NSSearchPathDirectory, _ domainMask: NSSearchPathDomainMask, _ expandTilde: Bool) -> [AnyObject]!

Objective C

NSArray * NSSearchPathForDirectoriesInDomains ( NSSearchPathDirectory directory, NSSearchPathDomainMask domainMask, BOOL expandTilde );

Обсуждение

Создает список строк пути для указанных каталогов в указанных доменах. Список находится в порядке, в котором необходимо искать каталоги. Если expandTilde YEStrue, тильды расширены, как описано в stringByExpandingTildeInPath.

Необходимо рассмотреть использование NSFileManager методы URLsForDirectory:inDomains: и URLForDirectory:inDomain:appropriateForURL:create:error:. которые возвращают URLs, который является предпочтительным форматом.

Для получения дополнительной информации об утилитах файловой системы см. Руководство по программированию Файловой системы.

Примечание:

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает путь временного каталога для текущего пользователя.

Объявление

Swift

func NSTemporaryDirectory() -> String!

Objective C

NSString * NSTemporaryDirectory ( void );

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

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

Обсуждение

Посмотрите NSFileManager метод URLForDirectory:inDomain:appropriateForURL:create:error: для предпочтительных средних значений нахождения корректного временного каталога.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSearchPathForDirectoriesInDomains
NSHomeDirectory
NSUserName () NSUserName

Возвращает имя входа в систему текущего пользователя.

Объявление

Swift

func NSUserName() -> String!

Objective C

NSString * NSUserName ( void );

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

Имя входа в систему текущего пользователя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSFullUserName
NSHomeDirectory
NSHomeDirectoryForUser

Управление точками

NSEqualPoints (_: _:) NSEqualPoints

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

Объявление

Swift

func NSEqualPoints(_ aPoint: NSPoint, _ bPoint: NSPoint) -> Bool

Objective C

BOOL NSEqualPoints ( NSPoint aPoint, NSPoint bPoint );

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

YEStrue если две точки aPoint и bPoint идентичны, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Создает новое NSPoint от указанных значений.

Объявление

Swift

func NSMakePoint(_ x: CGFloat, _ y: CGFloat) -> NSPoint

Objective C

NSPoint NSMakePoint ( CGFloat x, CGFloat y );

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

NSPoint наличие координат x и y.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает точку из основанного на тексте представления.

Объявление

Swift

func NSPointFromString(_ aString: String!) -> NSPoint

Objective C

NSPoint NSPointFromString ( NSString *aString );

Параметры

aString

Строка формы “{x, y}”.

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

Если aString имеет форму “{x, y}” NSPoint структура, использующая x и y в качестве координат x и y в том порядке.
Если aString только содержит единственное число, оно используется в качестве координаты x. Если aString не содержит чисел, возвраты NSPoint возразите, чьи координаты x и y оба 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSStringFromPoint
NSStringFromPoint (_:) NSStringFromPoint

Возвращает строковое представление точки.

Объявление

Swift

func NSStringFromPoint(_ aPoint: NSPoint) -> String!

Objective C

NSString * NSStringFromPoint ( NSPoint aPoint );

Параметры

aPoint

Структура точки.

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

Строка формы “{a, b}”, где a и b являются координатами x и y aPoint.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPointFromString
NSPointFromCGPoint (_:) NSPointFromCGPoint

Возвраты NSPoint преобразование типа от a CGPoint.

Объявление

Swift

func NSPointFromCGPoint(_ cgpoint: CGPoint) -> NSPoint

Objective C

NSPoint NSPointFromCGPoint ( CGPoint cgpoint );

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

NSPoint преобразование типа от a CGPoint.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPointToCGPoint
NSRectFromCGRect
NSSizeFromCGSize
NSPointToCGPoint (_:) NSPointToCGPoint

Возвраты a CGPoint преобразование типа от NSPoint.

Объявление

Swift

func NSPointToCGPoint(_ nspoint: NSPoint) -> CGPoint

Objective C

CGPoint NSPointToCGPoint ( NSPoint nspoint );

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

A CGPoint преобразование типа от NSPoint.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPointFromCGPoint
NSRectToCGRect
NSSizeToCGSize

Управление диапазонами

NSEqualRanges (_: _:) NSEqualRanges

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

Объявление

Swift

func NSEqualRanges(_ range1: NSRange, _ range2: NSRange) -> Bool

Objective C

BOOL NSEqualRanges ( NSRange range1, NSRange range2 );

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

YEStrue если range1 и range2 имейте те же расположения и длины.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает пересечение указанных диапазонов.

Объявление

Swift

func NSIntersectionRange(_ range1: NSRange, _ range2: NSRange) -> NSRange

Objective C

NSRange NSIntersectionRange ( NSRange range1, NSRange range2 );

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

Диапазон, описывающий пересечение range1 и range2— т.е. диапазон, содержащий индексы, существующие в обоих диапазонах.

Обсуждение

Если поле длины возвращенного диапазона 0, то два диапазона не пересекаются, и значение поля расположения не определено.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSUnionRange
NSLocationInRange (_: _:) NSLocationInRange

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

Объявление

Swift

func NSLocationInRange(_ loc: Int, _ range: NSRange) -> Bool

Objective C

BOOL NSLocationInRange ( NSUInteger loc, NSRange range );

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

YEStrue если loc находится в range— т.е. если это больше, чем или равно range.location и меньше, чем range.location плюс range.length.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Создает новый NSRange из указанных значений.

Объявление

Swift

func NSMakeRange(_ loc: Int, _ len: Int) -> NSRange

Objective C

NSRange NSMakeRange ( NSUInteger loc, NSUInteger len );

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

NSRange с расположением location и длина length.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает сумму расположения и длину диапазона.

Объявление

Swift

func NSMaxRange(_ range: NSRange) -> Int

Objective C

NSUInteger NSMaxRange ( NSRange range );

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

Сумма расположения и длина диапазона — т.е. range.location + range.length.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает диапазон от текстового представления.

Объявление

Swift

func NSRangeFromString(_ aString: String!) -> NSRange

Objective C

NSRange NSRangeFromString ( NSString *aString );

Обсуждение

Сканирования aString для двух целых чисел, использующихся в качестве расположения и значений длины, в том порядке, для создания NSRange структура. Если aString только содержит единственное целое число, оно используется в качестве значения расположения. Если aString не содержит целых чисел, эта функция возвращается NSRange структура, расположение которой и значения длины оба 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSStringFromRange
NSStringFromRange (_:) NSStringFromRange

Возвращает строковое представление диапазона.

Объявление

Swift

func NSStringFromRange(_ range: NSRange) -> String!

Objective C

NSString * NSStringFromRange ( NSRange range );

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

Строка формы “{a, b}”, где a и b являются неотрицательным целочисленным представлением aRange.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает объединение указанных диапазонов.

Объявление

Swift

func NSUnionRange(_ range1: NSRange, _ range2: NSRange) -> NSRange

Objective C

NSRange NSUnionRange ( NSRange range1, NSRange range2 );

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

Диапазон, покрывающий все индексы в и между range1 и range2. Если один диапазон полностью содержится в другом, возвращенный диапазон равен большему диапазону.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSIntersectionRange

Управление прямоугольниками

NSContainsRect (_: _:) NSContainsRect

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

Объявление

Swift

func NSContainsRect(_ aRect: NSRect, _ bRect: NSRect) -> Bool

Objective C

BOOL NSContainsRect ( NSRect aRect, NSRect bRect );

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

YEStrue если aRect полностью включает bRect. Для этого условия быть истиной, bRect не может быть пустым, и не должен расширяться вне aRect в любом направлении.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Делит прямоугольник на два новых прямоугольника.

Объявление

Swift

func NSDivideRect(_ inRect: NSRect, _ slice: UnsafeMutablePointer<NSRect>, _ rem: UnsafeMutablePointer<NSRect>, _ amount: CGFloat, _ edge: NSRectEdge)

Objective C

void NSDivideRect ( NSRect inRect, NSRect *slice, NSRect *rem, CGFloat amount, NSRectEdge edge );

Обсуждение

Создает два прямоугольника —slice и rem— от inRect, путем деления inRect со строкой это параллельно стороне inRect указанный edge. Размер slice определяется amount, который указывает расстояние от edge.

slice и rem не должен быть NULL.

Для получения дополнительной информации посмотрите NSRectEdge.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSInsetRect
NSIntegralRectWithOptions
NSOffsetRect
NSEqualRects (_: _:) NSEqualRects

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

Объявление

Swift

func NSEqualRects(_ aRect: NSRect, _ bRect: NSRect) -> Bool

Objective C

BOOL NSEqualRects ( NSRect aRect, NSRect bRect );

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

YEStrue если aRect и bRect идентичны, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

func NSIsEmptyRect(_ aRect: NSRect) -> Bool

Objective C

BOOL NSIsEmptyRect ( NSRect aRect );

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

YEStrue если aRect если ее ширина или высота 0 или отрицательны, иначе т.е. не включает области вообще — NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

func NSHeight(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSHeight ( NSRect aRect );

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

Высота aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMaxX
NSMaxY
NSMidX
NSMidY
NSMinX
NSMinY
NSWidth
NSInsetRect (_: _: _:) NSInsetRect

Вставляет прямоугольник указанной суммой.

Объявление

Swift

func NSInsetRect(_ aRect: NSRect, _ dX: CGFloat, _ dY: CGFloat) -> NSRect

Objective C

NSRect NSInsetRect ( NSRect aRect, CGFloat dX, CGFloat dY );

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

Копия aRect, измененный путем перемещения двух сторон, которые параллельны оси y внутрь dX, и эти две стороны находят что-либо подобное к оси X внутрь dY.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSDivideRect
NSIntegralRectWithOptions
NSOffsetRect
NSIntegralRect (_:) NSIntegralRect

Корректирует стороны прямоугольника к целочисленным значениям.

Объявление

Swift

func NSIntegralRect(_ aRect: NSRect) -> NSRect

Objective C

NSRect NSIntegralRect ( NSRect aRect );

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

Копия aRect, расширенный достаточно исходящий, чтобы гарантировать, чтобы ни одно из ее четырех значений определения (x, y, ширина и высота) не имело дробные части. Если ширина или высота aRect 0 или отрицательный, эта функция возвращает прямоугольник с источником в (0.0, 0.0) и с нулевой шириной и высотой.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSDivideRect
NSInsetRect
NSOffsetRect
NSIntegralRectWithOptions (_: _:) NSIntegralRectWithOptions

Корректирует стороны прямоугольника к интегральным значениям с помощью указанных опций.

Объявление

Swift

func NSIntegralRectWithOptions(_ aRect: NSRect, _ opts: NSAlignmentOptions) -> NSRect

Objective C

NSRect NSIntegralRectWithOptions ( NSRect aRect, NSAlignmentOptions opts );

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

Копия aRect, измененный на основе опций. Опции определяются в NSAlignmentOptions.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSIntegralRect
NSIntersectionRect (_: _:) NSIntersectionRect

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

Объявление

Swift

func NSIntersectionRect(_ aRect: NSRect, _ bRect: NSRect) -> NSRect

Objective C

NSRect NSIntersectionRect ( NSRect aRect, NSRect bRect );

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

Графическое пересечение aRect и bRect. Если эти два прямоугольника не накладываются, возвращенный прямоугольник возникает в (0.0, 0.0) и нулевая ширина и высота (включая ситуации, где пересечение является точкой или линейным сегментом).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSUnionRect
NSIntersectsRect (_: _:) NSIntersectsRect

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

Объявление

Swift

func NSIntersectsRect(_ aRect: NSRect, _ bRect: NSRect) -> Bool

Objective C

BOOL NSIntersectsRect ( NSRect aRect, NSRect bRect );

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

YEStrue если aRect пересекается bRect, иначе NOfalse. Возвраты NOfalse если также aRect или bRect имеет ширину или высоту, которая является 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSIntersectionRect
NSMakeRect (_: _: _: _:) NSMakeRect

Создает новое NSRect от указанных значений.

Объявление

Swift

func NSMakeRect(_ x: CGFloat, _ y: CGFloat, _ w: CGFloat, _ h: CGFloat) -> NSRect

Objective C

NSRect NSMakeRect ( CGFloat x, CGFloat y, CGFloat w, CGFloat h );

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

NSRect возникновение [x, y] и размер [w, h].

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает самую большую x координату данного прямоугольника.

Объявление

Swift

func NSMaxX(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMaxX ( NSRect aRect );

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

Самые большие x координируют значение в aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMaxY
NSMaxY (_:) NSMaxY

Возвращает самую большую y координату данного прямоугольника.

Объявление

Swift

func NSMaxY(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMaxY ( NSRect aRect );

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

Самые большие y координируют значение в aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMaxX
NSMidX (_:) NSMidX

Возвращает x координату средней точки данного прямоугольника.

Объявление

Swift

func NSMidX(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMidX ( NSRect aRect );

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

Возвращает x координату центра aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMidY
NSMidY (_:) NSMidY

Возвращает y координату средней точки данного прямоугольника.

Объявление

Swift

func NSMidY(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMidY ( NSRect aRect );

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

Y координата aRectцентральная точка.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMidX
NSMinX (_:) NSMinX

Возвращает самую маленькую x координату данного прямоугольника.

Объявление

Swift

func NSMinX(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMinX ( NSRect aRect );

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

Самые маленькие x координируют значение в aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMinY
NSMinY (_:) NSMinY

Возвращает самую маленькую y координату данного прямоугольника.

Объявление

Swift

func NSMinY(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSMinY ( NSRect aRect );

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

Самые маленькие y координируют значение в aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSWidth
NSHeight
NSMinX
NSMouseInRect (_: _: _:) NSMouseInRect

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

Объявление

Swift

func NSMouseInRect(_ aPoint: NSPoint, _ aRect: NSRect, _ flipped: Bool) -> Bool

Objective C

BOOL NSMouseInRect ( NSPoint aPoint, NSRect aRect, BOOL flipped );

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

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

Обсуждение

Этот метод принимает немасштабированную и неповернутую систему координат. Указать YEStrue для flipped если базовое представление использует зеркально отраженную систему координат.

Функции точки в прямоугольнике обычно предполагают, что базовый край прямоугольника за пределами прямоугольных границ, в то время как верхний край в границах. Этот метод представления aRect с точки зрения пользователя — т.е. этот метод всегда обрабатывает базовый край прямоугольника как одно самое близкое к базовому краю экрана пользователя. Путем внесения этой корректировки эта функция гарантирует непротиворечивое поведение обнаружения мыши с точки зрения пользователя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPointInRect
NSOffsetRect (_: _: _:) NSOffsetRect

Смещает прямоугольник указанной суммой.

Объявление

Swift

func NSOffsetRect(_ aRect: NSRect, _ dX: CGFloat, _ dY: CGFloat) -> NSRect

Objective C

NSRect NSOffsetRect ( NSRect aRect, CGFloat dX, CGFloat dY );

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

Копия aRect, с его расположением, смещенным на dX вдоль оси X и dY вдоль оси y.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSDivideRect
NSInsetRect
NSIntegralRectWithOptions
NSPointInRect (_: _:) NSPointInRect
Возвращает булево значение, указывающее, является ли данная точка в данном прямоугольнике.

Объявление

Swift

func NSPointInRect(_ aPoint: NSPoint, _ aRect: NSRect) -> Bool

Objective C

BOOL NSPointInRect ( NSPoint aPoint, NSRect aRect );

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

YEStrue если aPoint расположен в прямоугольнике, представленном aRect, иначе NOfalse.

Обсуждение

Функции точки в прямоугольнике обычно предполагают, что «верхние» и «левые» края прямоугольника в прямоугольных границах, в то время как «ниже» и «правильные» края вне границ. Этот метод обрабатывает «верхние» и «левые» края прямоугольника как те содержащие источник прямоугольника.
Специальные замечания

Значения «верхних» и «более низких» (и «оставленный» и «право») относительно текущей системы координат и расположения прямоугольника. Для прямоугольника положительной высоты, расположенной в положительных координатах x и y:
- В системе координаты рабочего стола OS X по умолчанию — где источник в нижней левой части — прямоугольный край, самый близкий к нижней части экрана, является «верхним» краем (и рассматривается в прямоугольнике).
- На iOS и в зеркально отраженной системе координат на рабочем столе OS X — где источник наверху оставляют — прямоугольный край, самый близкий к нижней части экрана, является «более низким» краем (и рассматривается вне прямоугольника).
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMouseInRect
NSRectFromString (_:) NSRectFromString

Возвращает прямоугольник из основанного на тексте представления.

Объявление

Swift

func NSRectFromString(_ aString: String!) -> NSRect

Objective C

NSRect NSRectFromString ( NSString *aString );

Обсуждение

Сканирования aString для четырех чисел, использующихся в качестве координат x и y и ширины и высоты, в том порядке, для создания объекта NSPoint. Если aString не содержит четыре числа, те отсканированные числа используются, и 0 используется для остающихся значений. Если aString не содержит чисел, эта функция возвращает объект NSRect с прямоугольником, источник которого (0, 0), и ширина и высота оба 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSStringFromRect
NSStringFromRect (_:) NSStringFromRect

Возвращает строковое представление прямоугольника.

Объявление

Swift

func NSStringFromRect(_ aRect: NSRect) -> String!

Objective C

NSString * NSStringFromRect ( NSRect aRect );

Обсуждение

Возвращает строку формы “{{a, b}, {c, d}}”, где a, b, c, и d являются координатами x и y и шириной и высотой, соответственно, aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSRectFromString
NSRectFromCGRect (_:) NSRectFromCGRect

Возвраты NSRect преобразование типа от a CGRect.

Объявление

Swift

func NSRectFromCGRect(_ cgrect: CGRect) -> NSRect

Objective C

NSRect NSRectFromCGRect ( CGRect cgrect );

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

NSRect преобразование типа от a CGRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSRectToCGRect
NSPointFromCGPoint
NSSizeFromCGSize
NSRectToCGRect (_:) NSRectToCGRect

Возвраты a CGRect преобразование типа от NSRect.

Объявление

Swift

func NSRectToCGRect(_ nsrect: NSRect) -> CGRect

Objective C

CGRect NSRectToCGRect ( NSRect nsrect );

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

A CGRect преобразование типа от NSRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSRectFromCGRect
NSPointToCGPoint
NSSizeToCGSize
NSUnionRect (_: _:) NSUnionRect

Вычисляет объединение двух прямоугольников.

Объявление

Swift

func NSUnionRect(_ aRect: NSRect, _ bRect: NSRect) -> NSRect

Objective C

NSRect NSUnionRect ( NSRect aRect, NSRect bRect );

Обсуждение

Возвращает наименьший прямоугольник, полностью включающий обоих aRect и bRect. Если один из прямоугольников имеет 0 (или отрицательный) ширина или высота, копия другого прямоугольника возвращается; но если оба имеют 0 (или отрицательный) ширина или высота, возвращенный прямоугольник возникает в (0.0, 0.0) и имеет 0 ширин и высоту.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSIntersectionRect
NSWidth (_:) NSWidth

Возвращает ширину указанного прямоугольника.

Объявление

Swift

func NSWidth(_ aRect: NSRect) -> CGFloat

Objective C

CGFloat NSWidth ( NSRect aRect );

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

Ширина aRect.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSMaxX
NSMaxY
NSMidX
NSMidY
NSMinX
NSMinY
NSHeight

Управление размерами

NSEqualSizes (_: _:) NSEqualSizes

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

Объявление

Swift

func NSEqualSizes(_ aSize: NSSize, _ bSize: NSSize) -> Bool

Objective C

BOOL NSEqualSizes ( NSSize aSize, NSSize bSize );

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

YEStrue если aSize и bSize идентичны, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает новое NSSize от указанных значений.

Объявление

Swift

func NSMakeSize(_ w: CGFloat, _ h: CGFloat) -> NSSize

Objective C

NSSize NSMakeSize ( CGFloat w, CGFloat h );

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

NSSize наличие указанного width и height.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвраты NSSize от основанного на тексте представления.

Объявление

Swift

func NSSizeFromString(_ aString: String!) -> NSSize

Objective C

NSSize NSSizeFromString ( NSString *aString );

Обсуждение

Сканирования aString для двух чисел, использующихся в качестве ширины и высоты, в том порядке, для создания NSSize структура. Если aString только содержит единственное число, оно используется в качестве ширины. aString параметр должен быть отформатирован как вывод NSStringFromSize, например, @"{10,20}". Если aString не содержит чисел, эта функция возвращается NSSize структура, ширина которой и высота - оба 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSStringFromSize
NSStringFromSize (_:) NSStringFromSize

Возвращает строковое представление размера.

Объявление

Swift

func NSStringFromSize(_ aSize: NSSize) -> String!

Objective C

NSString * NSStringFromSize ( NSSize aSize );

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

Строка формы “{a, b}”, где a и b являются шириной и высотой, соответственно, aSize.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSizeFromString
NSSizeFromCGSize (_:) NSSizeFromCGSize

Возвраты NSSize преобразование типа от a CGSize.

Объявление

Swift

func NSSizeFromCGSize(_ cgsize: CGSize) -> NSSize

Objective C

NSSize NSSizeFromCGSize ( CGSize cgsize );

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

NSSize преобразование типа от a CGSize.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSizeToCGSize
NSPointFromCGPoint
NSRectFromCGRect
NSSizeToCGSize (_:) NSSizeToCGSize

Возвраты a CGSize преобразование типа от NSSize.

Объявление

Swift

func NSSizeToCGSize(_ nssize: NSSize) -> CGSize

Objective C

CGSize NSSizeToCGSize ( NSSize nssize );

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

A CGSize преобразование типа от NSSize.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSizeFromCGSize
NSPointToCGPoint
NSRectToCGRect

Обработчики необработанных исключений

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

NSGetUncaughtExceptionHandler () NSGetUncaughtExceptionHandler

Возвращает обработчик ошибок верхнего уровня.

Объявление

Swift

func NSGetUncaughtExceptionHandler() -> CFunctionPointer<NSUncaughtExceptionHandler>

Objective C

NSUncaughtExceptionHandler * NSGetUncaughtExceptionHandler ( void );

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSSetUncaughtExceptionHandler
NSSetUncaughtExceptionHandler (_:) NSSetUncaughtExceptionHandler

Изменяет обработчик ошибок верхнего уровня.

Объявление

Swift

func NSSetUncaughtExceptionHandler(_ _: CFunctionPointer<NSUncaughtExceptionHandler>)

Objective C

void NSSetUncaughtExceptionHandler ( NSUncaughtExceptionHandler * );

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSGetUncaughtExceptionHandler
reportException: (NSApplication)

Базовая основа интеграция ARC

CFBridgingRetain (_:) CFBridgingRetain
Бросает указатель 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

Доступность

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

См. также

CFBridgingRelease
CFBridgingRelease CFBridgingRelease
Перемещает указатель не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;

Доступность

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

См. также

CFBridgingRetain

Управление памятью

NSAllocateMemoryPages (_:) NSAllocateMemoryPages

Выделяет новый блок памяти.

Объявление

Swift

func NSAllocateMemoryPages(_ bytes: Int) -> UnsafeMutablePointer<Void>

Objective C

void * NSAllocateMemoryPages ( NSUInteger bytes );

Обсуждение

Выделяет целое число страниц, общий размер которых является самым близким к, но не меньше, чем, byteCount. Выделенные страницы, как гарантируют, будут заполнены нулями. Если выделение перестало работать, повышения NSInvalidArgumentException.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCopyMemoryPages
NSDeallocateMemoryPages
NSCopyMemoryPages (_: _: _:) NSCopyMemoryPages

Копирует блок памяти.

Объявление

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

Доступность

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

См. также

NSAllocateMemoryPages
NSDeallocateMemoryPages
NSDeallocateMemoryPages (_: _:) NSDeallocateMemoryPages

Освобождает указанный блок памяти.

Объявление

Swift

func NSDeallocateMemoryPages(_ ptr: UnsafeMutablePointer<Void>, _ bytes: Int)

Objective C

void NSDeallocateMemoryPages ( void *ptr, NSUInteger bytes );

Обсуждение

Эта функция освобождает память, выделенную с NSAllocateMemoryPages.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSCopyMemoryPages
NSAllocateMemoryPages
NSLogPageSize () NSLogPageSize

Возвращает двоичный журнал размера страницы.

Объявление

Swift

func NSLogPageSize() -> Int

Objective C

NSUInteger NSLogPageSize ( void );

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

Двоичный журнал размера страницы.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSRoundDownToMultipleOfPageSize
NSRoundUpToMultipleOfPageSize
NSPageSize
NSPageSize () NSPageSize

Возвращает число байтов на странице.

Объявление

Swift

func NSPageSize() -> Int

Objective C

NSUInteger NSPageSize ( void );

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

Число байтов на странице.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSRoundDownToMultipleOfPageSize
NSRoundUpToMultipleOfPageSize
NSLogPageSize
NSRealMemoryAvailable NSRealMemoryAvailable (OS X v10.8)

Информация о возвратах о системе пользователя.

Объявление

Objective C

NSUInteger NSRealMemoryAvailable ( void );

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

Число байтов, доступных в RAM.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
NSRoundDownToMultipleOfPageSize (_:) NSRoundDownToMultipleOfPageSize

Возвращает конкретное количество байтов, округленных в меньшую сторону до кратного числа размера страницы.

Объявление

Swift

func NSRoundDownToMultipleOfPageSize(_ bytes: Int) -> Int

Objective C

NSUInteger NSRoundDownToMultipleOfPageSize ( NSUInteger bytes );

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

В байтах, кратном числе размера страницы, который является самым близким к, но не больше, чем, byteCount (т.е. число байтов, округленных в меньшую сторону до кратного числа размера страницы).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPageSize
NSLogPageSize
NSRoundUpToMultipleOfPageSize
NSRoundUpToMultipleOfPageSize (_:) NSRoundUpToMultipleOfPageSize

Возвращает конкретное количество байтов, окруженных к кратному числу размера страницы.

Объявление

Swift

func NSRoundUpToMultipleOfPageSize(_ bytes: Int) -> Int

Objective C

NSUInteger NSRoundUpToMultipleOfPageSize ( NSUInteger bytes );

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

В байтах, кратном числе размера страницы, который является самым близким к, но не меньше, чем, byteCount (т.е. число байтов, окруженных к кратному числу размера страницы).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

NSPageSize
NSLogPageSize
NSRoundDownToMultipleOfPageSize


    
    NSAllocateCollectable (_: _:)
    NSAllocateCollectable

Выделяет подлежащую сбору память.

Сборка «мусора» осуждается в OS X v10.8; вместо этого, необходимо использовать подсчет AutomaticReference — посмотрите Переход к Информации о версии ARC.

Объявление

Swift

func NSAllocateCollectable(_ size: Int, _ options: Int) -> UnsafeMutablePointer<Void>

Objective C

void * NSAllocateCollectable ( NSUInteger size, NSUInteger options );

Параметры

`size`	Число байтов памяти для выделения.
`options`	`0` или `NSScannedOption`: Значение `0` выделяет неотсканированную память; значение `NSScannedOption` выделяет отсканированную память.

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

Указатель на выделенную память, или NULL если функция неспособна выделить требуемую память.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

NSReallocateCollectable (_: _: _:) NSReallocateCollectable

Перераспределяет подлежащую сбору память.

Сборка «мусора» осуждается в OS X v10.8; вместо этого, необходимо использовать подсчет AutomaticReference — посмотрите Переход к Информации о версии ARC.

Объявление

Swift

func NSReallocateCollectable(_ ptr: UnsafeMutablePointer<Void>, _ size: Int, _ options: Int) -> UnsafeMutablePointer<Void>

Objective C

void * NSReallocateCollectable ( void *ptr, NSUInteger size, NSUInteger options );

Обсуждение

Изменяет размер блока памяти, которой указывают ptr к size байты. Это может выделить новую память для замены старого, когда это перемещает содержание старого блока памяти к новому блоку до максимума size байты.

options может быть 0 или NSScannedOption: Значение 0 выделяет неотсканированную память; значение NSScannedOption выделяет отсканированную память.

Эта функция возвраты NULL если это неспособно выделить требуемую память.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
NSMakeCollectable NSMakeCollectable
Делает недавно выделенный Базовый объект Основы имеющим право на набор.

Сборка «мусора» осуждается в 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;

Доступность

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

Управление зонами

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

NSCreateZone NSCreateZone

Создает новую зону.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

NSZone * NSCreateZone ( NSUInteger startSize, NSUInteger granularity, BOOL canFree );

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

Указатель на новую зону startSize байты, которые будут расти и уменьшаться granularity байты. Если canFree 0, средство выделения никогда не будет свободная память, и malloc будет быстро. Возвраты NULL если не могла бы быть создана новая зона.

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

Objective C

@import Foundation;

Доступность

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

Освобождает память в зоне.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void NSRecycleZone ( NSZone *zone );

Обсуждение

Освобождает zone после добавления любого из его указателей все еще в использовании к зоне по умолчанию. (Эта стратегия препятствует сохраненным объектам быть непреднамеренно уничтоженной.)

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

Objective C

@import Foundation;

Доступность

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

Определяет имя указанной зоны.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void NSSetZoneName ( NSZone *zone, NSString *name );

Обсуждение

Определяет имя zone к name, который может помочь в отладке.

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

Objective C

@import Foundation;

Доступность

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

Выделяет память в зоне.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void * NSZoneCalloc ( NSZone *zone, NSUInteger numElems, NSUInteger byteSize );

Обсуждение

Выделяет достаточно памяти от zone для numElems элементы, каждый с размером numBytes байты и возвраты указатель на выделенную память. Память инициализируется с нулями. Эта функция возвраты NULL если это было неспособно выделить требуемую память.

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

Objective C

@import Foundation;

Доступность

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

Освобождает блок памяти в указанной зоне.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void NSZoneFree ( NSZone *zone, void *ptr );

Обсуждение

Память возвратов к zone от которого это было выделено. Стандарт C функция free делает то же, но проводит время, находя, которые зонируют память, принадлежит.

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

Objective C

@import Foundation;

Доступность

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

Получает зону для данного блока памяти.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

NSZone * NSZoneFromPointer ( void *ptr );

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

Зона для блока памяти, обозначенной pointer, или NULL если блок не был выделен от зоны.

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

Выделяет память в зоне.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void * NSZoneMalloc ( NSZone *zone, NSUInteger size );

Обсуждение

Выделяет size байты в zone и возвращает указатель на выделенную память. Эта функция возвраты NULL если это было неспособно выделить требуемую память.

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

Objective C

@import Foundation;

Доступность

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

Возвращает имя указанной зоны.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

NSString * NSZoneName ( NSZone *zone );

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

Строка, содержащая имя, связалась с zone. Если zone nil, зона по умолчанию используется. Если никакое имя не связано с zone, возвращаемая строка пуста.

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

Objective C

@import Foundation;

Доступность

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

Выделяет память в зоне.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Objective C

void * NSZoneRealloc ( NSZone *zone, void *ptr, NSUInteger size );

Обсуждение

Изменяет размер блока памяти, которой указывают ptr к size байты. Это может выделить новую память для замены старого, когда это перемещает содержание старого блока памяти к новому блоку до максимума size байты. ptr может быть NULL. Эта функция возвраты NULL если это было неспособно выделить требуемую память.

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

Objective C

@import Foundation;

Доступность

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

Возвращает зону по умолчанию.

Зоны проигнорированы на iOS и 64-разрядное время выполнения на OS X. Вы не должны использовать зоны в текущей разработке.

Объявление

Swift

func NSDefaultMallocZone() -> NSZone

Objective C

NSZone * NSDefaultMallocZone ( void );

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

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

Обсуждение

Эта зона используется стандартом C функция malloc.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

`anObject`	Объект.
`requestedZone`	Зона памяти.