rbs 3.6.1 → 3.9.5

data/core/file.rbs

@@ -49,7 +49,6 @@
 # *   May also contain a 1-character [file-create
 #     mode](rdoc-ref:File@File-Create+Mode).
 #
-#
 # #### Read/Write Mode
 #
 # The read/write `mode` determines:
@@ -61,14 +60,11 @@
 #     *   The initial read position in the file.
 #     *   Where in the file reading can occur.
 #
-#
 # *   Whether writing is allowed, and if so:
 #
 #     *   The initial write position in the file.
 #     *   Where in the file writing can occur.
 #
-#
-#
 # These tables summarize:
 #
 #     Read/Write Modes for Existing File
@@ -110,7 +106,6 @@
 # *   `Error` means that an exception is raised if disallowed reading or writing
 #     is attempted.
 #
-#
 # ##### Read/Write Modes for Existing File
 #
 # *   `'r'`:
@@ -142,7 +137,6 @@
 #
 #             f.write('foo') # Raises IOError.
 #
-#
 # *   `'w'`:
 #
 #     *   File is initially truncated:
@@ -197,7 +191,6 @@
 #
 #             f.read # Raises IOError.
 #
-#
 # *   `'a'`:
 #
 #     *   File is not initially truncated:
@@ -230,7 +223,6 @@
 #
 #             f.read # Raises IOError.
 #
-#
 # *   `'r+'`:
 #
 #     *   File is not initially truncated:
@@ -286,7 +278,6 @@
 #             File.read(path)
 #             # => "WWWst lineXXXecond line\nFourth line\nFifth YYYe\n\u0000\u0000ZZZ"
 #
-#
 # *   `'a+'`:
 #
 #     *   File is not initially truncated:
@@ -326,8 +317,6 @@
 #             f.seek(-3, :END)
 #             f.read # => "bat"
 #
-#
-#
 # ##### Read/Write Modes for File To Be Created
 #
 # Note that modes `'r'` and `'r+'` are not allowed for a non-existent file
@@ -383,7 +372,6 @@
 #
 #             f.read # Raises IOError.
 #
-#
 # *   `'a'`:
 #
 #     *   File's initial write position is 0:
@@ -411,7 +399,6 @@
 #
 #             f.read # Raises IOError.
 #
-#
 # *   `'w+'`:
 #
 #     *   File's initial position is 0:
@@ -476,7 +463,6 @@
 #             f.read
 #             # => "bah"
 #
-#
 # *   `'a+'`:
 #
 #     *   File's initial write position is 0:
@@ -515,8 +501,6 @@
 #             f.pos = 800
 #             f.read # => ""
 #
-#
-#
 # #### Data Mode
 #
 # To specify whether data is to be treated as text or as binary data, either of
@@ -529,7 +513,6 @@
 #     `Encoding::ASCII_8BIT`; on Windows, suppresses conversion between EOL and
 #     CRLF and disables interpreting `0x1A` as an end-of-file marker.
 #
-#
 # If neither is given, the stream defaults to text data.
 #
 # Examples:
@@ -550,7 +533,6 @@
 # *   `'x'`: Creates the file if it does not exist; raises an exception if the
 #     file exists.
 #
-#
 # Example:
 #
 #     File.new('t.tmp', 'wx')
@@ -571,7 +553,6 @@
 # *   `File::RDWR`: Open for reading and writing.
 # *   `File::APPEND`: Open for appending only.
 #
-#
 # Examples:
 #
 #     File.new('t.txt', File::RDONLY)
@@ -588,7 +569,6 @@
 # *   `File::EXCL`: Raise an exception if `File::CREAT` is given and the file
 #     exists.
 #
-#
 # ### Data Mode Specified as an Integer
 #
 # Data mode cannot be specified as an integer. When the stream access mode is
@@ -699,7 +679,6 @@
 #     methods for creating, reading, and writing files
 # *   Includes module FileTest, which provides dozens of additional methods.
 #
-#
 # Here, class File provides methods that are useful for:
 #
 # *   [Creating](rdoc-ref:File@Creating)
@@ -707,7 +686,6 @@
 # *   [Settings](rdoc-ref:File@Settings)
 # *   [Other](rdoc-ref:File@Other)
 #
-#
 # ### Creating
 #
 # *   ::new: Opens the file at the given path; returns the file.
@@ -717,7 +695,6 @@
 # *   ::mkfifo: Returns the FIFO file created at the given path.
 # *   ::symlink: Creates a symbolic link for the given file path.
 #
-#
 # ### Querying
 #
 # *Paths*
@@ -744,7 +721,6 @@
 # *   #path (aliased as #to_path):  Returns the string representation of the
 #     given path.
 #
-#
 # *Times*
 #
 # *   ::atime: Returns a Time for the most recent access to the given file.
@@ -758,7 +734,6 @@
 # *   #mtime: Returns a Time for the most recent data modification to the
 #     content of `self`.
 #
-#
 # *Types*
 #
 # *   ::blockdev?: Returns whether the file at the given path is a block device.
@@ -805,7 +780,6 @@
 # *   #lstat: Returns the File::Stat object for the last symbolic link in the
 #     path for `self`.
 #
-#
 # *Contents*
 #
 # *   ::empty? (aliased as ::zero?): Returns whether the file at the given path
@@ -815,7 +789,6 @@
 #     file is empty; otherwise returns the file size (bytes).
 # *   #size: Returns the size (bytes) of `self`.
 #
-#
 # ### Settings
 #
 # *   ::chmod: Changes permissions of the file at the given path.
@@ -829,7 +802,6 @@
 #     given paths.
 # *   #flock: Locks or unlocks `self`.
 #
-#
 # ### Other
 #
 # *   ::truncate: Truncates the file at the given file path to the given size.
@@ -1193,10 +1165,13 @@ class File < IO
   #
   #     `*`
   # :       Matches all regular files
+  #
   #     `c*`
   # :       Matches all files beginning with `c`
+  #
   #     `*c`
   # :       Matches all files ending with `c`
+  #
   #     `*c*`
   # :       Matches all files that have `c` in them (including at the beginning or
   #         end).
@@ -1205,19 +1180,24 @@ class File < IO
   #     To match hidden files (that start with a `.`) set the File::FNM_DOTMATCH
   #     flag.
   #
+  #
   # `**`
   # :   Matches directories recursively or files expansively.
   #
+  #
   # `?`
   # :   Matches any one character. Equivalent to `/.{1}/` in regexp.
   #
+  #
   # `[set]`
   # :   Matches any one character in `set`.  Behaves exactly like character sets
   #     in Regexp, including set negation (`[^a-z]`).
   #
+  #
   # `\`
   # :   Escapes the next metacharacter.
   #
+  #
   # `{a,b}`
   # :   Matches pattern a and pattern b if File::FNM_EXTGLOB flag is enabled.
   #     Behaves like a Regexp union (`(?:a|b)`).
@@ -1334,7 +1314,7 @@ class File < IO
   #
   #     File.join("usr", "mail", "gumby")   #=> "usr/mail/gumby"
   #
-  def self.join: (*string) -> String
+  def self.join: (*path) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1836,46 +1816,19 @@ class File < IO
   #   rdoc-file=file.c
   #   - flock(locking_constant) -> 0 or false
   # -->
-  # Locks or unlocks a file according to the given `locking_constant`,
+  # Locks or unlocks file `self` according to the given `locking_constant`,
   # a bitwise OR of the values in the table below.
   # Not available on all platforms.
   # Returns `false` if `File::LOCK_NB` is specified and the operation would have
   # blocked;
   # otherwise returns `0`.
-  #
-  # <table>
-  #   <tr>
-  #     <th colspan="3">Locking Constants</th>
-  #   </tr>
-  #   <tr>
-  #     <th>Constant</th>
-  #     <th>Lock</th>
-  #     <th>Effect</th>
-  #   </tr>
-  #   <tr>
-  #   <td><tt>File::LOCK_EX</tt></td>
-  #   <td>Exclusive</td>
-  #     <td>Only one process may hold an exclusive lock for <tt>self</tt> at a time.</td>
-  #   </tr>
-  #   <tr>
-  #     <td><tt>File::LOCK_NB</tt></td>
-  #     <td>Non-blocking</td>
-  #     <td>
-  #       No blocking; may be combined with other <tt>File::LOCK_SH</tt> or <tt>File::LOCK_EX</tt>
-  #       using the bitwise OR operator <tt>|</tt>.
-  #     </td>
-  #   </tr>
-  #   <tr>
-  #     <td><tt>File::LOCK_SH</tt></td>
-  #     <td>Shared</td>
-  #     <td>Multiple processes may each hold a shared lock for <tt>self</tt> at the same time.</td>
-  #   </tr>
-  #   <tr>
-  #     <td><tt>File::LOCK_UN</tt></td>
-  #     <td>Unlock</td>
-  #     <td>Remove an existing lock held by this process.</td>
-  #   </tr>
-  # </table>
+  #    Constant    |    Lock    |                                                    Effect
+  # ---------------|------------|--------------------------------------------------------------------------------------------------------------
+  # +File::LOCK_EX+| Exclusive  |                      Only one process may hold an exclusive lock for +self+ at a time.
+  # +File::LOCK_NB+|Non-blocking|No blocking; may be combined with +File::LOCK_SH+ or +File::LOCK_EX+ using the bitwise OR operator <tt>|</tt>.
+  # +File::LOCK_SH+|   Shared   |                 Multiple processes may each hold a shared lock for +self+ at the same time.
+  # +File::LOCK_UN+|   Unlock   |                                Remove an existing lock held by this process.
+  # Example:
   #     # Update a counter using an exclusive lock.
   # # Don't use File::WRONLY because it truncates the file.
   # File.open('counter', File::RDWR | File::CREAT, 0644) do |f|
@@ -2010,7 +1963,6 @@ File::Separator: String
 #     globbing](rdoc-ref:File::Constants@Filename+Globbing+Constants+-28File-3A-
 #     3AFNM_-2A-29).
 #
-#
 # File constants defined for the local process may be retrieved with method
 # File::Constants.constants:
 #
@@ -2034,7 +1986,6 @@ File::Separator: String
 # *   StringIO.open.
 # *   StringIO#reopen.
 #
-#
 # ### Read/Write Access
 #
 # Read-write access for a stream may be specified by a file-access constant.
@@ -2045,7 +1996,7 @@ File::Separator: String
 #
 # #### File::RDONLY
 #
-# Flag File::RDONLY specifies the the stream should be opened for reading only:
+# Flag File::RDONLY specifies the stream should be opened for reading only:
 #
 #     filepath = '/tmp/t.tmp'
 #     f = File.new(filepath, File::RDONLY)
@@ -2133,7 +2084,6 @@ File::Separator: String
 # *   File::NOFOLLOW.
 # *   File::TMPFILE.
 #
-#
 # #### File::SYNC, File::RSYNC, and File::DSYNC
 #
 # Flag File::SYNC, File::RSYNC, or File::DSYNC specifies synchronization of I/O
@@ -2160,7 +2110,6 @@ File::Separator: String
 #     be flushed to the underlying storage device; this differs from File::SYNC,
 #     which requires that *metadata* also be synchronized.
 #
-#
 # Note that the behavior of these flags may vary slightly depending on the
 # operating system and filesystem being used. Additionally, using these flags
 # can have an impact on performance due to the synchronous nature of the I/O
@@ -2214,11 +2163,13 @@ File::Separator: String
 #
 # Flag File::BINARY specifies that the stream is to be accessed in binary mode.
 #
-# #### File::SHARE_DELETE (Windows Only)
+# #### File::SHARE_DELETE
 #
 # Flag File::SHARE_DELETE enables other processes to open the stream with delete
 # access.
 #
+# Windows only.
+#
 # If the stream is opened for (local) delete access without File::SHARE_DELETE,
 # and another process attempts to open it with delete access, the attempt fails
 # and the stream is not opened for that process.
@@ -2257,7 +2208,6 @@ File::Separator: String
 # *   Pathname.glob.
 # *   Pathname#glob.
 #
-#
 # The constants are:
 #
 # #### File::FNM_CASEFOLD
@@ -2290,9 +2240,11 @@ File::Separator: String
 # Flag File::FNM_PATHNAME specifies that patterns `'*'` and `'?'` do not match
 # the directory separator (the value of constant File::SEPARATOR).
 #
-# #### File::FNM_SHORTNAME (Windows Only)
+# #### File::FNM_SHORTNAME
+#
+# Flag File::FNM_SHORTNAME allows patterns to match short names if they exist.
 #
-# Flag File::FNM_SHORTNAME Allows patterns to match short names if they exist.
+# Windows only.
 #
 # #### File::FNM_SYSCASE
 #
@@ -2439,8 +2391,7 @@ File::Constants::RDWR: Integer
 File::Constants::RSYNC: Integer
 
 # <!-- rdoc-file=file.c -->
-# [File::SHARE_DELETE](rdoc-ref:File::Constants@File-3A-3ASHARE_DELETE+-28Window
-# s+Only-29)
+# [File::SHARE_DELETE](rdoc-ref:File::Constants@File-3A-3ASHARE_DELETE)
 #
 File::Constants::SHARE_DELETE: Integer
 

data/core/float.rbs

@@ -10,23 +10,21 @@
 #     ys-floats-imprecise
 # *   https://en.wikipedia.org/wiki/Floating_point#Accuracy_problems
 #
-#
 # You can create a Float object explicitly with:
 #
 # *   A [floating-point literal](rdoc-ref:syntax/literals.rdoc@Float+Literals).
 #
-#
 # You can convert certain objects to Floats with:
 #
 # *   Method #Float.
 #
-#
 # ## What's Here
 #
 # First, what's elsewhere. Class Float:
 #
-# *   Inherits from [class Numeric](rdoc-ref:Numeric@What-27s+Here).
-#
+# *   Inherits from [class Numeric](rdoc-ref:Numeric@What-27s+Here) and [class
+#     Object](rdoc-ref:Object@What-27s+Here).
+# *   Includes [module Comparable](rdoc-ref:Comparable@What-27s+Here).
 #
 # Here, class Float provides methods for:
 #
@@ -34,7 +32,6 @@
 # *   [Comparing](rdoc-ref:Float@Comparing)
 # *   [Converting](rdoc-ref:Float@Converting)
 #
-#
 # ### Querying
 #
 # *   #finite?: Returns whether `self` is finite.
@@ -42,7 +39,6 @@
 # *   #infinite?: Returns whether `self` is infinite.
 # *   #nan?: Returns whether `self` is a NaN (not-a-number).
 #
-#
 # ### Comparing
 #
 # *   #<: Returns whether `self` is less than the given value.
@@ -54,7 +50,6 @@
 # *   #>: Returns whether `self` is greater than the given value.
 # *   #>=: Returns whether `self` is greater than or equal to the given value.
 #
-#
 # ### Converting
 #
 # *   #% (aliased as #modulo): Returns `self` modulo the given value.
@@ -241,7 +236,6 @@ class Float < Numeric
   # *   1, if `self` is greater than `other`.
   # *   `nil`, if the two values are incommensurate.
   #
-  #
   # Examples:
   #
   #     2.0 <=> 2              # => 0
@@ -351,33 +345,58 @@ class Float < Numeric
   #   rdoc-file=numeric.c
   #   - ceil(ndigits = 0) -> float or integer
   # -->
-  # Returns the smallest number greater than or equal to `self` with a precision
-  # of `ndigits` decimal digits.
-  #
-  # When `ndigits` is positive, returns a float with `ndigits` digits after the
-  # decimal point (as available):
-  #
+  # Returns a numeric that is a "ceiling" value for `self`,
+  # as specified by the given `ndigits`,
+  # which must be an
+  # [integer-convertible
+  # object](rdoc-ref:implicit_conversion.rdoc@Integer-Convertible+Objects).
+  # When `ndigits` is positive, returns a Float with `ndigits`
+  # decimal digits after the decimal point
+  # (as available, but no fewer than 1):
   #     f = 12345.6789
-  #     f.ceil(1) # => 12345.7
-  #     f.ceil(3) # => 12345.679
-  #     f = -12345.6789
-  #     f.ceil(1) # => -12345.6
-  #     f.ceil(3) # => -12345.678
-  #
-  # When `ndigits` is non-positive, returns an integer with at least `ndigits.abs`
-  # trailing zeros:
-  #
-  #     f = 12345.6789
-  #     f.ceil(0)  # => 12346
-  #     f.ceil(-3) # => 13000
-  #     f = -12345.6789
-  #     f.ceil(0)  # => -12345
-  #     f.ceil(-3) # => -12000
-  #
-  # Note that the limited precision of floating-point arithmetic may lead to
-  # surprising results:
-  #
-  #     (2.1 / 0.7).ceil  #=> 4 (!)
+  # f.ceil(1) # => 12345.7
+  # f.ceil(3) # => 12345.679
+  # f.ceil(30) # => 12345.6789
+  # f = -12345.6789
+  # f.ceil(1) # => -12345.6
+  # f.ceil(3) # => -12345.678
+  # f.ceil(30) # => -12345.6789
+  # f = 0.0
+  # f.ceil(1)   # => 0.0
+  # f.ceil(100) # => 0.0
+  #
+  # When `ndigits` is non-positive,
+  # returns an Integer based on a computed granularity:
+  # *   The granularity is `10 ** ndigits.abs`.
+  # *   The returned value is the largest multiple of the granularity
+  #      that is less than or equal to `self`.
+  # Examples with positive `self`:
+  # ndigits|Granularity|12345.6789.ceil(ndigits)
+  # -------|-----------|------------------------
+  #       0|          1|                   12346
+  #      -1|         10|                   12350
+  #      -2|        100|                   12400
+  #      -3|       1000|                   13000
+  #      -4|      10000|                   20000
+  #      -5|     100000|                  100000
+  # Examples with negative `self`:
+  # ndigits|Granularity|-12345.6789.ceil(ndigits)
+  # -------|-----------|-------------------------
+  #       0|          1|                   -12345
+  #      -1|         10|                   -12340
+  #      -2|        100|                   -12300
+  #      -3|       1000|                   -12000
+  #      -4|      10000|                   -10000
+  #      -5|     100000|                        0
+  # When `self` is zero and `ndigits` is non-positive,
+  # returns Integer zero:
+  #     0.0.ceil(0)  # => 0
+  # 0.0.ceil(-1) # => 0
+  # 0.0.ceil(-2) # => 0
+  #
+  # Note that the limited precision of floating-point arithmetic
+  # may lead to surprising results:
+  #     (2.1 / 0.7).ceil  #=> 4 # Not 3 (because 2.1 / 0.7 # => 3.0000000000000004, not 3.0)
   #
   # Related: Float#floor.
   #
@@ -498,33 +517,59 @@ class Float < Numeric
   #   rdoc-file=numeric.c
   #   - floor(ndigits = 0) -> float or integer
   # -->
-  # Returns the largest number less than or equal to `self` with a precision of
-  # `ndigits` decimal digits.
-  #
-  # When `ndigits` is positive, returns a float with `ndigits` digits after the
-  # decimal point (as available):
-  #
-  #     f = 12345.6789
-  #     f.floor(1) # => 12345.6
-  #     f.floor(3) # => 12345.678
-  #     f = -12345.6789
-  #     f.floor(1) # => -12345.7
-  #     f.floor(3) # => -12345.679
-  #
-  # When `ndigits` is non-positive, returns an integer with at least `ndigits.abs`
-  # trailing zeros:
-  #
+  # Returns a float or integer that is a "floor" value for `self`,
+  # as specified by `ndigits`,
+  # which must be an
+  # [integer-convertible
+  # object](rdoc-ref:implicit_conversion.rdoc@Integer-Convertible+Objects).
+  # When `self` is zero,
+  # returns a zero value:
+  # a float if `ndigits` is positive,
+  # an integer otherwise:
+  #     f = 0.0      # => 0.0
+  # f.floor(20)  # => 0.0
+  # f.floor(0)   # => 0
+  # f.floor(-20) # => 0
+  #
+  # When `self` is non-zero and `ndigits` is positive, returns a float with
+  # `ndigits`
+  # digits after the decimal point (as available):
   #     f = 12345.6789
-  #     f.floor(0)  # => 12345
-  #     f.floor(-3) # => 12000
-  #     f = -12345.6789
-  #     f.floor(0)  # => -12346
-  #     f.floor(-3) # => -13000
-  #
-  # Note that the limited precision of floating-point arithmetic may lead to
-  # surprising results:
-  #
-  #     (0.3 / 0.1).floor  #=> 2 (!)
+  # f.floor(1)  # => 12345.6
+  # f.floor(3)  # => 12345.678
+  # f.floor(30) # => 12345.6789
+  # f = -12345.6789
+  # f.floor(1)  # => -12345.7
+  # f.floor(3)  # => -12345.679
+  # f.floor(30) # => -12345.6789
+  #
+  # When `self` is non-zero and `ndigits` is non-positive,
+  # returns an integer value based on a computed granularity:
+  # *   The granularity is `10 ** ndigits.abs`.
+  # *   The returned value is the largest multiple of the granularity
+  #      that is less than or equal to `self`.
+  # Examples with positive `self`:
+  # ndigits|Granularity|12345.6789.floor(ndigits)
+  # -------|-----------|-------------------------
+  #       0|          1|                    12345
+  #      -1|         10|                    12340
+  #      -2|        100|                    12300
+  #      -3|       1000|                    12000
+  #      -4|      10000|                    10000
+  #      -5|     100000|                        0
+  # Examples with negative `self`:
+  # ndigits|Granularity|-12345.6789.floor(ndigits)
+  # -------|-----------|--------------------------
+  #       0|          1|                    -12346
+  #      -1|         10|                    -12350
+  #      -2|        100|                    -12400
+  #      -3|       1000|                    -13000
+  #      -4|      10000|                    -20000
+  #      -5|     100000|                   -100000
+  #      -6|    1000000|                  -1000000
+  # Note that the limited precision of floating-point arithmetic
+  # may lead to surprising results:
+  #     (0.3 / 0.1).floor  # => 2 # Not 3, (because (0.3 / 0.1) # => 2.9999999999999996, not 3.0)
   #
   # Related: Float#ceil.
   #
@@ -557,7 +602,6 @@ class Float < Numeric
   # *   -1 if `self` is `-Infinity`.
   # *   `nil`, otherwise.
   #
-  #
   # Examples:
   #
   #     f = 1.0/0.0  # => Infinity
@@ -576,14 +620,19 @@ class Float < Numeric
   # of `self`, the string representation may contain:
   #
   # *   A fixed-point number.
+  #         3.14.to_s         # => "3.14"
+  #
   # *   A number in "scientific notation" (containing an exponent).
+  #         (10.1**50).to_s   # => "1.644631821843879e+50"
+  #
   # *   'Infinity'.
+  #         (10.1**500).to_s  # => "Infinity"
+  #
   # *   '-Infinity'.
-  # *   'NaN' (indicating not-a-number).
+  #         (-10.1**500).to_s # => "-Infinity"
   #
-  #     3.14.to_s         # => "3.14" (10.1**50).to_s   # =>
-  #     "1.644631821843879e+50" (10.1**500).to_s  # => "Infinity"
-  #     (-10.1**500).to_s # => "-Infinity" (0.0/0.0).to_s    # => "NaN"
+  # *   'NaN' (indicating not-a-number).
+  #         (0.0/0.0).to_s    # => "NaN"
   #
   alias inspect to_s
 
@@ -798,7 +847,7 @@ class Float < Numeric
 
   # <!--
   #   rdoc-file=numeric.c
-  #   - round(ndigits = 0, half: :up]) -> integer or float
+  #   - round(ndigits = 0, half: :up) -> integer or float
   # -->
   # Returns `self` rounded to the nearest value with a precision of `ndigits`
   # decimal digits.
@@ -844,7 +893,6 @@ class Float < Numeric
   #         3.5.round(half: :even)    # => 4
   #         (-2.5).round(half: :even) # => -2
   #
-  #
   # Raises and exception if the value for `half` is invalid.
   #
   # Related: Float#truncate.
@@ -926,14 +974,19 @@ class Float < Numeric
   # of `self`, the string representation may contain:
   #
   # *   A fixed-point number.
+  #         3.14.to_s         # => "3.14"
+  #
   # *   A number in "scientific notation" (containing an exponent).
+  #         (10.1**50).to_s   # => "1.644631821843879e+50"
+  #
   # *   'Infinity'.
+  #         (10.1**500).to_s  # => "Infinity"
+  #
   # *   '-Infinity'.
-  # *   'NaN' (indicating not-a-number).
+  #         (-10.1**500).to_s # => "-Infinity"
   #
-  #     3.14.to_s         # => "3.14" (10.1**50).to_s   # =>
-  #     "1.644631821843879e+50" (10.1**500).to_s  # => "Infinity"
-  #     (-10.1**500).to_s # => "-Infinity" (0.0/0.0).to_s    # => "NaN"
+  # *   'NaN' (indicating not-a-number).
+  #         (0.0/0.0).to_s    # => "NaN"
   #
   def to_s: () -> String