objc パッケージの関数
objc パッケージは Foreign Function API で Objective-C ランタイムと AppKit をバインドします。リフレクションを使わないため、java: と違って java -jar だけでなくネイティブバイナリでも動作します。macOS 専用で (インタプリタ、コンパイル済み .class / .jar、Apple silicon の macOS 向け --native 実行ファイルで動作し、.wasm では使えません)、Common Lisp の一部ではありません。関数は objc: 修飾子付きで参照するか、LispWorks のコードと同じくパッケージを use します。語彙は LispWorks 8.1 の Objective-C インターフェースで、それにブロック、Objective-C 自身が報告するものを表すコンディション、独自の 4 つの関数が加わります。各名前は個別のページにリンクしています。変換、スレッド、所有権、ネイティブバイナリの形テーブルについては macOS GUI ガイドを参照してください。
LispWorks のインターフェース
LispWorks 8.1 の Objective-C インターフェースの名前とラムダリストをそのまま持つため、そのマニュアルに沿って書いたコードがここで動きます。型もこのパッケージが名付けます。objc:objc-object-pointer (すべてのオブジェクト)、objc:objc-class (クラス。オブジェクトポインタでもある)、objc:sel (セレクタ) は、以下の関数が返す値の型です。objc:objc-bool、objc:objc-c++-bool、objc:objc-c-string、objc:objc-at-question-mark、objc:objc-unknown は、リスト形式のメソッドと objc:objc-class-method-signature が使う型指定子です。マクロ objc:with-autorelease-pool は本体を自動解放プールの中で評価します。クラスはマクロ objc:define-objc-class、objc:define-objc-method、objc:define-objc-class-method、objc:current-super、objc:define-objc-struct、objc:define-objc-typedef、objc:define-objc-protocol で定義し、そのインスタンスは objc:standard-objc-object です。
| 関数 | 例 | 結果 |
|---|---|---|
objc:ensure-objc-initialized | (objc:ensure-objc-initialized :modules '("/path/Framework")) | nil (モジュールをロードする) |
objc:invoke | (objc:invoke "NSString" "stringWithUTF8String:" "hi") | 宣言型に従って変換されたメソッドの値 |
objc:invoke-bool | (objc:invoke-bool s "hasPrefix:" "h") | t か nil |
objc:invoke-into | (objc:invoke-into 'string s "description") | 第一引数の指示どおりに変換または格納された値 |
objc:can-invoke-p | (objc:can-invoke-p s "length") | t か nil |
objc:alloc-init-object | (objc:alloc-init-object "NSObject") | 新しいインスタンス |
objc:description | (objc:description s) | description の文字列 |
objc:trace-invoke | (objc:trace-invoke "length") | 名前 (以後その送信をトレースする) |
objc:untrace-invoke | (objc:untrace-invoke "length") | 名前 (トレースを解除する) |
objc:coerce-to-objc-class | (objc:coerce-to-objc-class "NSString") | クラスポインタ |
objc:objc-class-name | (objc:objc-class-name c) | クラスの名前 |
objc:coerce-to-selector | (objc:coerce-to-selector "frame") | セレクタ |
objc:selector-name | (objc:selector-name sel) | セレクタの名前 |
objc:objc-class-method-signature | (objc:objc-class-method-signature "NSString" "length") | 引数の型、結果の型、エンコーディング |
objc:retain | (objc:retain p) | retain した p |
objc:release | (objc:release p) | nil (参照を一つ手放す) |
objc:autorelease | (objc:autorelease p) | p (参照を一つプールに渡す) |
objc:retain-count | (objc:retain-count p) | retainCount |
objc:make-autorelease-pool | (objc:make-autorelease-pool) | 解放するまで現在のプールになるプール |
objc:ns-string-to-string | (objc:ns-string-to-string s) | Lisp 文字列 |
objc:string-to-ns-string | (objc:string-to-ns-string "hi") | プログラムが所有する NSString |
objc:objc-object-pointer | (objc:objc-object-pointer p) | オブジェクトのポインタ |
objc:objc-object-from-pointer | (objc:objc-object-from-pointer p) | 対応する Lisp オブジェクト、または nil |
objc:objc-object-var-value | (objc:objc-object-var-value obj "count") | インスタンス変数の値 (setf 可) |
objc:objc-object-copied | (defmethod objc:objc-object-copied :after ((old c) (new c)) ...) | インスタンスが複製されたときに呼ばれる |
objc:objc-object-destroyed | (defmethod objc:objc-object-destroyed :after ((o c)) ...) | インスタンスが解放されたときに呼ばれる |
ブロック
Lisp の関数から作るブロックです。LispWorks の OBJC にはこのインターフェースがないため、このパッケージ独自の名前を使います。objc:objc-block は、ブロックを受け取るメソッドや C 関数にそのまま渡せます。マクロ objc:define-objc-block-type はシグネチャに名前を付け、objc:with-objc-block は本体の間だけ有効なブロックを作ります。dispatch_async などの C 関数は fli:define-foreign-function で宣言します。メソッドが参照渡しで埋める外部オブジェクトも fli パッケージにあります。
| 関数 | 例 | 結果 |
|---|---|---|
objc:make-objc-block | (objc:make-objc-block '(:int (:int :int)) #'+) | 関数を呼ぶ objc:objc-block |
objc:free-objc-block | (objc:free-objc-block b) | nil (呼び出し先が保持したコピーは生き続ける) |
objc:call-objc-block | (objc:call-objc-block '(:int (:int :int)) b 3 4) | ブロックの値 |
objc:objc-block-pointer | (objc:objc-block-pointer b) | リテラルのアドレス (解放後は nil) |
objc:objc-block-live-p | (objc:objc-block-live-p b) | 解放するまで t |
例外と NSError
Objective-C 自身が報告する失敗です。LispWorks の OBJC はこれをコンディションにしません。呼び出しの中で送出された例外は、最も内側の objc:invoke、C 関数またはブロックの呼び出しから objc:objc-exception (error のサブタイプ) としてシグナルされます。objc:invoke-with-error は、NSError ** で失敗を報告したメソッドについて objc:ns-error をシグナルします。
| 関数 | 例 | 結果 |
|---|---|---|
objc:invoke-with-error | (objc:invoke-with-error fm "removeItemAtPath:error:" path) | メソッドの値 (失敗したら objc:ns-error) |
objc:objc-exception-name | (objc:objc-exception-name e) | "NSRangeException" |
objc:objc-exception-reason | (objc:objc-exception-reason e) | 理由 (なければ nil) |
objc:objc-exception-object | (objc:objc-exception-object e) | 送出されたオブジェクト |
objc:ns-error-domain | (objc:ns-error-domain e) | "NSCocoaErrorDomain" |
objc:ns-error-code | (objc:ns-error-code e) | コード (整数) |
objc:ns-error-description | (objc:ns-error-description e) | ローカライズされた説明 |
objc:ns-error-object | (objc:ns-error-object e) | NSError |
このパッケージ独自の関数
LispWorks の OBJC にない関数です。Lisp をメインスレッドで実行する関数、メモリブロックを受け渡す関数、Objective-C のオブジェクトをほかの値と見分ける関数があります。
| 関数 | 例 | 結果 |
|---|---|---|
objc:on-main | (objc:on-main (lambda () ...)) | メインスレッドで計算された関数の値 |
objc:data | (objc:data buffer) | バッファのバイト列を持つ NSMutableData |
objc:bytes | (objc:bytes data) | NSData の内容 (新しい (unsigned-byte 8) ベクタ) |
objc:objectp | (objc:objectp x) | オブジェクトポインタ (クラスを含む) なら t |