Packages

A library comes as a package: a crossbind port from npm, a crate from crates.io or a Conan package. The project names it in crossbind.config.js and imports it like its own files.

main.js imports SQLite's own header from the @crossbind/port-sqlite3 port, and Version and VersionReq from the semver crate as cargo:semver. A port's header binds only the functions you import.

nlohmann_json, the Conan package, is all C++ templates, with no function of its own to bind. native.cpp includes it, and native.h declares pretty, the one function JavaScript needs.

The playground writes crossbind.config.js from the project's packages; a project of your own lists them there. Libraries has every port, and the guide covers crates.io and Conan.

Try it

Change ^1.2 to >=1.0, <1.4 and run it again. To add another package, open this step in the playground and press Add package.

import {
    initNative, sqlite3_libversion,
} from '@crossbind/port-sqlite3/sqlite3.h';
import { Version, VersionReq } from 'cargo:semver';
import { pretty } from './native/native.h';
 
await initNative();
 
console.log('SQLite', sqlite3_libversion());
 
const wanted = VersionReq.parse('^1.2');
for (const text of ['1.1.0', '1.4.2', '2.0.0']) {
    console.log(text, wanted.matches(Version.parse(text)));
}
 
console.log(pretty('{"name":"crossbind","tags":["c++","rust"]}'));
 
 
import {
    initNative, sqlite3_libversion,
} from '@crossbind/port-sqlite3/sqlite3.h';
import { Version, VersionReq } from 'cargo:semver';
import { pretty } from './native/native.h';

await initNative();

console.log('SQLite', sqlite3_libversion());

const wanted = VersionReq.parse('^1.2');
for (const text of ['1.1.0', '1.4.2', '2.0.0']) {
    console.log(text, wanted.matches(Version.parse(text)));
}

console.log(pretty('{"name":"crossbind","tags":["c++","rust"]}'));

Open in playgroundRuns without a compile until the C++, Rust, packages or imports change.

Console

Press Run, or Ctrl+Enter, to run main.js.

Where to go next

Quick start: crossbind in a project of your own.
C++ bindings: every type, pointers and buffers, constants and memory.
Rust and crates.io: Rust files and crates.
Libraries: ready-made C and C++ libraries, from SQLite to GDAL.
Runtime API, Configuration and CLI: initNative(), crossbind.config.js and the command line.
Playground: every sample, free to change, with more packages.