Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.0.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Elementary Functions > Floating point > ieee

ieee

sets or gets the floating point exception mode

Syntax

mod = ieee()
ieee(mod)

Arguments

mod

integer scalar whose possible values are 0, 1 or 2

Description

ieee() returns the current floating point exception mode.

0

floating point exception produces an error.

%inf and %nan special values can be used in this mode without error. For instance, %inf/%inf, %inf-%inf or %inf/%nan are known operations.

1
floating point exception produces a warning.
2
floating point exception produces Inf or Nan.

ieee(mod) sets the current floating point exception mode to mod.

The default initial mode is 2. This default value may be set in any of the following ways:
  • Through the Preferences GUI: preferences, in the section General => Environment => ieee.
  • Equivalently, using setPreferencesValue as follows (to set the mode to 1) :

    setPreferencesValue("//general/body/environment", ["fpe";"1"])

  • Or by using ieee(mod) in your startup file.
Floating point exception arising inside some library algorithms are not yet handled by ieee modes.

Examples

ieee(1); 1/0
ieee(2); 1/0, log(0)

See Also

  • %nan — not-a-number
  • %inf — infinity
  • isinf — tests for infinite elements
  • isnan — check for "Not a Number" entries
  • number_properties — determine floating-point parameters

History

VersionDescription
6.0.0 2 is now the initial mode value.
Report an issue
<< frexp Floating point int >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Feb 12 19:26:47 CET 2018