ecto_cast_int_to_string v0.1.0 EctoCastIntToString

This module casts an integer into string, to be later saved by Ecto.

Summary

Functions

Casts the given input to the custom type. This callback is called on external input and can return any type, as long as the dump/1 function is able to convert the returned value back into an Ecto native type. There are two situations where this callback is called:

  1. When casting values by Ecto.Changeset
  2. When passing arguments to Ecto.Query

Dumps the given term into an Ecto native type

Loads the given term into a custom type

Returns the underlying schema type for the custom type

Functions

cast(integer)
cast(integer) :: {:ok, String.t} | :error

Casts the given input to the custom type. This callback is called on external input and can return any type, as long as the dump/1 function is able to convert the returned value back into an Ecto native type. There are two situations where this callback is called:

  1. When casting values by Ecto.Changeset
  2. When passing arguments to Ecto.Query

Returns the string representation of an integer. This is a variant of the example given by the Ecto Documentation: https://hexdocs.pm/ecto/Ecto.Type.html#module-example

Examples

iex> EctoCastIntToString.cast(1)
{:ok, "1"}

Usage

defmodule MyModel do
  schema "my_model" do
    field :a_string, EctoCastIntToString

    timestamps()
  end
end
dump(string)

Dumps the given term into an Ecto native type.

This callback is called with any term that was stored in the struct and it needs to validate them and convert it to an Ecto native type.

Callback implementation for Ecto.Type.dump/1.

load(string)

Loads the given term into a custom type.

This callback is called when loading data from the database and receive an Ecto native type. It can return any type, as long as the dump/1 function is able to convert the returned value back into an Ecto native type.

Callback implementation for Ecto.Type.load/1.

type()

Returns the underlying schema type for the custom type.

For example, if you want to provide your own date structures, the type function should return :date.

Note this function is not required to return Ecto primitive types, the type is only required to be known by the adapter.

Callback implementation for Ecto.Type.type/0.