arsd.jsvar

jsvar provides a D type called var that works similarly to the same in Javascript.

It is weakly (even weaker than JS, frequently returning null rather than throwing on an invalid operation) and dynamically typed, but interops pretty easily with D itself:

var a = 10;
a ~= "20";
	assert(a == "1020");

var a = function(int b, int c) { return b+c; };
// note the second set of () is because of broken @property
assert(a()(10,20) == 30);

var a = var.emptyObject;
a.foo = 30;
assert(a["foo"] == 30);

var b = json!q{
	"foo":12,
	"bar":{"hey":[1,2,3,"lol"]}
};

assert(b.bar.hey[1] == 2);
More...

Members

Classes

OverloadSet
class OverloadSet

Does dynamic dispatch to overloads in a jsvar function set.

Functions

wrapNativeObject
WrappedNativeObject wrapNativeObject(Struct* obj)

Wraps a struct by reference. The pointer is stored - be sure the struct doesn't get freed or go out of scope!

wrapNativeObject
WrappedNativeObject wrapNativeObject(Class obj)

Wraps a class. If you are manually managing the memory, remember the jsvar may keep a reference to the object; don't free it!

wrapUfcs
WrappedNativeObject wrapUfcs(Type obj)

Wraps an opaque struct pointer in a module with ufcs functions

Structs

ScriptLocation
struct ScriptLocation
var
struct var

Variables

jsvar_throw
bool jsvar_throw;

Variable to decide if jsvar throws on certain invalid operations or continues on propagating null vars.

Detailed Description

You can also use var.fromJson, a static method, to quickly and easily read json or var.toJson to write it.

Also, if you combine this with my arsd.script module, you get pretty easy interop with a little scripting language that resembles a cross between D and Javascript - just like you can write in D itself using this type.

Please note that function default arguments are NOT likely to work in the script. You'd have to use a helper thing that I haven't written yet. opAssign can never do it because that information is lost when it becomes a pointer. ParamDefault is thus commented out for now.

Properties:

  • note that @property doesn't work right in D, so the opDispatch properties will require double parenthesis to call as functions.
  • Properties inside a var itself are set specially: obj.propName._object = new PropertyPrototype(getter, setter);

D structs can be turned to vars, but it is a copy.

Wrapping D native objects is coming later, the current ways suck. I really needed properties to do them sanely at all, and now I have it. A native wrapped object will also need to be set with _object prolly.

Meta

Authors

Adam D Ruppe

History

Started in July 2013.