Skip to content
A cross-platform betterC compatible shared library loader for D bindings
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

RiverD Loader

A cross-platform betterC compatible shared library loader for D bindings

RiverD is a project to create static and dynamic binds to all C libraries. The intent is to make a standard loader and allow users to use or not -betterC, @nogc or even nothrow.

Use RiverD

How to create a RiverD bind

At the moment, our mixin builder don't support -betterC, so you need to make it manually (D compilers can't evaluate CTFE with GC dependent code using -betterC).

Using RiverD builder, you need to specify a types module containing all the types to be used on your C functions, a dynfun module containing __gshared symbols and import to types (for function types), a dynload module containing the import of dynfun module and this piece of code:


Additionally, you have statfun module for static linkage support containing extern(C) functions declarations.

Using RiverD loader manually you can adapt this code for dynload module:

void* dylib_load_libname() {
	void* handle = dylib_load("");
	if(handle is null) return null;

	dylib_bindSymbol(handle, cast(void**)&libname_symbol, "libname_symbol"); //make this for every function symbol

	return handle;

How to load/unload a bind

void* libname_handle = dylib_load_libname(); // load
dylib_unload(libname_handle); // unload
bool loaded = dylib_is_loaded(libname_handle); // isloaded

How to contribute

Check out our wiki.


GNU Lesser General Public License (Version 3, 29 June 2007)

Made with ❤ by a bunch of geeks

License Discord Server

You can’t perform that action at this time.