NextPrevUpTopContentsIndex

define-objc-method

Macro
Summary

Defines an Objective-C instance method for a specified class.

Package

objc

Signature

define-objc-method ( name result-type [ result-style ])
( object-argspec argspec *) form *

object-argspec ::= ( object-var class-name [ pointer-var ]))

argspec ::= ( arg-var arg-type [ arg-style ])

Arguments

name

A string naming the method to define.

result-type

An Objective-C FLI type.

result-style

An optional keyword specifying the result conversion style, either :lisp or :foreign , or a symbol naming a variable.

object-var

A symbol naming a variable.

class-name

A symbol naming a class defined with define-objc-class.

pointer-var

An optional symbol naming a variable.

arg-var

A symbol naming a variable.

arg-type

An Objective-C FLI type.

arg-style

An optional symbol or list specifying the argument conversion style.

form

A form.

Description

The macro define-objc-method defines the Objective-C instance method name for the Objective-C classes associated with class-name . The name should be a concatenation of the message name and its argument names, including the colons, for example "setWidth:height:" .

If the define-objc-class definition of class-name specifies the (:objc-class-name objc-class-name ) option, then the method is added to the Objective-C class objc-class-name . Otherwise, the method is added to the Objective-C class of every subclass of class-name that specifies the :objc-class-name option, allowing a mixin class to define methods that become part of the implementation of its subclasses (see Abstract classes).

When the method is invoked, each form is evaluated in sequence with object-var bound to the object of type class-name associated with the receiver, pointer-var (if specified) bound to the receiver foreign pointer and each arg-var bound to the corresponding method argument.

Each argument has an arg-type (its Objective-C FLI type) and an optional arg-style , which specifies how the FLI value is converted to a Lisp value. If the arg-style is :foreign , then the arg-var is bound to the FLI value of the argument (typically an integer or foreign pointer). Otherwise, the arg-var is bound to a value converted according to the arg-type :

ns-rect

If arg-style is omitted or :lisp then the rectangle is converted to a vector of four elements of the form #( x y width height ) . Otherwise the argument is a foreign pointer to a ns-rect object.

ns-size

If arg-style is omitted or :lisp then the size is converted to a vector of two elements of the form #( width height ) . Otherwise the argument is a foreign pointer to a ns-size object.

ns-point

If arg-style is omitted or :lisp then the point is converted to a vector of two elements of the form #( x y ) . Otherwise the argument is a foreign pointer to a ns-point object.

ns-range

If arg-style is omitted or :lisp then the range is converted to a cons of the form ( location . length ) . Otherwise the argument is a foreign pointer to a ns-range object.

objc-object-pointer

If arg-style is the symbol string then the argument is assumed to be a pointer to an Objective-C NSString object and is converted to a Lisp string or nil for a null pointer.

If arg-style is the symbol array then the argument is assumed to be a pointer to an Objective-C NSArray object and is converted to a Lisp vector or nil for a null pointer.

If arg-style is the a list of the form (array elt-arg-style ) then the argument is assumed to be a pointer to an Objective-C NSArray object and is recursively converted to a Lisp vector using elt-arg-style for the elements or nil for a null pointer.

Otherwise, the argument remains as a foreign pointer to the Objective-C object.

objc-c-string

If arg-style is the symbol string then the argument is assumed to be a pointer to a foreign string and is converted to a Lisp string or nil for a null pointer.

After the last form has been evaluated, its value is converted to result-type according to result-style and becomes the result of the method.

If result-style is a non-keyword symbol and the result-type is a foreign structure type defined with define-objc-struct then the variable named by result-style is bound to a pointer to a foreign object of type result-type while the form s are evaluated. The form s must set the slots in this foreign object to specify the result.

If result-style is : foreign then the value is assumed to be suitable for conversion to result-type using the normal FLI rules.

If result-style is : lisp then additional conversions are performed for specific values of result-type :

ns-rect

If the value is a vector of four elements of the form #( x y width height ) , the x , y , width and height are used to form the returned rectangle. Otherwise it is assumed to be a foreign pointer to a ns-rect and is copied.

ns-size

If the value is a vector of two elements of the form #( width height ) , the width and height are used to form the returned size. Otherwise it is assumed to be a foreign pointer to a ns-size and is copied.

ns-point

If the value is a vector of two elements of the form #( x y ) , the x and y are used to form the returned point. Otherwise it is assumed to be a foreign pointer to a ns-point and is copied.

ns-range

If the value is a cons of the form ( location . length ) , the location and length are used to form the returned range. Otherwise it is assumed to be a foreign pointer to a ns-range object and is copied.

(:signed :char) or (:unsigned :char)

If the value is nil then NO is returned.If the value is t then YES is returned. Otherwise the value must be an appropriate integer for result-type .

objc-object-pointer

If the value is a string then it is converted to a newly allocated Objective-C NSString object which the caller is expected to release.

If the value is a vector then it is recursively converted to a newly allocated Objective-C NSArray object which the caller is expected to release.

If the value is nil then a null pointer is returned.

Otherwise the value should be a foreign pointer to an Objective-C object of the appropriate class.

objc-class

The value is coerced to a Objective-C class pointer as if by coerce-to-objc-class. In particular, this allows strings to be returned.

The form s can use functions such as invoke to invoke other methods on the pointer-var . The macro current-super can be used to obtain an object that allows methods in the superclass to be invoked (like super in Objective-C).

Example
See also

define-objc-class
define-objc-class-method
current-super
define-objc-struct


LispWorks Objective-C and Cocoa Interface User Guide and Reference Manual - 4 Apr 2005

NextPrevUpTopContentsIndex