NSInvocation

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

NSObject
NSInvocation

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

NSObject

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

Не применимый

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

NSInvocation сообщение Objective C, представленное статичным, т.е. это - действие, превратился в объект. NSInvocation объекты привыкли к сообщениям промежуточной буферизации между объектами и между приложениями, прежде всего NSTimer объекты и распределенная система объектов.

NSInvocation объект содержит все элементы сообщения Objective C: цель, селектор, параметры и возвращаемое значение. Каждый из этих элементов может быть установлен непосредственно, и возвращаемое значение установлено автоматически когда NSInvocation объект диспетчеризируется.

NSInvocation объект может неоднократно диспетчеризироваться различным целям; его параметры могут быть изменены между отгрузкой для переменных результатов; даже его селектор может быть изменен на другого с той же сигнатурой метода (параметр и типы возврата). Эта гибкость делает NSInvocation полезный для повторения сообщений со многими параметрами и изменениями; вместо того, чтобы перепечатывать немного отличающееся выражение для каждого сообщения, Вы изменяете NSInvocation возразите по мере необходимости каждый раз прежде, чем диспетчеризировать его новой цели.

NSInvocation не поддерживает вызовы методов или с переменными числами параметров или с union параметры. Необходимо использовать invocationWithMethodSignature: метод класса создать NSInvocation объекты; Вы не должны создавать эти объекты использование alloc и init.

Этот класс не сохраняет параметры за содержавший вызов по умолчанию. Если те объекты могли бы исчезнуть между временем, Вы создаете свой экземпляр NSInvocation и время, Вы используете его, необходимо явно сохранить объекты сами или вызвать retainArguments метод для имения объекта вызова сохраняет их самого.

Создание объекты NSInvocation

+ invocationWithMethodSignature:

Возвраты NSInvocation возразите способный создать сообщения с помощью данной сигнатуры метода.

Объявление

Objective C

+ (NSInvocation *)invocationWithMethodSignature:(NSMethodSignature *)signature

Параметры

signature

Объект, инкапсулирующий сигнатуру метода.

Обсуждение

Новый объект должен иметь свой селекторный набор с setSelector: и его набор параметров с setArgument:atIndex: прежде чем это сможет быть вызвано. Не используйте alloc/init подход для создания NSInvocation объекты.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

Конфигурирование объекта вызова

selector Свойство

Селектор получателя, или 0, если это не было установлено.

Объявление

Objective C

@property SEL selector

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
target Свойство

Цель получателя, или nil если получатель не имеет никакой цели.

Объявление

Objective C

@property(assign) id target

Обсуждение

Цель является получателем сообщения, отправленного invoke.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– invokeWithTarget:


    
    - setArgument:atIndex:

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

Объявление

Objective C

- (void)setArgument:(void *)buffer atIndex:(NSInteger)index

Параметры


      buffer

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


      index

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

Индексы 0 и 1 указывают скрытые параметры self и _cmd, соответственно; необходимо установить эти значения непосредственно с target и selector свойства. Используйте индексы 2, и больше для параметров обычно передавал в сообщении.

Обсуждение

Этот метод копирует содержание buffer как параметр в index. Число скопированных байтов определяется размером параметра.

Когда значение аргумента является объектом, передайте указатель на переменную (или память), с которого должен быть скопирован объект:

      NSArray *anArray;
[invocation setArgument:&anArray atIndex:3];

Этот метод повышения NSInvalidArgumentException если значение index больше, чем фактическое число параметров за селектор.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getArgument:atIndex:
– numberOfArguments (NSMethodSignature)


    
    - getArgument:atIndex:

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

Объявление

Objective C

- (void)getArgument:(void *)buffer atIndex:(NSInteger)index

Параметры


      buffer

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


      index

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

Индексы 0 и 1 указывают скрытые параметры self и _cmd, соответственно; эти значения могут быть получены непосредственно с target и selector методы. Используйте индексы 2, и больше для параметров обычно передавал в сообщении.

Обсуждение

Этот метод копирует параметр, сохраненный в index в хранение, которым указывают buffer. Размер buffer должно быть достаточно большим для размещения значения аргумента.

Когда значение аргумента является объектом, передайте указатель на переменную (или память), в который должен быть помещен объект:

      NSArray *anArray;
[invocation getArgument:&anArray atIndex:3];

Этот метод повышения NSInvalidArgumentException если index больше, чем фактическое число параметров за селектор.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– setArgument:atIndex:
– numberOfArguments (NSMethodSignature)

argumentsRetained Свойство

YEStrue если получатель сохранил свои параметры, NOfalse иначе. (только для чтения)

Объявление

Objective C

@property(readonly) BOOL argumentsRetained

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– retainArguments
- retainArguments

Если получатель уже не сделал так, сохраняет цель и все объектные параметры получателя и копирует все свои параметры струны до и блоки.

Объявление

Objective C

- (void)retainArguments

Обсуждение

Прежде чем этот метод вызывается, argumentsRetained возвраты NOfalse; после, это возвращается YEStrue.

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.


    
    - setReturnValue:

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

Объявление

Objective C

- (void)setReturnValue:(void *)buffer

Параметры


      buffer

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

Обсуждение

Когда Вы отправляете, это значение обычно устанавливается invoke или invokeWithTarget: сообщение.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getReturnValue:
– methodReturnLength (NSMethodSignature)
– methodReturnType (NSMethodSignature)


    
    - getReturnValue:

Получает возвращаемое значение получателя.

Объявление

Objective C

- (void)getReturnValue:(void *)buffer

Параметры


      buffer

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

Обсуждение

Используйте NSMethodSignature метод methodReturnLength определить размер, необходимый для buffer:

      NSUInteger length = [[myInvocation methodSignature] methodReturnLength];
buffer = (void *)malloc(length);
[invocation getReturnValue:buffer];

Когда возвращаемое значение является объектом, передайте указатель на переменную (или память), в который должен быть помещен объект:

      id anObject;
NSArray *anArray;
[invocation1 getReturnValue:&anObject];
[invocation2 getReturnValue:&anArray];

Если NSInvocation объект никогда не вызывался, результат этого метода не определен.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– setReturnValue:
– methodReturnType (NSMethodSignature)

Диспетчеризация вызова

- вызвать

Отправляет сообщение получателя (с параметрами) к его цели и устанавливает возвращаемое значение.

Объявление

Objective C

- (void)invoke

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getReturnValue:
селектор
селектор
– setArgument:atIndex:
- invokeWithTarget:

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

Объявление

Objective C

- (void)invokeWithTarget:(id)anObject

Параметры

anObject

Объект установить как цель получателя.

Обсуждение

Необходимо установить селектор получателя и значения аргументов прежде, чем вызвать этот метод.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getReturnValue:
– вызвать
селектор
цель
– setArgument:atIndex:

Получение сигнатуры метода

methodSignature Свойство

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

Объявление

Objective C

@property(readonly, retain) NSMethodSignature *methodSignature

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.