CFFI User Manual - Common Lisp.net

More documents

Recommendations

Info

Chapter 6: Foreign Types 32 (path :string) (flags open-flags) (mode :uint16)) ; unportable CFFI> (unix-open "/tmp/foo" ’(:wronly :creat) #o644) ⇒ # ;;; Consider also the following lispier wrapper around open() (defun lispier-open (path mode &rest flags) (unix-open path flags mode)) See Also [foreign-bitfield-value], page 41 [foreign-bitfield-symbols], page 40
Chapter 6: Foreign Types 33 defcstruct Syntax defcstruct name-and-options &body doc-and-slots ⇒ name name-and-options ::= structure-name | (structure-name &key size) doc-and-slots ::= [docstring] { (slot-name slot-type &key count offset) }* [Macro] Arguments and Values structure-name The name of new structure type. docstring slot-name size slot-type count offset A documentation string, ignored. A symbol naming the slot. It must be unique among slot names in this structure. Use this option to override the size (in bytes) of the struct. The type specifier for the slot. Used to declare an array of size count inside the structure. Defaults to 1 as such an array and a single element are semantically equivalent. Overrides the slot’s offset. The next slot’s offset is calculated based on this one. Description This defines a new CFFI aggregate type akin to C structs. In other words, it specifies that foreign objects of the type structure-name are groups of different pieces of data, or “slots”, of the slot-types, distinguished from each other by the slot-names. Each structure is located in memory at a position, and the slots are allocated sequentially beginning at that point in memory (with some padding allowances as defined by the C ABI, unless otherwise requested by specifying an offset from the beginning of the structure (offset 0). In other words, it is isomorphic to the C struct, giving several extra features. There are two kinds of slots, for the two kinds of CFFI types: Simple Contain a single instance of a type that canonicalizes to a built-in type, such as :long or :pointer. Used for simple CFFI types. Aggregate Contain an embedded structure or union, or an array of objects. Used for aggregate CFFI types. The use of CLOS terminology for the structure-related features is intentional; structure definitions are very much like classes with (far) fewer features. Examples (defcstruct point "Point structure." (x :int) (y :int)) CFFI> (with-foreign-object (ptr ’point)
Page 1 and 2: CFFI User Manual
Page 3 and 4: i Table of Contents 1 Introduction.
Page 5 and 6: Chapter 1: Introduction 1 1 Introdu
Page 7 and 8: Chapter 3: Implementation Support 3
Page 9 and 10: Chapter 4: An Introduction to Forei
Page 25 and 26: Chapter 5: Wrapper generators 21 5
Page 27 and 28: Chapter 6: Foreign Types 23 :int64
Page 29 and 30: Chapter 6: Foreign Types 25 (define
Page 31 and 32: Chapter 6: Foreign Types 27 (defmet
Page 33 and 34: Chapter 6: Foreign Types 29 convert
Page 35: Chapter 6: Foreign Types 31 defbitf
Page 39 and 40: Chapter 6: Foreign Types 35 defcuni
Page 41 and 42: Chapter 6: Foreign Types 37 defcenu
Page 43 and 44: Chapter 6: Foreign Types 39 define-
Page 45 and 46: Chapter 6: Foreign Types 41 foreign
Page 55 and 56: Chapter 6: Foreign Types 51 free-tr
Page 57 and 58: Chapter 6: Foreign Types 53 transla
Page 59 and 60: Chapter 6: Foreign Types 55 with-fo
Page 61 and 62: Chapter 7: Pointers 57 7 Pointers A
Page 63 and 64: Chapter 7: Pointers 59 foreign-free
Page 65 and 66: Chapter 7: Pointers 61 CFFI> (mem-r
Page 67 and 68: Chapter 7: Pointers 63 inc-pointer
Page 69 and 70: Chapter 7: Pointers 65 make-pointer
Page 71 and 72: Chapter 7: Pointers 67 mem-aref Syn
Page 73 and 74: Chapter 7: Pointers 69 null-pointer
Page 75 and 76: Chapter 7: Pointers 71 pointerp Syn
Page 77 and 78: Chapter 7: Pointers 73 pointer-eq S
Page 79 and 80: Chapter 7: Pointers 75 with-foreign
Page 81 and 82: Chapter 8: Strings 77 *default-fore
Page 83 and 84: Chapter 8: Strings 79 foreign-strin
Page 85 and 86: Chapter 8: Strings 81 lisp-string-t
Page 87 and 88:
Chapter 8: Strings 83 with-foreign-
Page 89 and 90:
Chapter 9: Variables 85 defcvar Syn
Page 91 and 92:
Chapter 9: Variables 87 get-var-poi
Page 93 and 94:
Chapter 10: Functions 89 defcfun Sy
Page 95 and 96:
Chapter 10: Functions 91 foreign-fu
Page 97 and 98:
Chapter 10: Functions 93 foreign-fu
Page 99 and 100:
Chapter 10: Functions 95 translate-
Page 101 and 102:
Chapter 10: Functions 97 translate-
Page 103 and 104:
Chapter 11: Libraries 99 close-fore
Page 105 and 106:
Chapter 11: Libraries 101 define-fo
Page 107 and 108:
Chapter 11: Libraries 103 *foreign-
Page 109 and 110:
Chapter 11: Libraries 105 load-fore
Page 111 and 112:
Chapter 11: Libraries 107 load-fore
Page 113 and 114:
Chapter 12: Callbacks 109 12 Callba
Page 115 and 116:
Chapter 12: Callbacks 111 defcallba
Page 117 and 118:
Chapter 12: Callbacks 113 get-callb
Page 119 and 120:
Chapter 13: The Groveller 115 The t
Page 121 and 122:
Chapter 13: The Groveller 117 (defp
Page 123 and 124:
Appendix A: Platform-specific featu
Page 125 and 126:
Index 121 Index : :boolean &optiona
Page 127:
Index 123 translate-into-foreign-me
show all

CFFI User Manual - Common Lisp.net

Create successful ePaper yourself

Delete template?

Save as template?