wcpp

1.2.0 • Public • Published

WCPP

A node module to make writing C/C++ in JavaScript not painful.

Using the power of WebAssebly, wcpp projects run both in node and on the web.

npm i -g wcpp

Installing Emscripten

WCPP comes with an Emscripten installer and will automatically source environment variables upon compile.

$ wcpp-install

A C++ File

// addTwo.cpp 
 
export int addTwo(int a, int b) {
  return a + b;
}

We need export to tell our compiler to make this function available to JavaScript.

To compile all of our C/C++ files to wasm, we enter our project root and run:

$ wcpp

The first time running this command will be a bit slow.

You should see a list of C/C++ files that have been compiled.

Our JavaScript

All we have to do now is require our C++ file the same way we would require a JS file.

require('wcpp')
 
const ourModule = require('./addTwo.cpp')
 
console.log(ourModule.addTwo(2, 3))

If you want to both use wcpp in the web and inculde a lare C++ file, you'll need to use it asynchronously.

We could put this in an anonymous async function:

;(async () => {
  // Require our module
  const addTwo = await require('wcpp')('./addTwo.cpp')
 
  console.log(addTwo(2, 3))
})()

Or use it as a promise:

require('wcpp')('./addTwo.cpp').then(addTwo => {
  console.log(addTwo(2, 3))
})

Use Functions as Modules

We can make our function into a module by naming the function module

// C++ 
 
export int module(int a, int b) {
  return a + b;
}
 
export int timesTwo(int a, int b) { // We can still make other functions 
  return a * b;
}
// JavaScript
 
require('wcpp')
 
const addTwo = await require('./addTwo.cpp')
 
console.log(addTwo(2, 3))
console.log(addTwo.timesTwo(2, 3)) // Our other function

Readme

Keywords

Package Sidebar

Install

npm i wcpp

Weekly Downloads

2

Version

1.2.0

License

MIT

Unpacked Size

11.6 kB

Total Files

9

Last publish

Collaborators

  • brandondyer64