bracket

ReQL command: bracket

Command syntax

sequence.bracket(attr) → sequence
singleSelection.bracket(attr) → value
object.bracket(attr) → value
array.bracket(index) → value

Description

Get a single field from an object. If called on a sequence, gets that field from every object in the sequence, skipping objects that lack it.

Under most circumstances, you’ll want to use getField (or its shorthand g) or nth rather than bracket. The bracket term may be useful in situations where you are unsure of the data type returned by the term you are calling bracket on.

Example: What was Iron Man’s first appearance in a comic?

r.table("marvel").get("IronMan").bracket("firstAppearance").run(conn);
// more idiomatically:
r.table("marvel").get("IronMan").g("firstAppearance").run(conn);

The bracket command also accepts integer arguments as array offsets, like the nth command.

Example: Get the fourth element in a sequence. (The first element is position 0, so the fourth element is position 3.)

r.expr(r.array(10, 20, 30, 40, 50)).bracket(3).run(conn);
// more idiomatically:
r.expr(r.array(10, 20, 30, 40, 50)).nth(3).run(conn);

40

Related commands

• row
• nth
• getField

Get more help

Couldn't find what you were looking for?

• Ask a question on Stack Overflow
• Chat with us and our community on Slack
• Talk to the team on IRC on #rethinkdb@freenode.net — via Webchat
• Ping @rethinkdb on Twitter
• Post an issue on the documentation issue tracker on GitHub