5.1 Safe Homogenous Vectors

► |  | FFI: Racket Foreign Interface

1 | Overview
2 | Loading Foreign Libraries
3 | C Types
4 | Pointer Functions
5 | Derived Utilities
6 | Miscellaneous Support
7 | Unexported Primitive Functions
| Index

▼ | 5 | Derived Utilities

5.1 | Safe Homogenous Vectors
5.2 | Safe C Vectors
5.3 | Tagged C Pointer Types
5.4 | Defining Bindings
5.5 | Allocation and Finalization
5.6 | Atomic Execution
5.7 | Speculatively Atomic Execution
5.8 | Objective-C FFI

On this page:

make-u8vector
u8vector
u8vector?
u8vector-length
u8vector-ref
u8vector-set!
list->u8vector
u8vector->list
u8vector->cpointer
_ u8vector
make-s8vector
s8vector
s8vector?
s8vector-length
s8vector-ref
s8vector-set!
list->s8vector
s8vector->list
s8vector->cpointer
_ s8vector
make-s16vector
s16vector
s16vector?
s16vector-length
s16vector-ref
s16vector-set!
list->s16vector
s16vector->list
s16vector->cpointer
_ s16vector
make-u16vector
u16vector
u16vector?
u16vector-length
u16vector-ref
u16vector-set!
list->u16vector
u16vector->list
u16vector->cpointer
_ u16vector
make-s32vector
s32vector
s32vector?
s32vector-length
s32vector-ref
s32vector-set!
list->s32vector
s32vector->list
s32vector->cpointer
_ s32vector
make-u32vector
u32vector
u32vector?
u32vector-length
u32vector-ref
u32vector-set!
list->u32vector
u32vector->list
u32vector->cpointer
_ u32vector
make-s64vector
s64vector
s64vector?
s64vector-length
s64vector-ref
s64vector-set!
list->s64vector
s64vector->list
s64vector->cpointer
_ s64vector
make-u64vector
u64vector
u64vector?
u64vector-length
u64vector-ref
u64vector-set!
list->u64vector
u64vector->list
u64vector->cpointer
_ u64vector
make-f32vector
f32vector
f32vector?
f32vector-length
f32vector-ref
f32vector-set!
list->f32vector
f32vector->list
f32vector->cpointer
_ f32vector
make-f64vector
f64vector
f64vector?
f64vector-length
f64vector-ref
f64vector-set!
list->f64vector
f64vector->list
f64vector->cpointer
_ f64vector

top← prev up next →

#### 5.1`` Safe Homogenous Vectors

( require ffi/vector)

Homogenous vectors are similar to C vectors (see Safe C Vectors), except that they define different types of vectors, each with a hard-wired type.

An exception is the u8 family of bindings, which are just aliases for byte-string bindings: make-u8vector, u8vector. u8vector?, u8vector-length, u8vector-ref, u8vector-set!, list->u8vector, u8vector->list.

( make-u8vector len) → u8vector?
len : exact-nonnegative-integer?
( u8vector val ...) → u8vector?
val : number?
( u8vector? v) → boolean?
v : any/c
( u8vector-length vec) → exact-nonnegative-integer?
vec : u8vector?
( u8vector-ref vec k) → number?
vec : u8vector?
k : exact-nonnegative-integer?
( u8vector-set! vec k val) → void?
vec : u8vector?
k : exact-nonnegative-integer?
val : number?
( list->u8vector lst) → u8vector?
lst : ( listof number?)
( u8vector->list vec) → ( listof number?)
vec : u8vector?
(u8vector->cpointer vec) → cpointer?
vec : u8vector?

Like _cvector, but for vectors of _byte elements. These are aliases for byte operations.

(_u8vector mode maybe-len)
_u8vector

Like _cvector, but for vectors of _uint8 elements.

( make-s8vector len) → s8vector?
len : exact-nonnegative-integer?
( s8vector val ...) → s8vector?
val : number?
( s8vector? v) → boolean?
v : any/c
( s8vector-length vec) → exact-nonnegative-integer?
vec : s8vector?
( s8vector-ref vec k) → number?
vec : s8vector?
k : exact-nonnegative-integer?
( s8vector-set! vec k val) → void?
vec : s8vector?
k : exact-nonnegative-integer?
val : number?
( list->s8vector lst) → s8vector?
lst : ( listof number?)
( s8vector->list vec) → ( listof number?)
vec : s8vector?
( s8vector->cpointer vec) → cpointer?
vec : s8vector?

Like make-vector, etc., but for _int8 elements.

(_s8vector mode maybe-len)
_s8vector

Like _cvector, but for vectors of _int8 elements.

( make-s16vector len) → s16vector?
len : exact-nonnegative-integer?
( s16vector val ...) → s16vector?
val : number?
( s16vector? v) → boolean?
v : any/c
( s16vector-length vec) → exact-nonnegative-integer?
vec : s16vector?
( s16vector-ref vec k) → number?
vec : s16vector?
k : exact-nonnegative-integer?
( s16vector-set! vec k val) → void?
vec : s16vector?
k : exact-nonnegative-integer?
val : number?
( list->s16vector lst) → s16vector?
lst : ( listof number?)
( s16vector->list vec) → ( listof number?)
vec : s16vector?
( s16vector->cpointer vec) → cpointer?
vec : s16vector?

Like make-vector, etc., but for _int16 elements.

(_s16vector mode maybe-len)
_s16vector

Like _cvector, but for vectors of _int16 elements.

( make-u16vector len) → u16vector?
len : exact-nonnegative-integer?
( u16vector val ...) → u16vector?
val : number?
( u16vector? v) → boolean?
v : any/c
( u16vector-length vec) → exact-nonnegative-integer?
vec : u16vector?
( u16vector-ref vec k) → number?
vec : u16vector?
k : exact-nonnegative-integer?
( u16vector-set! vec k val) → void?
vec : u16vector?
k : exact-nonnegative-integer?
val : number?
( list->u16vector lst) → u16vector?
lst : ( listof number?)
( u16vector->list vec) → ( listof number?)
vec : u16vector?
( u16vector->cpointer vec) → cpointer?
vec : u16vector?

Like make-vector, etc., but for _uint16 elements.

(_u16vector mode maybe-len)
_u16vector

Like _cvector, but for vectors of _uint16 elements.

( make-s32vector len) → s32vector?
len : exact-nonnegative-integer?
( s32vector val ...) → s32vector?
val : number?
( s32vector? v) → boolean?
v : any/c
( s32vector-length vec) → exact-nonnegative-integer?
vec : s32vector?
( s32vector-ref vec k) → number?
vec : s32vector?
k : exact-nonnegative-integer?
( s32vector-set! vec k val) → void?
vec : s32vector?
k : exact-nonnegative-integer?
val : number?
( list->s32vector lst) → s32vector?
lst : ( listof number?)
( s32vector->list vec) → ( listof number?)
vec : s32vector?
( s32vector->cpointer vec) → cpointer?
vec : s32vector?

Like make-vector, etc., but for _int32 elements.

(_s32vector mode maybe-len)
_s32vector

Like _cvector, but for vectors of _int32 elements.

( make-u32vector len) → u32vector?
len : exact-nonnegative-integer?
( u32vector val ...) → u32vector?
val : number?
( u32vector? v) → boolean?
v : any/c
( u32vector-length vec) → exact-nonnegative-integer?
vec : u32vector?
( u32vector-ref vec k) → number?
vec : u32vector?
k : exact-nonnegative-integer?
( u32vector-set! vec k val) → void?
vec : u32vector?
k : exact-nonnegative-integer?
val : number?
( list->u32vector lst) → u32vector?
lst : ( listof number?)
( u32vector->list vec) → ( listof number?)
vec : u32vector?
( u32vector->cpointer vec) → cpointer?
vec : u32vector?

Like make-vector, etc., but for _uint32 elements.

(_u32vector mode maybe-len)
_u32vector

Like _cvector, but for vectors of _uint32 elements.

( make-s64vector len) → s64vector?
len : exact-nonnegative-integer?
( s64vector val ...) → s64vector?
val : number?
( s64vector? v) → boolean?
v : any/c
( s64vector-length vec) → exact-nonnegative-integer?
vec : s64vector?
( s64vector-ref vec k) → number?
vec : s64vector?
k : exact-nonnegative-integer?
( s64vector-set! vec k val) → void?
vec : s64vector?
k : exact-nonnegative-integer?
val : number?
( list->s64vector lst) → s64vector?
lst : ( listof number?)
( s64vector->list vec) → ( listof number?)
vec : s64vector?
( s64vector->cpointer vec) → cpointer?
vec : s64vector?

Like make-vector, etc., but for _int64 elements.

(_s64vector mode maybe-len)
_s64vector

Like _cvector, but for vectors of _int64 elements.

( make-u64vector len) → u64vector?
len : exact-nonnegative-integer?
( u64vector val ...) → u64vector?
val : number?
( u64vector? v) → boolean?
v : any/c
( u64vector-length vec) → exact-nonnegative-integer?
vec : u64vector?
( u64vector-ref vec k) → number?
vec : u64vector?
k : exact-nonnegative-integer?
( u64vector-set! vec k val) → void?
vec : u64vector?
k : exact-nonnegative-integer?
val : number?
( list->u64vector lst) → u64vector?
lst : ( listof number?)
( u64vector->list vec) → ( listof number?)
vec : u64vector?
( u64vector->cpointer vec) → cpointer?
vec : u64vector?

Like make-vector, etc., but for _uint64 elements.

(_u64vector mode maybe-len)
_u64vector

Like _cvector, but for vectors of _uint64 elements.

( make-f32vector len) → f32vector?
len : exact-nonnegative-integer?
( f32vector val ...) → f32vector?
val : number?
( f32vector? v) → boolean?
v : any/c
( f32vector-length vec) → exact-nonnegative-integer?
vec : f32vector?
( f32vector-ref vec k) → number?
vec : f32vector?
k : exact-nonnegative-integer?
( f32vector-set! vec k val) → void?
vec : f32vector?
k : exact-nonnegative-integer?
val : number?
( list->f32vector lst) → f32vector?
lst : ( listof number?)
( f32vector->list vec) → ( listof number?)
vec : f32vector?
( f32vector->cpointer vec) → cpointer?
vec : f32vector?

Like make-vector, etc., but for _float elements.

(_f32vector mode maybe-len)
_f32vector

Like _cvector, but for vectors of _float elements.

( make-f64vector len) → f64vector?
len : exact-nonnegative-integer?
( f64vector val ...) → f64vector?
val : number?
( f64vector? v) → boolean?
v : any/c
( f64vector-length vec) → exact-nonnegative-integer?
vec : f64vector?
( f64vector-ref vec k) → number?
vec : f64vector?
k : exact-nonnegative-integer?
( f64vector-set! vec k val) → void?
vec : f64vector?
k : exact-nonnegative-integer?
val : number?
( list->f64vector lst) → f64vector?
lst : ( listof number?)
( f64vector->list vec) → ( listof number?)
vec : f64vector?
( f64vector->cpointer vec) → cpointer?
vec : f64vector?

Like make-vector, etc., but for _double* elements.

(_f64vector mode maybe-len)
_f64vector

Like _cvector, but for vectors of _double* elements.
top← prev up next →