unique_id.fz

# This file is part of the Fuzion language implementation.
#
# The Fuzion language implementation is free software: you can redistribute it
# and/or modify it under the terms of the GNU General Public License as published
# by the Free Software Foundation, version 3 of the License.
#
# The Fuzion language implementation is distributed in the hope that it will be
# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
# License for more details.
#
# You should have received a copy of the GNU General Public License along with The
# Fuzion language implementation.  If not, see <https://www.gnu.org/licenses/>.


# -----------------------------------------------------------------------
#
#  Tokiwa Software GmbH, Germany
#
#  Source code of Fuzion standard library feature unique_id
#
# -----------------------------------------------------------------------

# unique_id -- effect that generates a unique id
#
public unique_id (p Unique_Id_Handler) : simple_effect
is

  public get => replace; p.get

  type.install_default =>
    (unique_id default_handler).default

  # default handler using
  # fuzion.sys.misc.unique_id to get unique id
  #
  type.default_handler : Unique_Id_Handler is
    get => fuzion.sys.misc.unique_id


public Unique_Id_Handler ref is
  public get u64 => abstract


# get a unique id > 0
#
# this can be used to add a unique identifier to compare instances.
#
# sine there are 2^64-1 possible values, you can safely assume that these are
# in fact unique.  Assuming one unique id is consumed every nanosecond, it
# would take more than 500 years before we run out of values
# (2^64/10^9/3600/24/365.25).
#
public unique_id =>
  unique_id.install_default
  unique_id.env.get