Packages
localize
0.29.0
1.0.0-rc.4
1.0.0-rc.3
1.0.0-rc.2
1.0.0-rc.1
1.0.0-rc.0
0.50.0
0.49.0
0.48.0
0.47.0
0.46.0
0.45.0
0.44.0
0.41.3
0.41.2
0.41.1
0.41.0
0.40.0
0.39.0
0.38.0
0.37.0
0.36.0
0.35.0
0.34.0
0.33.0
0.32.0
0.31.0
0.30.1
0.30.0
retired
0.29.0
0.28.0
0.27.0
0.26.0
0.25.0
0.24.0
0.23.0
0.22.0
0.21.0
0.20.0
0.19.0
0.18.0
0.16.0
0.15.0
0.14.0
0.13.0
0.12.0
0.11.0
0.10.0
0.9.0
0.8.0
0.7.0
0.6.0
0.5.0
0.4.0
0.3.0
0.2.0
0.1.0
0.1.0-alpha.1
Localization (parsing, formatting) of numbers, dates/time/calendar, units of measure, messages and lists. Includes localized collation.
Current section
Files
Jump to
Current section
Files
lib/localize/utils/helpers.ex
defmodule Localize.Utils.Helpers do
@moduledoc """
General purpose helper functions for Localize.
Provides utility functions for checking empty data structures
and wrapping `:persistent_term` operations.
"""
@doc """
Returns a boolean indicating if a data structure is semantically empty.
### Arguments
* `value` — the value to check. Supported types are lists, maps, and `nil`.
### Returns
* `true` if the value is an empty list, an empty map, or `nil`.
* `false` otherwise.
### Examples
iex> Localize.Utils.Helpers.empty?([])
true
iex> Localize.Utils.Helpers.empty?(%{})
true
iex> Localize.Utils.Helpers.empty?(nil)
true
iex> Localize.Utils.Helpers.empty?([1, 2])
false
iex> Localize.Utils.Helpers.empty?(%{a: 1})
false
"""
def empty?([]), do: true
def empty?(%{} = map) when map == %{}, do: true
def empty?(nil), do: true
def empty?(_), do: false
@doc false
def get_term(key, default) do
:persistent_term.get(key, default)
end
@doc false
def put_term(key, value) do
:persistent_term.put(key, value)
end
@doc """
Converts a string to an existing atom, returning `nil` if the atom
does not already exist in the atom table.
This is the safe alternative to `String.to_existing_atom/1` that
avoids using `try/rescue` as control flow.
### Arguments
* `string` is a binary string.
### Returns
* The atom if it exists, or `nil` otherwise.
"""
@spec existing_atom(String.t()) :: atom() | nil
def existing_atom(string) when is_binary(string) do
:erlang.binary_to_existing_atom(string, :utf8)
rescue
ArgumentError -> nil
end
def existing_atom(_), do: nil
end