1 ;;;; -*- Mode: Lisp; Syntax: ANSI-Common-Lisp; Base: 10; Package: UFFI -*-
2 ;;;; *************************************************************************
3 ;;;; FILE IDENTIFICATION
5 ;;;; Name: strings.lisp
6 ;;;; Purpose: UFFI source to handle strings, cstring and foreigns
7 ;;;; Programmer: Kevin M. Rosenberg
8 ;;;; Date Started: Feb 2002
12 ;;;; This file, part of UFFI, is Copyright (c) 2002 by Kevin M. Rosenberg
14 ;;;; UFFI users are granted the rights to distribute and use this software
15 ;;;; as governed by the terms of the Lisp Lesser GNU Public License
16 ;;;; (http://opensource.franz.com/preamble.html), also known as the LLGPL.
17 ;;;; *************************************************************************
22 (defvar +null-cstring-pointer+
23 #+(or cmu sbcl scl) nil
25 #+lispworks (fli:make-pointer :address 0 :type '(:unsigned :char))
29 (defmacro convert-from-cstring (obj)
30 "Converts a string from a c-call. Same as convert-from-foreign-string, except
31 that LW/CMU automatically converts strings from c-calls."
32 #+(or cmu sbcl lispworks scl) obj
34 (let ((stored (gensym)))
35 `(let ((,stored ,obj))
38 (values (excl:native-to-string ,stored)))))
40 (let ((stored (gensym)))
41 `(let ((,stored ,obj))
42 (if (ccl:%null-ptr-p ,stored)
44 (values (ccl:%get-cstring ,stored)))))
47 (defmacro convert-to-cstring (obj)
48 #+(or cmu sbcl scl lispworks) obj
52 (values (excl:string-to-native ,obj)))
55 +null-cstring-pointer+
56 (let ((ptr (new-ptr (1+ (length ,obj)))))
57 (ccl::%put-cstring ptr ,obj)
61 (defmacro free-cstring (obj)
62 #+(or cmu sbcl scl lispworks) (declare (ignore obj))
65 (ff:free-fobject ,obj))
67 `(unless (ccl:%null-ptr-p ,obj)
71 (defmacro with-cstring ((cstring lisp-string) &body body)
72 #+(or cmu sbcl scl lispworks)
73 `(let ((,cstring ,lisp-string)) ,@body)
75 (let ((acl-native (gensym)))
76 `(excl:with-native-string (,acl-native ,lisp-string)
77 (let ((,cstring (if ,lisp-string ,acl-native 0)))
80 `(if (stringp ,lisp-string)
81 (ccl:with-cstrs ((,cstring ,lisp-string))
83 (let ((,cstring +null-cstring-pointer+))
87 (defmacro with-cstrings (bindings &rest body)
89 `(with-cstring ,(car bindings)
90 (with-cstrings ,(cdr bindings)
94 ;;; Foreign string functions
96 (defmacro convert-to-foreign-string (obj)
99 +null-cstring-pointer+
100 (fli:convert-to-foreign-string ,obj :external-format '(:latin-1 :eol-style :lf)))
104 (values (excl:string-to-native ,obj)))
106 (let ((size (gensym))
111 (alien:sap-alien (system:int-sap 0) (* (alien:unsigned 8))))
113 (let* ((,size (length ,obj))
114 (,storage (alien:make-alien (alien:unsigned 8) (1+ ,size))))
115 (setq ,storage (alien:cast ,storage (* (alien:unsigned 8))))
117 (declare (optimize (speed 3) (safety 0)))
119 (declare (fixnum ,i))
120 (setf (alien:deref ,storage ,i) (char-code (char ,obj ,i))))
121 (setf (alien:deref ,storage ,size) 0))
124 (let ((size (gensym))
129 (sb-alien:sap-alien (sb-sys:int-sap 0) (* (sb-alien:unsigned 8))))
131 (let* ((,size (length ,obj))
132 (,storage (sb-alien:make-alien (sb-alien:unsigned 8) (1+ ,size))))
133 (setq ,storage (sb-alien:cast ,storage (* (sb-alien:unsigned 8))))
135 (declare (optimize (speed 3) (safety 0)))
137 (declare (fixnum ,i))
138 (setf (sb-alien:deref ,storage ,i) (char-code (char ,obj ,i))))
139 (setf (sb-alien:deref ,storage ,size) 0))
143 +null-cstring-pointer+
144 (let ((ptr (new-ptr (1+ (length ,obj)))))
145 (ccl::%put-cstring ptr ,obj)
150 ;; Either length or null-terminated-p must be non-nil
151 (defmacro convert-from-foreign-string (obj &key
154 (null-terminated-p t))
158 (if (eq ,locale :none)
159 (fast-native-to-string ,obj)
160 (excl:native-to-string
162 ,@(when length (list :length length))
163 :truncate (not ,null-terminated-p))))
165 `(if (fli:null-pointer-p ,obj)
167 (if (eq ,locale :none)
168 (fast-native-to-string ,obj)
169 (fli:convert-from-foreign-string
171 ,@(when length (list :length length))
172 :null-terminated-p ,null-terminated-p
173 :external-format '(:latin-1 :eol-style :lf))))
175 `(if (null-pointer-p ,obj)
177 (cmucl-naturalize-cstring (alien:alien-sap ,obj)
179 :null-terminated-p ,null-terminated-p))
181 `(if (null-pointer-p ,obj)
183 (sbcl-naturalize-cstring (sb-alien:alien-sap ,obj)
185 :null-terminated-p ,null-terminated-p))
187 (declare (ignore null-terminated-p))
189 `(if (ccl:%null-ptr-p ,obj)
191 (ccl:%get-cstring ,obj 0 ,@(if length (list length) nil)))
195 (defmacro allocate-foreign-string (size &key (unsigned t))
197 (let ((array-def (gensym)))
198 `(let ((,array-def (list 'alien:array 'c-call:char ,size)))
199 (eval `(alien:cast (alien:make-alien ,,array-def)
201 '(* (alien:unsigned 8))
202 '(* (alien:signed 8)))))))
204 (let ((array-def (gensym)))
205 `(let ((,array-def (list 'sb-alien:array 'char ,size)))
206 (eval `(sb-alien:cast (sb-alien:make-alien ,,array-def)
208 '(* (sb-alien:unsigned 8))
209 '(* (sb-alien:signed 8)))))))
211 `(fli:allocate-foreign-object :type
217 (declare (ignore unsigned))
219 `(ff:allocate-fobject :char :c ,size)
221 (declare (ignore unsigned))
226 (defmacro with-foreign-string ((foreign-string lisp-string) &body body)
227 (let ((result (gensym)))
228 `(let* ((,foreign-string (convert-to-foreign-string ,lisp-string))
229 (,result (progn ,@body)))
230 (declare (dynamic-extent ,foreign-string))
231 (free-foreign-object ,foreign-string)
235 ;; Modified from CMUCL's source to handle non-null terminated strings
237 (defun cmucl-naturalize-cstring (sap &key length (null-terminated-p t))
238 (declare (type system:system-area-pointer sap))
240 (declare (optimize (speed 3) (safety 0)))
241 (let ((null-terminated-length
242 (when null-terminated-p
244 for offset of-type fixnum upfrom 0
245 until (zerop (system:sap-ref-8 sap offset))
246 finally (return offset)))))
248 (if (and null-terminated-length
249 (> (the fixnum length) (the fixnum null-terminated-length)))
250 (setq length null-terminated-length))
251 (setq length null-terminated-length)))
252 (let ((result (make-string length)))
253 (kernel:copy-from-system-area sap 0
254 result (* vm:vector-data-offset
256 (* length vm:byte-bits))
260 ;; kernel:copy-from-system-area doesn't work like it does on CMUCL or SBCL,
261 ;; so have to iteratively copy from sap
262 (defun cmucl-naturalize-cstring (sap &key length (null-terminated-p t))
263 (declare (type system:system-area-pointer sap))
265 (declare (optimize (speed 3) (safety 0)))
266 (let ((null-terminated-length
267 (when null-terminated-p
269 for offset of-type fixnum upfrom 0
270 until (zerop (system:sap-ref-8 sap offset))
271 finally (return offset)))))
273 (if (and null-terminated-length
274 (> (the fixnum length) (the fixnum null-terminated-length)))
275 (setq length null-terminated-length))
276 (setq length null-terminated-length)))
277 (let ((result (make-string length)))
279 (declare (type fixnum i))
280 (setf (char result i) (code-char (system:sap-ref-8 sap i))))
284 (defun sbcl-naturalize-cstring (sap &key length (null-terminated-p t))
285 (declare (type sb-sys:system-area-pointer sap))
287 (declare (optimize (speed 3) (safety 0)))
288 (let ((null-terminated-length
289 (when null-terminated-p
291 for offset of-type fixnum upfrom 0
292 until (zerop (sb-sys:sap-ref-8 sap offset))
293 finally (return offset)))))
295 (if (and null-terminated-length
296 (> (the fixnum length) (the fixnum null-terminated-length)))
297 (setq length null-terminated-length))
298 (setq length null-terminated-length)))
299 (let ((result (make-string length)))
300 (sb-kernel:copy-from-system-area sap 0
301 result (* sb-vm:vector-data-offset
303 (* length sb-vm:n-byte-bits))
307 (def-function "strlen"
308 ((str (* :unsigned-char)))
309 :returning :unsigned-int)
311 (def-type char-ptr-def (* :unsigned-char))
313 #+(or lispworks (and allegro (not ics)))
314 (defun fast-native-to-string (s)
315 (declare (optimize (speed 3) (space 0) (safety 0) (compilation-speed 0))
316 (type char-ptr-def s))
317 (let* ((len (strlen s))
318 (str (make-string len)))
319 (declare (fixnum len)
320 (type (simple-array (signed-byte 8) (*)) str))
322 (setf (aref str i) (uffi:deref-array s '(:array :char) i)))))
325 (defun fast-native-to-string (s)
326 (declare (optimize (speed 3) (space 0) (safety 0) (compilation-speed 0))
327 (type char-ptr-def s))
328 (let* ((len (strlen s))
329 (str (make-string len)))
330 (declare (fixnum len))
332 (setf (schar str i) (ensure-char-character
333 (uffi:deref-array s '(:array :char) i))))))
336 (defun fast-native-to-string (s)
337 (declare (optimize (speed 3) (space 0) (safety 0) (compilation-speed 0) (debug 0))
338 (type char-ptr-def s))
339 (let* ((len (strlen s))
340 (len4 (the fixnum (ash (the fixnum len) -2)))
341 (end4 (the fixnum (ash (the fixnum len4) 2)))
342 (remainder (the fixnum (- len end4)))
343 (str (make-string len))
345 (declare (type fixnum len len4 end4 remainder)
346 (type (simple-array (signed-byte 32) (*)) str4)
347 (type (simple-array (signed-byte 8) (*)) str))
350 (setf (aref str4 i) (uffi:deref-array s '(:array :int) i)))
351 (dotimes (i remainder)
353 (setf (aref str end4) (uffi:deref-array s '(:array :char) end4))