ReQL command: add

Command syntax

value.add(value[, value, ...]) → value
time.add(number[, number, ...]) → time

Description

Sum two or more numbers, or concatenate two or more strings or arrays.

The add command can be called in either prefix or infix form; both forms are equivalent. Note that ReQL will not perform type coercion. You cannot, for example, add a string and a number together.

Example: It’s as easy as 2 + 2 = 4.

> r.expr(2).add(2).run(conn, callback)
// result passed to callback
4

Example: Concatenate strings.

> r.expr("foo").add("bar", "baz").run(conn, callback)
// result passed to callback
"foobarbaz"

Example: Concatenate arrays.

> r.expr(["foo", "bar"]).add(["buzz"]).run(conn, callback)
// result passed to callback
[ "foo", "bar", "buzz" ]

Example: Create a date one year from now.

r.now().add(365*24*60*60).run(conn, callback)

Example: Use args with add to sum multiple values.

> vals = [10, 20, 30];
> r.add(r.args(vals)).run(conn, callback);
// result passed to callback
60

Example: Concatenate an array of strings with args.

> vals = ['foo', 'bar', 'buzz'];
> r.add(r.args(vals)).run(conn, callback);
// result passed to callback
"foobarbuzz"