On this page:
The Racket Foreign Interface

The Racket Foreign Interface

Eli Barzilay

 (require ffi/unsafe) package: base

The ffi/unsafe library enables the direct use of C-based APIs within Racket programs—without writing any new C code. From the Racket perspective, functions and data with a C-based API are foreign, hence the term foreign interface. Furthermore, since most APIs consist mostly of functions, the foreign interface is sometimes called a foreign function interface, abbreviated FFI.

    1 Overview

      1.1 Libraries, C Types, and Objects

      1.2 Function-Type Bells and Whistles

      1.3 By-Reference Arguments

      1.4 C Structs

      1.5 Pointers and Manual Allocation

      1.6 Pointers and GC-Managed Allocation

      1.7 Reliable Release of Resources

      1.8 Threads and Places

      1.9 More Examples

    2 Loading Foreign Libraries

    3 C Types

      3.1 Type Constructors

      3.2 Numeric Types

      3.3 Other Atomic Types

      3.4 String Types

        3.4.1 Primitive String Types

        3.4.2 Fixed Auto-Converting String Types

        3.4.3 Variable Auto-Converting String Type

        3.4.4 Other String Types

      3.5 Pointer Types

      3.6 Function Types

        3.6.1 Custom Function Types

      3.7 C Struct Types

      3.8 C Array Types

      3.9 C Union Types

      3.10 Enumerations and Masks

    4 Pointer Functions

      4.1 Pointer Dereferencing

      4.2 Memory Management

      4.3 Pointer Structure Property

    5 Derived Utilities

      5.1 Safe Homogenous Vectors

      5.2 Safe C Vectors

      5.3 Tagged C Pointer Types

      5.4 Serializable C Struct Types

      5.5 Defining Bindings

        5.5.1 FFI Identifier Conventions

      5.6 Allocation and Finalization

      5.7 Custodian Shutdown Registration

      5.8 Atomic Execution

      5.9 Speculatively Atomic Execution

      5.10 Thread Scheduling

      5.11 Ports

      5.12 Process-Wide and Place-Wide Registration

      5.13 Objective-C FFI

        5.13.1 FFI Types and Constants

        5.13.2 Syntactic Forms and Procedures

        5.13.3 Raw Runtime Functions

        5.13.4 Legacy Library

      5.14 Cocoa Foundation

        5.14.1 Strings

        5.14.2 Allocation Pools

      5.15 COM (Common Object Model)

        5.15.1 COM Automation

 GUIDs, CLSIDs, IIDs, and ProgIDs

 COM Objects

 COM Methods

 COM Properties

 COM Events

 COM Enumerations

 Interface Pointers

 Remote COM servers (DCOM)

 COM Types

 Class Display Names

        5.15.2 COM Classes and Interfaces

 Describing COM Interfaces

 Obtaining COM Interface References

 COM FFI Helpers

 COM Interface Example

        5.15.3 ActiveX Controls

      5.16 File Security-Guard Checks

      5.17 Windows API Helpers

    6 Miscellaneous Support

    7 Unexported Primitive Functions