+
Point of view
All features
expanded class REAL_32
Summary
top
Direct parents
Insert list: REAL_GENERAL
Overview
top
Features
Conversions:
{ANY}
{ANY}
  • zero: REAL_32
    Neutral element for "+" and "-".
  • one: REAL_32
    Neutral element for "*" and "/".
  • infix "~=" (other: REAL_32): BOOLEAN
    Is Current near equal to other.
  • hash_code: INTEGER_32
    The hash-code value of Current.
  • mantissa_bits: INTEGER_8
    Give the number of bits, corresponding to the mantissa, in the binary representation of the real number.
  • exponent_bits: INTEGER_8
    Give the number of bits, corresponding to the exponent, in the binary representation of the real number.
{}
{ANY}
Conversions:
{ANY}
  • rounded: REAL_32
    Round to nearest integer away from zero.
  • floor: REAL_32
    Largest integral value no greater than Current.
  • ceiling: REAL_32
    Smallest integral value no smaller than Current.
Object Printing:
{ANY}
Maths functions:
{ANY}
  • sqrt: REAL_32
    Square root of Current.
  • sin: REAL_32
    Sine of Current.
  • cos: REAL_32
    Cosine of Current.
  • tan: REAL_32
    Tangent of Current.
  • asin: REAL_32
    Arc Sine of Current.
  • acos: REAL_32
    Arc Cosine of Current.
  • atan: REAL_32
    Arc Tangent of Current.
  • atan2 (x: REAL_32): REAL_32
    Arc Tangent of Current / x.
  • sinh: REAL_32
    Hyperbolic Sine of Current.
  • cosh: REAL_32
    Hyperbolic Cosine of Current.
  • tanh: REAL_32
    Hyperbolic Tangent of Current.
  • exp: REAL_32
    Exponential of Current.
  • log: REAL_32
    Natural Logarithm of Current.
  • log10: REAL_32
    Base-10 Logarithm of Current.
  • pow (e: REAL_32): REAL_32
    Current raised to the power of e (ANSI C pow).
Miscellaneous:
{ANY}
{}
{ANY}
  • in_range (lower: REAL_32, upper: REAL_32): BOOLEAN
    Return True if Current is in range [lower..upper]
    See also min, max, compare.
  • compare (other: REAL_32): INTEGER_32
    If current object equal to other, 0 if smaller, -1; if greater, 1.
  • three_way_comparison (other: REAL_32): INTEGER_32
    If current object equal to other, 0 if smaller, -1; if greater, 1.
  • min (other: REAL_32): REAL_32
    Minimum of Current and other.
  • max (other: REAL_32): REAL_32
    Maximum of Current and other.
  • bounded_by (a_min: REAL_32, a_max: REAL_32): REAL_32
    A value that is equal to Current if it is between the limits set by a_min and a_max.
{ANY}
  • set_precision (a_precision: INTEGER_8)
    Set the mantissa precision, used by the ~= operator The nearer to 0, the more precise.
{}
to_real_64: REAL_64
effective function
{ANY}
top
Explicit conversion to REAL_64.
ensure
  • Current = Result
to_real_extended: REAL_EXTENDED
effective function
{ANY}
top
Explicit conversion to REAL_EXTENDED.
ensure
  • Current = Result
to_real_80: REAL_EXTENDED
effective function
{ANY}
top
Explicit conversion to REAL_80.
ensure
  • Current = Result
to_real_128: REAL_EXTENDED
effective function
{ANY}
top
Explicit conversion to REAL_128.
ensure
  • Current = Result
force_to_integer_64: INTEGER_64
{ANY}
top
force_to_integer_32: INTEGER_32
{ANY}
top
force_to_integer_16: INTEGER_16
{ANY}
top
force_to_natural_64: NATURAL_64
{ANY}
top
force_to_natural_32: NATURAL_32
{ANY}
top
force_to_natural_16: NATURAL_16
{ANY}
top
zero: REAL_32
is {REAL_32 0.0}
constant attribute
{ANY}
top
Neutral element for "+" and "-".
one: REAL_32
is {REAL_32 1.0}
constant attribute
{ANY}
top
Neutral element for "*" and "/".
infix "~=" (other: REAL_32): BOOLEAN
effective function
{ANY}
top
Is Current near equal to other.
hash_code: INTEGER_32
effective function
{ANY}
top
The hash-code value of Current.
ensure
  • good_hash_value: Result >= 0
mantissa_bits: INTEGER_8
is 23
constant attribute
{ANY}
top
Give the number of bits, corresponding to the mantissa, in the binary representation of the real number.
exponent_bits: INTEGER_8
is 8
constant attribute
{ANY}
top
Give the number of bits, corresponding to the exponent, in the binary representation of the real number.
sprintf (buffer: NATIVE_ARRAY[CHARACTER], mode: CHARACTER, f: INTEGER_32, value: REAL_64)
{}
top
Put in the buffer a viewable version of the value using mode with f digits for the fractional part.
Assume the buffer is large enough.
require
  • mode = 'f' xor mode = 'e'
  • f >= 0
is_equal (other: REAL_32): BOOLEAN
effective function
{ANY}
top
Is other attached to an object considered equal to current object?
require
    • other /= Void
      • other /= Void
      • other /= Void
ensure
  • commutative: generating_type = other.generating_type implies Result = other.is_equal(Current)
  • trichotomy: Result = not Current < other and not other < Current
  • Result implies hash_code = other.hash_code
prefix "+": REAL_32
effective function
{ANY}
top
Unary plus of Current.
prefix "-": REAL_32
{ANY}
top
Unary minus of Current.
infix "+" (other: REAL_32): REAL_32
{ANY}
top
Sum with other (commutative).
infix "-" (other: REAL_32): REAL_32
{ANY}
top
Result of subtracting other.
infix "*" (other: REAL_32): REAL_32
{ANY}
top
Product by other.
infix "/" (other: REAL_32): REAL_32
{ANY}
top
Division by other.
require
  • other /= Void
  • other /= zero
  • divisible(other)
infix "^" (e: INTEGER_32): REAL_32
{ANY}
top
Raise Current to e-th power (see also pow).
infix "<" (other: REAL_32): BOOLEAN
{ANY}
top
Is Current strictly less than other?
See also >, <=, >=, min, max.
require
  • other_exists: other /= Void
ensure
  • asymmetric: Result implies not other < Current
infix "<=" (other: REAL_32): BOOLEAN
{ANY}
top
Is Current less than or equal other?
See also >=, <, >, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = Current < other or is_equal(other)
infix ">" (other: REAL_32): BOOLEAN
{ANY}
top
Is Current strictly greater than other?
See also <, >=, <=, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = other < Current
infix ">=" (other: REAL_32): BOOLEAN
{ANY}
top
Is Current greater than or equal than other?
See also <=, >, <, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = other <= Current
abs: REAL_32
effective function
{ANY}
top
is_not_a_number: BOOLEAN
{ANY}
top
Also known as NaN in IEEE-754.
is_infinity: BOOLEAN
{ANY}
top
Is either plus or minus infinity?
is_zero: BOOLEAN
effective function
{ANY}
top
Is either -0.0 or +0.0 ?
ensure
  • definition: Result = Current = zero or else Current = - zero
precision: INTEGER_8
effective function
{ANY}
top
ensure
is_subnormal: BOOLEAN
{ANY}
top
Is it too small to be represented in normalized format.
ensure
  • Result = Current = zero or else Current = - zero
is_normal: BOOLEAN
{ANY}
top
The most general situation (see ensure).
ensure
  • Result = not is_subnormal or is_infinity or is_not_a_number
divisible (other: REAL_32): BOOLEAN
effective function
{ANY}
top
May Current be divided by other ?
require
  • other /= Void
rounded: REAL_32
frozen
{ANY}
top
Round to nearest integer away from zero.
floor: REAL_32
frozen
{ANY}
top
Largest integral value no greater than Current.
ceiling: REAL_32
frozen
{ANY}
top
Smallest integral value no smaller than Current.
to_string: STRING
effective function
{ANY}
top
Convert Current into a new allocated STRING using 6 as the default number of digits for the fractional part.
Example: (1.5).to_string will return "1.500000".
Note: see also to_string_format, to_string_scientific as well as append_in to save memory.
to_string_format (f: INTEGER_32): STRING
effective function
{ANY}
top
Convert Current into a new allocated STRING using f digits for fractional part.
Example: (1.5).to_string_format(2) will return "1.50".
Note: see also to_string_scientific, to_string as well as append_in_format to save memory.
require
  • f >= 0
to_string_scientific (f: INTEGER_32): STRING
effective function
{ANY}
top
Convert Current into a new allocated STRING, using the scientific notation with f digits for the fractional part.
Example: (155.5).to_string_scientific(4) will return "1.5550e+02".
Note: see also to_string, to_string_format as well as append_in_scientific to save memory.
append_in (buffer: STRING)
effective procedure
{ANY}
top
Append the equivalent of to_string at the end of buffer.
Thus you can save memory because no other STRING is allocated for the job.
require
  • buffer /= Void
append_in_format (str: STRING, f: INTEGER_32)
effective procedure
{ANY}
top
Append the equivalent of to_string_format at the end of buffer.
Thus you can save memory because no other STRING is allocated for the job.
require
  • str /= Void
  • f >= 0
append_in_scientific (str: STRING, f: INTEGER_32)
effective procedure
{ANY}
top
Append the equivalent of to_string_scientific at the end of buffer.
Thus you can save memory because no other STRING is allocated for the job.
require
  • str /= Void
  • f >= 0
out_in_tagged_out_memory
effective procedure
{ANY}
top
Append terse printable representation of current object in tagged_out_memory.
require
    • locked: tagged_out_locked
      • locked: tagged_out_locked
      • locked: tagged_out_locked
ensure
  • still_locked: tagged_out_locked
  • not_cleared: tagged_out_memory.count >= old tagged_out_memory.count
  • append_only: old tagged_out_memory.twin.is_equal(tagged_out_memory.substring(1, old tagged_out_memory.count))
fill_tagged_out_memory
effective procedure
{ANY}
top
Append a viewable information in tagged_out_memory in order to affect the behavior of out, tagged_out, etc.
require
    • locked: tagged_out_locked
      • locked: tagged_out_locked
      • locked: tagged_out_locked
ensure
  • still_locked: tagged_out_locked
sqrt: REAL_32
frozen
{ANY}
top
Square root of Current.
require
  • Current >= zero
sin: REAL_32
frozen
{ANY}
top
Sine of Current.
cos: REAL_32
frozen
{ANY}
top
Cosine of Current.
tan: REAL_32
frozen
{ANY}
top
Tangent of Current.
asin: REAL_32
frozen
{ANY}
top
Arc Sine of Current.
acos: REAL_32
frozen
{ANY}
top
Arc Cosine of Current.
atan: REAL_32
frozen
{ANY}
top
Arc Tangent of Current.
atan2 (x: REAL_32): REAL_32
frozen
{ANY}
top
Arc Tangent of Current / x.
sinh: REAL_32
frozen
{ANY}
top
Hyperbolic Sine of Current.
cosh: REAL_32
frozen
{ANY}
top
Hyperbolic Cosine of Current.
tanh: REAL_32
frozen
{ANY}
top
Hyperbolic Tangent of Current.
exp: REAL_32
frozen
{ANY}
top
Exponential of Current.
log: REAL_32
frozen
{ANY}
top
Natural Logarithm of Current.
log10: REAL_32
frozen
{ANY}
top
Base-10 Logarithm of Current.
pow (e: REAL_32): REAL_32
frozen
{ANY}
top
Current raised to the power of e (ANSI C pow).
sign: INTEGER_8
effective function
{ANY}
top
Sign of Current (0 -1 or 1).
ensure
  • Result.in_range(-1, 1)
sprintf_buffer: NATIVE_ARRAY[CHARACTER]
once function
{}
top
in_range (lower: REAL_32, upper: REAL_32): BOOLEAN
effective function
{ANY}
top
Return True if Current is in range [lower..upper]
See also min, max, compare.
ensure
  • Result = Current >= lower and Current <= upper
compare (other: REAL_32): INTEGER_32
effective function
{ANY}
top
If current object equal to other, 0 if smaller, -1; if greater, 1.
See also min, max, in_range.
require
  • other_exists: other /= Void
ensure
  • equal_zero: Result = 0 = is_equal(other)
  • smaller_negative: Result = -1 = Current < other
  • greater_positive: Result = 1 = Current > other
three_way_comparison (other: REAL_32): INTEGER_32
effective function
{ANY}
top
If current object equal to other, 0 if smaller, -1; if greater, 1.
See also min, max, in_range.
require
  • other_exists: other /= Void
ensure
  • equal_zero: Result = 0 = is_equal(other)
  • smaller_negative: Result = -1 = Current < other
  • greater_positive: Result = 1 = Current > other
min (other: REAL_32): REAL_32
effective function
{ANY}
top
Minimum of Current and other.
See also max, in_range.
require
  • other /= Void
ensure
  • Result <= Current and then Result <= other
  • compare(Result) = 0 or else other.compare(Result) = 0
max (other: REAL_32): REAL_32
effective function
{ANY}
top
Maximum of Current and other.
See also min, in_range.
require
  • other /= Void
ensure
  • Result >= Current and then Result >= other
  • compare(Result) = 0 or else other.compare(Result) = 0
bounded_by (a_min: REAL_32, a_max: REAL_32): REAL_32
effective function
{ANY}
top
A value that is equal to Current if it is between the limits set by a_min and a_max.
Otherwise it's a_min if Current is smaller or a_max if Current is greater It's a shortcut for Current.min(a_max).max(a_min) also known as "clamp" in the widespread C library Glib
ensure
  • correctness: Result.in_range(a_min, a_max)
set_precision (a_precision: INTEGER_8)
effective procedure
{ANY}
top
Set the mantissa precision, used by the ~= operator The nearer to 0, the more precise.
require
  • a_precision >= 0
ensure
precision_ref: REFERENCE[INTEGER_8]
once function
{}
top