ToInteger

ToInteger( value )
ToInteger( value )
ToInteger( value )
ToInteger( value )
to_integer( value )
ToInteger( value )
ToInteger( value )

Description

The ToInteger function converts a value to a numeric integer, if possible.

Attempting to convert a value to a number which has no numeric representation results in an "invalid argument" error.

Parameters

Argument Type Definition and Requirements

value

Any

The value to attempt to convert to an Integer.

Returns

An Integer that corresponds to value.

Examples

The following query uses ToInteger multiple times to demonstrate how the function converts various kinds of values into integers:

try
{
    Value result = await client.Query(
        Arr(
            ToInteger(1234.5678),
            ToInteger(1234),
            ToInteger("123")
        )
    );

    Console.WriteLine(result);
}
catch (Exception e)
{
    Console.WriteLine($"ERROR: {e.Message}");
}
Arr(LongV(1234), LongV(1234), LongV(123))
result, err := client.Query(
	f.Arr{
		f.ToInteger(1234.5678),
		f.ToInteger(1234),
		f.ToInteger("123"),
	})

if err != nil {
	fmt.Fprintln(os.Stderr, err)
} else {
	fmt.Println(result)
}
[1234 1234 123]
System.out.println(
    client.query(
        Arr(
            ToInteger(Value(1234.5678)),
            ToInteger(Value(1234)),
            ToInteger(Value("123"))
        )
    ).get());
[1234, 1234, 123]
client.query(
  [
    q.ToInteger(1234.5678),
    q.ToInteger(1234),
    q.ToInteger('123'),
  ]
)
.then((ret) => console.log(ret))
.catch((err) => console.error('Error: %s', err))
[ 1234, 1234, 123 ]
result = client.query(
  [
    q.to_integer(1234.5678),
    q.to_integer(1234),
    q.to_integer('123'),
  ]
)
print(result)
[1234, 1234, 123]
try {
  println(Await.result(
  client.query(
    Arr(
      ToInteger(1234.5678),
      ToInteger(1234),
      ToInteger("123")
    )
  ),
  5.seconds
))} catch {
  case unknown: Throwable => println("Error: " + unknown.getMessage())
}
[1234, 1234, 123]
[
  ToInteger(1234.5678),
  ToInteger(1234),
  ToInteger('123'),
]
[ 1234, 1234, 123 ]

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve!
Visit Fauna's Discourse forums or email docs@fauna.com

Thank you for your feedback!