Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

ref-union

TooTallNate211MIT1.0.1TypeScript support: definitely-typed

Create ABI-compliant "union" instances on top of Buffers

union, ref, abi, c, c++, ffi

readme

ref-union

Create ABI-compliant "union" instances on top of Buffers

Build Status Build Status

Installation

Install with npm:

$ npm install ref-union

Examples

var ref = require('ref')
var Union = require('ref-union')

// a couple typedefs
var int = ref.types.int
var float = ref.types.float
var string = ref.types.CString

// define a Union type with 3 data fields
var u_tag = new Union({
    ival: int
  , fval: float
  , sval: string
})

// the size of the union matches the largest data type in the union type
u_tag.size === string.size

// and you can create new instances of the union type
var tag = new u_tag
tag.ival = 5

License

(The MIT License)

Copyright (c) 2012 Nathan Rajlich <nathan@tootallnate.net>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

changelog

1.0.1 / 2015-12-27

  • test node v5
  • package: more lenient "bindings" version
  • package: add "license" field
  • package: add a few more keywords
  • README: use SVG for AppVeyor badge

1.0.0 / 2015-10-02

  • bumping to v1.0.0 for better-defined semver semantics

0.0.4 / 2015-10-02

  • moar tests
  • update deps and tests for nan v2 / node.js v4

0.0.3 / 2014-06-19

  • package: update all dependencies
  • test: nan-ify native tests
  • package: loosely pin deps
  • README: add appveyor build badge
  • README: use svg for Travis badge
  • travis: test node v0.8, v0.10, and v0.11
  • add appveyor.yml file
  • pacakge: remove "engines" field
  • package: beautify
  • rename the backing buffer property to "ref.buffer"
  • move the exports to the top
  • test: yet another test
  • test: add another native test
  • test: add a couple more native tests
  • test: use "node-bindings" to load the test native bindings