gleam/erlang

Types

Crash

pub type Crash {
  Exited(Dynamic)
  Thrown(Dynamic)
  Errored(Dynamic)
}

Constructors

```
Exited(Dynamic)
```
```
Thrown(Dynamic)
```
```
Errored(Dynamic)
```

EnsureAllStartedError

</>

pub type EnsureAllStartedError {
  UnknownApplication(name: Atom)
  ApplicationFailedToStart(name: Atom, reason: Dynamic)
}

Constructors

```
UnknownApplication(name: Atom)
```

ApplicationFailedToStart(name: Atom, reason: Dynamic)

Reference

</>

A unique reference value.

It holds no particular meaning or value, but unique values are often useful in programs are used heavily within both Gleam and Erlang’s OTP frameworks.

More can be read about refernces in the Erlang documentation.

pub external type Reference

TimeUnit

</>

pub type TimeUnit {
  Second
  Millisecond
  Microsecond
  Nanosecond
}

Constructors

```
Second
```
```
Millisecond
```
```
Microsecond
```
```
Nanosecond
```

Functions

binary_to_term

</>

pub fn binary_to_term(binary: BitString) -> Result(Dynamic, Nil)

ensure_all_started

</>

pub external fn ensure_all_started(
  application: Atom,
) -> Result(List(Atom), EnsureAllStartedError)

Starts an OTP application’s process tree in the background, as well as the trees of any applications that the given application depends upon. An OTP application typically maps onto a Gleam or Hex package.

Returns a list of the applications that were started. Calling this function for application that have already been started is a no-op so you do not need to check the application state beforehand.

In Gleam we prefer to not use these implicit background process trees, but you will likely still need to start the trees of OTP applications written in other BEAM languages such as Erlang or Elixir, including those included by default with Erlang/OTP.

For more information see the OTP documentation.

erlang_timestamp

</>

pub external fn erlang_timestamp() -> #(Int, Int, Int)

Returns the current OS system time as a tuple of Ints

http://erlang.org/doc/man/os.html#timestamp-0

format

</>

pub fn format(term: a) -> String

Return a string representation of any term

get_line

</>

pub external fn get_line(
  prompt: String,
) -> Result(String, GetLineError)

Reads a line from standard input with the given prompt.

Example

> get_line("Language: ")
// -> Language: <- gleam
Ok("gleam\n")

make_reference

</>

pub external fn make_reference() -> Reference

Create a new unique reference.

rescue

</>

pub external fn rescue(fn() -> a) -> Result(a, Crash)

Gleam doesn’t offer any way to raise exceptions, but they may still occur due to bugs when working with unsafe code, such as when calling Erlang function.

This function will catch any error thrown and convert it into a result rather than crashing the process.

start_arguments

</>

pub fn start_arguments() -> List(String)

Get the arguments given to the program when it was started.

This is sometimes called argv in other languages.

system_time

</>

pub external fn system_time(TimeUnit) -> Int

Returns the current OS system time.

https://erlang.org/doc/apps/erts/time_correction.html#OS_System_Time

term_to_binary

</>

pub external fn term_to_binary(a) -> BitString

unsafe_binary_to_term

</>

pub fn unsafe_binary_to_term(binary: BitString) -> Result(
  Dynamic,
  Nil,
)