ContainsField

ContainsField( field, in )
ContainsField( field, in )
ContainsField( field, in )
ContainsField( field, in )
contains_field( field, in )
ContainsField( field, in )

Description

The ContainsField function returns true if the specified field exists within the result of the in expression, or false otherwise.

ContainsField is useful when you need to distinguish between objects, arrays, or documents that contain a field and those that do not.

Parameters

Argument Type Definition and Requirements

field

String

The name of a field.

in

Any

A value of any type.

Returns

A boolean value indicates whether field exists within in.

Examples

The following query returns true because the field a exists in the provided object:

Value result = await client.Query(
    ContainsField(
        "a",
        Obj(
            "a", 1,
            "b", 2,
            "c", 3
        )
    )
);

Console.WriteLine(result);
true
result, err := client.Query(
	f.ContainsField(
		"a",
		f.Obj{
			"a": 1,
			"b": 2,
			"c": 3 }))

if (err != nil) {
	fmt.Println(err)
} else {
	fmt.Println(result)
}
true
System.out.println(
    client.query(
        ContainsField(
            Value("a"),
            Obj(
                "a", Value(1),
                "b", Value(2),
                "c", Value(3)
            )
        )
    )
    .get());
true
client.query(
  q.ContainsField(
    'a',
    {
      'a': 1,
      'b': 2,
      'c': 3
    },
  )
)
.then((ret) => console.log(ret))
.catch((err) => console.log('Error:', err))
true
print(client.query(
  q.contains_field(
    "a",
    {
      "a": 1,
      "b": 2,
      "c": 3
    }
  )
))
True
println(Await.result(
    client.query(
        ContainsField(
            "a",
            Obj(
                "a" -> 1,
                "b" -> 2,
                "c" -> 3
            )
        )
    ),
    5.seconds
))
true

The following query returns false because the field f does not exist in the provided object:

Value result = await client.Query(
    ContainsField(
        "f",
        Obj(
            "a", 1,
            "b", 2,
            "c", 3
        )
    )
);

Console.WriteLine(result);
false
result, err := client.Query(
	f.ContainsField(
		"f",
		f.Obj{
			"a": 1,
			"b": 2,
			"c": 3 }))

if (err != nil) {
	fmt.Println(err)
} else {
	fmt.Println(result)
}
false
System.out.println(
    client.query(
        ContainsField(
            Value("f"),
            Obj(
                "a", Value(1),
                "b", Value(2),
                "c", Value(3)
            )
        )
    )
    .get());
false
client.query(
  q.ContainsField(
    'f',
    {
      'a': 1,
      'b': 2,
      'c': 3
    },
  )
)
.then((ret) => console.log(ret))
.catch((err) => console.log('Error:', err))
false
print(client.query(
  q.contains_field(
    "f",
    {
      "a": 1,
      "b": 2,
      "c": 3
    }
  )
))
False
println(Await.result(
    client.query(
        ContainsField(
            "f",
            Obj(
                "a" -> 1,
                "b" -> 2,
                "c" -> 3
            )
        )
    ),
    5.seconds
))
false

Is this article helpful? 

Tell Fauna how the article can be improved:
 Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!