fuzion/sys.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 sys
#
#  Author: Fridtjof Siebert (siebert@tokiwa.software)
#
# -----------------------------------------------------------------------

# fuzion.sys -- unit type to group low-level system APIs
#
module:public sys is


  # Create a 0-terminated internal array of bytes from
  # a given string.
  #
  # This is used to pass strings down to intrinsics
  #
  module c_string (s String) =>
    (s + codepoint 0).utf8.as_array.internal_array.data


  # intrinsic to stop execution signalling a fault of given kind with given message.
  #
  fatal_fault0(kind, msg Array u8) void => intrinsic

  # stop execution signalling a fault of given kind with given message.
  #
  module fatal_fault(# fault kind, e.g. "postcondition"
                     kind String,

                     # fault detail message, depends on kind
                     msg String
                     ) void
  =>
    k := fuzion.sys.c_string kind
    m := fuzion.sys.c_string msg
    fatal_fault0 k m