data.md

Data

• data
• json
  • tojson
  • tojsonpretty
  • fromjson
• xml
  • fromxml
• base
  • tobase64
  • frombase64
  • tobase32
  • frombase32
• time
  • sec2span
  • span2sec
  • timestamp
• security
  • nonce
  • digest
  • digesthex

data

The data library provides parsers and converts for various data forms.

local data = require("data");

json

data.tojson( table )

Converts the Lua table to JSON.

tbl = { foo = 123, bar = "hello world" };
json = data.tojson(tbl);

data.tojsonpretty( table )

Converts the Lua table to nicely formatted JSON.

tbl = { foo = 123, bar = "hello world" };
json = data.tojsonpretty(tbl);

data.fromjson( json )

json = "{ \"foo\" = 123, \"bar\" = \"hello world\" }";
tbl = data.fromjson(json);

xml

data.fromxml( xml )

xml = "<foo><bar>hello world</bar></foo>";
root = data.fromxml(xml);

An XML element is represented by an object that looks like this:

{ name = "bar",
  text = "hello world",
  attributes = { ... },
  children = { ... } }

The number of child elements can be retreived like this:

#root.children;

A child element is retreived like this:

root.children[1];

Attributes are retreived like this:

root.attributes["foo"];

base

data.tobase64( data )

Converts the specified data to a base-64 encoded string.

b64str = data.tobase64(...);

data.frombase64( str )

Converts str from a base-64 encoded string.

data = data.frombase64("...");

data.tobase32( data )

Converts the specified data to a base-32 encoded string.

b32str = data.tobase64(...);

data.frombase32( str )

Converts str from a base-32 encoded string.

data = data.frombase32("...");

time

data.sec2span( seconds )

Converts seconds to a time span string with the following format: [HH:]MM:SS.

print(data.sec2span(754)); -- 12:34

data.span2sec( span )

Converts a time span string to the number of seconds that it represents.

print(data.span2sec("12:34")); -- 754

data.timestamp( )

Gets the current UNIX timestamp (milliseconds).

print(data.timestamp()); -- 1424096219

security

data.nonce( )

Generates an unsigned 64-bit integer nonce.

data.nonce();

data.digest( name, data )

Computes the binary hash of the data using the specified digest engine.

Supported engines: MD5, SHA1, SHA256, SHA512, etc. See the OpenSSL documentation for a list of supported digest algorithms.

data.digest("sha1", "foobar");

data.digesthex( name, data )

Computes the hex hash of the data using the specified digest engine.

Supported engines: MD5, SHA1, SHA256, SHA512, etc. See the OpenSSL documentation for a list of supported digest algorithms.

data.digesthex("sha1", "foobar");