lisp-string-to-foreign

Syntax

Arguments and Values

string-or-ub8-array

A Lisp string or a Lisp (unsigned-byte 8) array.

ptr

A foreign pointer.

size

An integer.

Description

The lisp-string-to-foreign function copies at most size-1 characters from a Lisp string or (unsigned-byte 8) arrayto ptr. The foreign string will be null-terminated.

Examples

  CFFI> (with-foreign-pointer-as-string (str 255)
          (lisp-string-to-foreign "Hello, foreign world!" str 6))
  => "Hello"
   
  CFFI> (with-foreign-pointer-as-string (str 255)
          (lisp-string-to-foreign
           (make-array 6 :element-type '(unsigned-byte 8)
                       :initial-contents '(65 66 67 68 69 60))
           str 4))
  => "ABC"

See Also

foreign-string-alloc
foreign-string-to-lisp
with-foreign-pointer-as-string