rbs 4.1.0.pre.2-java

data/core/rational.rbs

@@ -0,0 +1,502 @@
+# <!-- rdoc-file=rational.c -->
+# A rational number can be represented as a pair of integer numbers: a/b (b>0),
+# where a is the numerator and b is the denominator. Integer a equals rational
+# a/1 mathematically.
+#
+# You can create a Rational object explicitly with:
+#
+# *   A [rational literal](rdoc-ref:syntax/literals.rdoc@Rational+Literals).
+#
+# You can convert certain objects to Rationals with:
+#
+# *   Method #Rational.
+#
+# Examples
+#
+#     Rational(1)      #=> (1/1)
+#     Rational(2, 3)   #=> (2/3)
+#     Rational(4, -6)  #=> (-2/3) # Reduced.
+#     3.to_r           #=> (3/1)
+#     2/3r             #=> (2/3)
+#
+# You can also create rational objects from floating-point numbers or strings.
+#
+#     Rational(0.3)    #=> (5404319552844595/18014398509481984)
+#     Rational('0.3')  #=> (3/10)
+#     Rational('2/3')  #=> (2/3)
+#
+#     0.3.to_r         #=> (5404319552844595/18014398509481984)
+#     '0.3'.to_r       #=> (3/10)
+#     '2/3'.to_r       #=> (2/3)
+#     0.3.rationalize  #=> (3/10)
+#
+# A rational object is an exact number, which helps you to write programs
+# without any rounding errors.
+#
+#     10.times.inject(0) {|t| t + 0.1 }              #=> 0.9999999999999999
+#     10.times.inject(0) {|t| t + Rational('0.1') }  #=> (1/1)
+#
+# However, when an expression includes an inexact component (numerical value or
+# operation), it will produce an inexact result.
+#
+#     Rational(10) / 3   #=> (10/3)
+#     Rational(10) / 3.0 #=> 3.3333333333333335
+#
+#     Rational(-8) ** Rational(1, 3)
+#                        #=> (1.0000000000000002+1.7320508075688772i)
+#
+class Rational < Numeric
+  def %: (Integer) -> Rational
+       | (Float) -> Float
+       | (Rational) -> Rational
+       | (Numeric) -> Numeric
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self * other -> numeric
+  # -->
+  # Returns the numeric product of `self` and `other`:
+  #
+  #     Rational(9, 8)  * 4               #=> (9/2)
+  #     Rational(20, 9) * 9.8             #=> 21.77777777777778
+  #     Rational(9, 8)  * Complex(1, 2)   # => ((9/8)+(9/4)*i)
+  #     Rational(2, 3)  * Rational(2, 3)  #=> (4/9)
+  #     Rational(900)   * Rational(1)     #=> (900/1)
+  #     Rational(-2, 9) * Rational(-9, 2) #=> (1/1)
+  #
+  def *: (Integer) -> Rational
+       | (Rational) -> Rational
+       | [T < Numeric](T) -> T
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self ** exponent -> numeric
+  # -->
+  # Returns `self` raised to the power `exponent`:
+  #
+  #     Rational(2)    ** Rational(3)     #=> (8/1)
+  #     Rational(10)   ** -2              #=> (1/100)
+  #     Rational(10)   ** -2.0            #=> 0.01
+  #     Rational(-4)   ** Rational(1, 2)  #=> (0.0+2.0i)
+  #     Rational(1, 2) ** 0               #=> (1/1)
+  #     Rational(1, 2) ** 0.0             #=> 1.0
+  #
+  def **: (Complex) -> Complex
+        | (Numeric) -> Numeric
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self + other -> numeric
+  # -->
+  # Returns the sum of `self` and `other`:
+  #
+  #     Rational(2, 3) + 0  # => (2/3)
+  #     Rational(2, 3) + 1  # => (5/3)
+  #     Rational(2, 3) + -1 # => (-1/3)
+  #
+  #     Rational(2, 3) + Complex(1, 0)     # => ((5/3)+0i)
+  #
+  #     Rational(2, 3) + Rational(1, 1)     # => (5/3)
+  #     Rational(2, 3) + Rational(3, 2)     # => (13/6)
+  #     Rational(2, 3) + Rational(3.0, 2.0) # => (13/6)
+  #     Rational(2, 3) + Rational(3.1, 2.1) # => (30399297484750849/14186338826217063)
+  #
+  # For a computation involving Floats, the result may be inexact (see Float#+):
+  #
+  #     Rational(2, 3) + 1.0 # => 1.6666666666666665
+  #     Rational(2, 3) + Complex(1.0, 0.0) # => (1.6666666666666665+0.0i)
+  #
+  def +: (Float) -> Float
+       | (Complex) -> Complex
+       | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self - other -> numeric
+  # -->
+  # Returns the difference of `self` and `other`:
+  #
+  #     Rational(2, 3)  - Rational(2, 3)   #=> (0/1)
+  #     Rational(900)   - Rational(1)      #=> (899/1)
+  #     Rational(-2, 9) - Rational(-9, 2)  #=> (77/18)
+  #     Rational(9, 8)  - 4                #=> (-23/8)
+  #     Rational(20, 9) - 9.8              #=> -7.577777777777778
+  #
+  def -: (Float) -> Float
+       | (Complex) -> Complex
+       | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - -self -> rational
+  # -->
+  # Returns `self`, negated:
+  #
+  #     -(1/3r)   # => (-1/3)
+  #     -(-1/3r)  # => (1/3)
+  #
+  def -@: () -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self / other -> numeric
+  # -->
+  # Returns the quotient of `self` and `other`:
+  #
+  #     Rational(2, 3)  / Rational(2, 3)   #=> (1/1)
+  #     Rational(900)   / Rational(1)      #=> (900/1)
+  #     Rational(-2, 9) / Rational(-9, 2)  #=> (4/81)
+  #     Rational(9, 8)  / 4                #=> (9/32)
+  #     Rational(20, 9) / 9.8              #=> 0.22675736961451246
+  #
+  def /: (Float) -> Float
+       | (Complex) -> Complex
+       | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - self <=> other -> -1, 0, 1, or nil
+  # -->
+  # Compares `self` and `other`.
+  #
+  # Returns:
+  #
+  # *   <code>-1</code>, if `self` is less than `other`.
+  # *   `0`, if the two values are the same.
+  # *   `1`, if `self` is greater than `other`.
+  # *   `nil`, if the two values are incomparable.
+  #
+  # Examples:
+  #
+  #     Rational(2, 3) <=> Rational(4, 3) # => -1
+  #     Rational(2, 1) <=> Rational(2, 1) # => 0
+  #     Rational(2, 1) <=> 2              # => 0
+  #     Rational(2, 1) <=> 2.0            # => 0
+  #     Rational(2, 1) <=> Complex(2, 0)  # => 0
+  #     Rational(4, 3) <=> Rational(2, 3) # => 1
+  #     Rational(4, 3) <=> :foo           # => nil
+  #
+  # Class Rational includes module Comparable, each of whose methods uses
+  # Rational#<=> for comparison.
+  #
+  def <=>: (Integer | Rational) -> Integer
+         | (untyped) -> Integer?
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat == object  ->  true or false
+  # -->
+  # Returns `true` if `rat` equals `object` numerically.
+  #
+  #     Rational(2, 3)  == Rational(2, 3)   #=> true
+  #     Rational(5)     == 5                #=> true
+  #     Rational(0)     == 0.0              #=> true
+  #     Rational('1/3') == 0.33             #=> false
+  #     Rational('1/2') == '1/2'            #=> false
+  #
+  def ==: (untyped) -> bool
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.abs        ->  rational
+  #   - rat.magnitude  ->  rational
+  # -->
+  # Returns the absolute value of `rat`.
+  #
+  #     (1/2r).abs    #=> (1/2)
+  #     (-1/2r).abs   #=> (1/2)
+  #
+  def abs: () -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.ceil([ndigits])  ->  integer or rational
+  # -->
+  # Returns the smallest number greater than or equal to `rat` with a precision of
+  # `ndigits` decimal digits (default: 0).
+  #
+  # When the precision is negative, the returned value is an integer with at least
+  # <code>ndigits.abs</code> trailing zeros.
+  #
+  # Returns a rational when `ndigits` is positive, otherwise returns an integer.
+  #
+  #     Rational(3).ceil      #=> 3
+  #     Rational(2, 3).ceil   #=> 1
+  #     Rational(-3, 2).ceil  #=> -1
+  #
+  #       #    decimal      -  1  2  3 . 4  5  6
+  #       #                   ^  ^  ^  ^   ^  ^
+  #       #   precision      -3 -2 -1  0  +1 +2
+  #
+  #     Rational('-123.456').ceil(+1).to_f  #=> -123.4
+  #     Rational('-123.456').ceil(-1)       #=> -120
+  #
+  def ceil: () -> Integer
+          | (Integer digits) -> (Integer | Rational)
+
+  def coerce: (Numeric) -> [ Numeric, Numeric ]
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.denominator  ->  integer
+  # -->
+  # Returns the denominator (always positive).
+  #
+  #     Rational(7).denominator             #=> 1
+  #     Rational(7, 1).denominator          #=> 1
+  #     Rational(9, -4).denominator         #=> 4
+  #     Rational(-2, -10).denominator       #=> 5
+  #
+  def denominator: () -> Integer
+
+  def divmod: (Integer | Float | Rational) -> [ Integer, Rational ]
+            | (Numeric) -> [ Numeric, Numeric ]
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.fdiv(numeric)  ->  float
+  # -->
+  # Performs division and returns the value as a Float.
+  #
+  #     Rational(2, 3).fdiv(1)       #=> 0.6666666666666666
+  #     Rational(2, 3).fdiv(0.5)     #=> 1.3333333333333333
+  #     Rational(2).fdiv(3)          #=> 0.6666666666666666
+  #
+  def fdiv: (Numeric) -> Float
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.floor([ndigits])  ->  integer or rational
+  # -->
+  # Returns the largest number less than or equal to `rat` with a precision of
+  # `ndigits` decimal digits (default: 0).
+  #
+  # When the precision is negative, the returned value is an integer with at least
+  # <code>ndigits.abs</code> trailing zeros.
+  #
+  # Returns a rational when `ndigits` is positive, otherwise returns an integer.
+  #
+  #     Rational(3).floor      #=> 3
+  #     Rational(2, 3).floor   #=> 0
+  #     Rational(-3, 2).floor  #=> -2
+  #
+  #       #    decimal      -  1  2  3 . 4  5  6
+  #       #                   ^  ^  ^  ^   ^  ^
+  #       #   precision      -3 -2 -1  0  +1 +2
+  #
+  #     Rational('-123.456').floor(+1).to_f  #=> -123.5
+  #     Rational('-123.456').floor(-1)       #=> -130
+  #
+  def floor: () -> Integer
+           | (Integer digits) -> (Integer | Rational)
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - hash()
+  # -->
+  #
+  def hash: () -> Integer
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.inspect  ->  string
+  # -->
+  # Returns the value as a string for inspection.
+  #
+  #     Rational(2).inspect      #=> "(2/1)"
+  #     Rational(-8, 6).inspect  #=> "(-4/3)"
+  #     Rational('1/2').inspect  #=> "(1/2)"
+  #
+  def inspect: () -> String
+
+  # <!-- rdoc-file=rational.c -->
+  # Returns the absolute value of `rat`.
+  #
+  #     (1/2r).abs    #=> (1/2)
+  #     (-1/2r).abs   #=> (1/2)
+  #
+  alias magnitude abs
+
+  def modulo: (Float) -> Float
+            | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.negative?  ->  true or false
+  # -->
+  # Returns `true` if `rat` is less than 0.
+  #
+  def negative?: () -> bool
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.numerator  ->  integer
+  # -->
+  # Returns the numerator.
+  #
+  #     Rational(7).numerator        #=> 7
+  #     Rational(7, 1).numerator     #=> 7
+  #     Rational(9, -4).numerator    #=> -9
+  #     Rational(-2, -10).numerator  #=> 1
+  #
+  def numerator: () -> Integer
+
+  def polar: () -> [ Rational, Integer | Float ]
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.positive?  ->  true or false
+  # -->
+  # Returns `true` if `rat` is greater than 0.
+  #
+  def positive?: () -> bool
+
+  # <!-- rdoc-file=rational.c -->
+  # Returns the quotient of `self` and `other`:
+  #
+  #     Rational(2, 3)  / Rational(2, 3)   #=> (1/1)
+  #     Rational(900)   / Rational(1)      #=> (900/1)
+  #     Rational(-2, 9) / Rational(-9, 2)  #=> (4/81)
+  #     Rational(9, 8)  / 4                #=> (9/32)
+  #     Rational(20, 9) / 9.8              #=> 0.22675736961451246
+  #
+  def quo: (Float) -> Float
+         | (Complex) -> Complex
+         | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.rationalize       ->  self
+  #   - rat.rationalize(eps)  ->  rational
+  # -->
+  # Returns a simpler approximation of the value if the optional argument `eps` is
+  # given (rat-|eps| <= result <= rat+|eps|), self otherwise.
+  #
+  #     r = Rational(5033165, 16777216)
+  #     r.rationalize                    #=> (5033165/16777216)
+  #     r.rationalize(Rational('0.01'))  #=> (3/10)
+  #     r.rationalize(Rational('0.1'))   #=> (1/3)
+  #
+  def rationalize: (?Numeric eps) -> Rational
+
+  def rect: () -> [ Rational, Numeric ]
+
+  def remainder: (Float) -> Float
+               | (Numeric) -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.round([ndigits] [, half: mode])  ->  integer or rational
+  # -->
+  # Returns `rat` rounded to the nearest value with a precision of `ndigits`
+  # decimal digits (default: 0).
+  #
+  # When the precision is negative, the returned value is an integer with at least
+  # <code>ndigits.abs</code> trailing zeros.
+  #
+  # Returns a rational when `ndigits` is positive, otherwise returns an integer.
+  #
+  #     Rational(3).round      #=> 3
+  #     Rational(2, 3).round   #=> 1
+  #     Rational(-3, 2).round  #=> -2
+  #
+  #       #    decimal      -  1  2  3 . 4  5  6
+  #       #                   ^  ^  ^  ^   ^  ^
+  #       #   precision      -3 -2 -1  0  +1 +2
+  #
+  #     Rational('-123.456').round(+1).to_f  #=> -123.5
+  #     Rational('-123.456').round(-1)       #=> -120
+  #
+  # The optional `half` keyword argument is available similar to Float#round.
+  #
+  #     Rational(25, 100).round(1, half: :up)    #=> (3/10)
+  #     Rational(25, 100).round(1, half: :down)  #=> (1/5)
+  #     Rational(25, 100).round(1, half: :even)  #=> (1/5)
+  #     Rational(35, 100).round(1, half: :up)    #=> (2/5)
+  #     Rational(35, 100).round(1, half: :down)  #=> (3/10)
+  #     Rational(35, 100).round(1, half: :even)  #=> (2/5)
+  #     Rational(-25, 100).round(1, half: :up)   #=> (-3/10)
+  #     Rational(-25, 100).round(1, half: :down) #=> (-1/5)
+  #     Rational(-25, 100).round(1, half: :even) #=> (-1/5)
+  #
+  def round: (?half: :up | :down | :even) -> Integer
+           | (Integer digits, ?half: :up | :down | :even) -> (Integer | Rational)
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.to_f  ->  float
+  # -->
+  # Returns the value as a Float.
+  #
+  #     Rational(2).to_f      #=> 2.0
+  #     Rational(9, 4).to_f   #=> 2.25
+  #     Rational(-3, 4).to_f  #=> -0.75
+  #     Rational(20, 3).to_f  #=> 6.666666666666667
+  #
+  def to_f: () -> Float
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.to_i  ->  integer
+  # -->
+  # Returns the truncated value as an integer.
+  #
+  # Equivalent to Rational#truncate.
+  #
+  #     Rational(2, 3).to_i    #=> 0
+  #     Rational(3).to_i       #=> 3
+  #     Rational(300.6).to_i   #=> 300
+  #     Rational(98, 71).to_i  #=> 1
+  #     Rational(-31, 2).to_i  #=> -15
+  #
+  def to_i: () -> Integer
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.to_r  ->  self
+  # -->
+  # Returns self.
+  #
+  #     Rational(2).to_r      #=> (2/1)
+  #     Rational(-8, 6).to_r  #=> (-4/3)
+  #
+  def to_r: () -> Rational
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.to_s  ->  string
+  # -->
+  # Returns the value as a string.
+  #
+  #     Rational(2).to_s      #=> "2/1"
+  #     Rational(-8, 6).to_s  #=> "-4/3"
+  #     Rational('1/2').to_s  #=> "1/2"
+  #
+  def to_s: () -> String
+
+  # <!--
+  #   rdoc-file=rational.c
+  #   - rat.truncate([ndigits])  ->  integer or rational
+  # -->
+  # Returns `rat` truncated (toward zero) to a precision of `ndigits` decimal
+  # digits (default: 0).
+  #
+  # When the precision is negative, the returned value is an integer with at least
+  # <code>ndigits.abs</code> trailing zeros.
+  #
+  # Returns a rational when `ndigits` is positive, otherwise returns an integer.
+  #
+  #     Rational(3).truncate      #=> 3
+  #     Rational(2, 3).truncate   #=> 0
+  #     Rational(-3, 2).truncate  #=> -1
+  #
+  #       #    decimal      -  1  2  3 . 4  5  6
+  #       #                   ^  ^  ^  ^   ^  ^
+  #       #   precision      -3 -2 -1  0  +1 +2
+  #
+  #     Rational('-123.456').truncate(+1).to_f  #=> -123.4
+  #     Rational('-123.456').truncate(-1)       #=> -120
+  #
+  def truncate: () -> Integer
+              | (Integer ndigits) -> (Integer | Rational)
+end

data/core/rb_config.rbs

@@ -0,0 +1,88 @@
+# <!-- rdoc-file=rbconfig.rb -->
+# The module storing Ruby interpreter configurations on building.
+#
+# This file was created by mkconfig.rb when ruby was built.  It contains build
+# information for ruby which is used e.g. by mkmf to build compatible native
+# extensions.  Any changes made to this file will be lost the next time ruby is
+# built.
+#
+module RbConfig
+  # <!-- rdoc-file=rbconfig.rb -->
+  # The hash configurations stored.
+  #
+  CONFIG: Hash[String, String]
+
+  # <!-- rdoc-file=rbconfig.rb -->
+  # DESTDIR on make install.
+  #
+  DESTDIR: String
+
+  # <!-- rdoc-file=rbconfig.rb -->
+  # Almost same with CONFIG. MAKEFILE_CONFIG has other variable reference like
+  # below.
+  #
+  #     MAKEFILE_CONFIG["bindir"] = "$(exec_prefix)/bin"
+  #
+  # The values of this constant is used for creating Makefile.
+  #
+  #     require 'rbconfig'
+  #
+  #     print <<-END_OF_MAKEFILE
+  #     prefix = #{RbConfig::MAKEFILE_CONFIG['prefix']}
+  #     exec_prefix = #{RbConfig::MAKEFILE_CONFIG['exec_prefix']}
+  #     bindir = #{RbConfig::MAKEFILE_CONFIG['bindir']}
+  #     END_OF_MAKEFILE
+  #
+  #     => prefix = /usr/local
+  #        exec_prefix = $(prefix)
+  #        bindir = $(exec_prefix)/bin  MAKEFILE_CONFIG = {}
+  #
+  # RbConfig.expand is used for resolving references like above in rbconfig.
+  #
+  #     require 'rbconfig'
+  #     p RbConfig.expand(RbConfig::MAKEFILE_CONFIG["bindir"])
+  #     # => "/usr/local/bin"
+  #
+  MAKEFILE_CONFIG: Hash[String, String]
+
+  # <!-- rdoc-file=rbconfig.rb -->
+  # Ruby installed directory.
+  #
+  TOPDIR: String
+
+  # <!--
+  #   rdoc-file=rbconfig.rb
+  #   - RbConfig.expand(val)         -> string
+  #   - RbConfig.expand(val, config) -> string
+  # -->
+  # expands variable with given `val` value.
+  #
+  #     RbConfig.expand("$(bindir)") # => /home/foobar/all-ruby/ruby19x/bin
+  #
+  def self.expand: (String val, ?Hash[String, String] config) -> String
+
+  # <!--
+  #   rdoc-file=rbconfig.rb
+  #   - RbConfig.fire_update!(key, val)               -> array
+  #   - RbConfig.fire_update!(key, val, mkconf, conf) -> array
+  # -->
+  # updates `key+ in `mkconf` with `val`, and all values depending on
+  # the `key` in `mkconf`.
+  #
+  #   RbConfig::MAKEFILE_CONFIG.values_at("CC", "LDSHARED") # => ["gcc", "$(CC) -shared"]
+  #   RbConfig::CONFIG.values_at("CC", "LDSHARED")          # => ["gcc", "gcc -shared"]
+  #   RbConfig.fire_update!("CC", "gcc-8")                  # => ["CC", "LDSHARED"]
+  #   RbConfig::MAKEFILE_CONFIG.values_at("CC", "LDSHARED") # => ["gcc-8", "$(CC) -shared"]
+  #   RbConfig::CONFIG.values_at("CC", "LDSHARED")          # => ["gcc-8", "gcc-8 -shared"]
+  #
+  # returns updated keys list, or `nil` if nothing changed.
+  def self.fire_update!: (String key, String val, ?Hash[String, String] mkconf, ?Hash[String, String] conf) -> Array[String]?
+
+  # <!--
+  #   rdoc-file=rbconfig.rb
+  #   - RbConfig.ruby -> path
+  # -->
+  #
+  # returns the absolute pathname of the ruby command.
+  def self.ruby: () -> String
+end