Building Blocks

Basic Queries

Nested Structures

Data Mutations

Advanced EdgeQL

EdgeQL Tutorial

Scalars

Subtopics

EdgeQL Tutorial

Scalars

Tuples, like arrays, are ordered collections of scalar values, but the elements don't have to be the same type.

Input

Run

select (1, "Hello", true);

select (1, "Hello", true);

Output Objects

Press the 'Run' button to evaluate the input

In fact, tuple elements can be values of any type including arrays and other tuples:

Input

Run

select (1, "Hello", true, (0, "Ciao", false), [1, 2, 3]);

select (1, "Hello", true, (0, "Ciao", false), [1, 2, 3]);

Output Objects

Press the 'Run' button to evaluate the input

Tuple elements can be accessed by specifying an index after a .:

Input

Run

select (1, "Hello", true).0;

select (1, "Hello", true).0;

Output Objects

Press the 'Run' button to evaluate the input

This works for nested tuples too:

Input

Run

select (1, "Hello", true, (0, "Ciao", false)).3.1;

select (1, "Hello", true, (0, "Ciao", false)).3.1;

Output Objects

Press the 'Run' button to evaluate the input

Tuples can also give names to their elements. In that case the tuple elements can be accessed by either name or index:

Input

Run

select (val := 1, text := "Hello", flag := true);

select (val := 1, text := "Hello", flag := true);

Output Objects

Press the 'Run' button to evaluate the input

Input

Run

# access by name
select (val := 1, text := "Hello", flag := true).text;

# access by name
select (val := 1, text := "Hello", flag := true).text;

Output Objects

Press the 'Run' button to evaluate the input

Input

Run

# access by index
select (val := 1, text := "Hello", flag := true).1;

# access by index
select (val := 1, text := "Hello", flag := true).1;

Output Objects

Press the 'Run' button to evaluate the input

Naming elements can make nested tuples quite readable:

Input

Run

select 
(
 english := (hello := "Hello", bye := "Bye"), 
 italian := (hello := "Ciao",  bye := "Ciao"),
 korean  := (hello := "안녕",  bye := "안녕")
 )
.italian.hello;

select 
(
 english := (hello := "Hello", bye := "Bye"), 
 italian := (hello := "Ciao",  bye := "Ciao"),
 korean  := (hello := "안녕",  bye := "안녕")
 )
.italian.hello;

Output Objects

Press the 'Run' button to evaluate the input

You can also use casts to change the type of the elements inside tuples by using a "nested" cast notation:

Input

Run

select <tuple<str, str, bool>>(1, "Hello", "true");

select <tuple<str, str, bool>>(1, "Hello", "true");

Output Objects

Press the 'Run' button to evaluate the input

Prev Next

We use ChatGPT with additional context from our documentation to answer your questions. Not all answers will be accurate. Please join our Discord if you need more help.