# `ToInteger`

``Not available in this language, yet.``
``ToInteger( value )``
``ToInteger( value )``
``ToInteger( value )``
``to_integer( 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`

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 `value`s into integers:

``Not available in this language, yet.``
``````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]``