Crate block_sys

Raw bindings to Apple’s C language extension of blocks

The documentation for these bindings is a mix from GNUStep’s and Apple’s sources, but the ABI specification is really the place you should be looking!

See also the README.md for more background information, and for how to configure the desired runtime.

Structs

Block_byref

Structure used for on-stack variables that are referenced by blocks.

Block_byref_extendedapple

Structure used for on-stack variables that are referenced by blocks.

Block_byref_header

Structure used for on-stack variables that are referenced by blocks.

Block_descriptor

Block descriptor that contains copy and dispose operations.

Block_descriptor_basic

Extended block descriptor that does not contain copy and dispose helper functions.

Block_descriptor_header

Block_descriptor_with_signature

Requires BLOCK_HAS_COPY_DISPOSE and BLOCK_HAS_SIGNATURE

Block_layout

Class

Constants

BLOCK_ALL_COPY_DISPOSE_FLAGSapple

BLOCK_BYREF_CALLER

The field is an indirect reference to a variable declared with the __block storage qualifier.

BLOCK_DEALLOCATINGapple

BLOCK_FIELD_IS_BLOCK

The field is a block. This must be copied by the block copy functions.

BLOCK_FIELD_IS_BYREF

The field is an indirect reference to a variable declared with the __block storage qualifier.

BLOCK_FIELD_IS_OBJECT

The value is of some id-like type, and should be copied as an Objective-C object: i.e. by sending -retain or via the GC assign functions in GC mode (not yet supported).

BLOCK_FIELD_IS_WEAK

The field is an indirect reference to a variable declared with the __block storage qualifier.

BLOCK_HAS_COPY_DISPOSE

The block descriptor contains copy and dispose helpers. compiler

BLOCK_HAS_CTOR

The helpers have C++ code. compiler: helpers have C++ code

BLOCK_HAS_EXTENDED_LAYOUTapple

compiler

BLOCK_HAS_SIGNATURE

Block has an Objective-C type encoding. compiler

BLOCK_INLINE_LAYOUT_STRINGapple

compiler

BLOCK_IS_GCapple

compiler

BLOCK_IS_GLOBAL

Block is stored in global memory and does not need to be copied. compiler

BLOCK_IS_NOESCAPEapple

compiler

BLOCK_NEEDS_FREEapple

runtime

BLOCK_REFCOUNT_MASK

BLOCK_SMALL_DESCRIPTORapple

compiler

BLOCK_USE_STRET

Block function uses a calling convention that returns a structure via a pointer passed in by the caller.

Statics

_NSConcreteAutoBlockapple or compiler-rt

_NSConcreteFinalizingBlockapple or compiler-rt

_NSConcreteGlobalBlock

_NSConcreteMallocBlock

_NSConcreteStackBlock

_NSConcreteWeakBlockVariableapple or compiler-rt

Functions

Block_size^⚠apple or compiler-rt

_Block_copy^⚠

_Block_object_assign^⚠

Runtime entry point called by compiler when assigning objects inside copy helper routines

_Block_object_dispose^⚠

runtime entry point called by the compiler when disposing of objects inside dispose helper routine

_Block_release^⚠

Type Definitions

block_assign_dispose_flags

Flags used in the final argument to _Block_object_assign() and _Block_object_dispose(). These indicate the type of copy or dispose to perform. Values for _Block_object_assign() and _Block_object_dispose() parameters

block_flags

Block descriptor flags. Values for Block_layout->flags to describe block objects