mirror of https://github.com/mruby/mruby synced 2026-06-08 16:11:16 +00:00

Files

T

Yukihiro "Matz" Matsumoto 0fab703028 class.c: use linear search for method tables; make ROM entries const

Replace binary search with linear scan in mt_get(), mt_put(),
mt_del(), mt_chain_has(), and mrb_mt_foreach(). The method cache
makes repeated lookups O(1), so linear scan on cache misses is
acceptable.

This removes the sorting requirement, allowing ROM entry arrays
to be declared const. On embedded systems, const static data
resides in flash/ROM instead of RAM, saving ~8.4KB for ~700
method entries on 32-bit MCUs.

Co-authored-by: Claude <noreply@anthropic.com>

2026-02-20 08:26:05 +09:00

mrblib

docs: replace xml-style markup with markdown in comments

2025-08-14 10:52:49 +09:00

src

class.c: use linear search for method tables; make ROM entries const

2026-02-20 08:26:05 +09:00

test

mruby-numeric-ext: add Integer#bit_length

2025-08-14 10:53:12 +09:00

mrbgem.rake

Rename extended xxxx class or module to xxxx class or module extension

2015-06-28 11:18:52 +09:00

README.md

mruby-numeric-ext: add Integer#bit_length

2025-08-14 10:53:12 +09:00

README.md

mruby-numeric-ext

Purpose

This mrbgem extends the Numeric and Integer classes in mruby with additional methods for common numerical operations and checks.

Functionality

This gem adds the following methods:

Numeric Class

zero?: Returns true if the number is zero, false otherwise.
nonzero?: Returns the number itself if it's not zero, nil otherwise.
positive?: Returns true if the number is greater than 0, false otherwise.
negative?: Returns true if the number is less than 0, false otherwise.
integer?: Returns true if the number is an Integer (this is overridden in the Integer class).

Integer Class

allbits?(mask): Returns true if all bits of self & mask are 1.
anybits?(mask): Returns true if any bits of self & mask are 1.
nobits?(mask): Returns true if no bits of self & mask are 1.
bit_length: Returns the number of bits of the absolute value of self in binary. 0.bit_length #=> 0; (-1).bit_length #=> 0; 2.bit_length #=> 2.
ceildiv(other): Returns the result of self divided by other, rounded up to the nearest integer.
integer?: Returns true (overrides Numeric#integer?).
remainder(numeric): Returns the remainder of self divided by numeric. Equivalent to x - y * (x / y).truncate.
pow(numeric): Returns self raised to the power of numeric.
pow(integer, integer): Returns modular exponentiation ((self ** exponent) % modulus).
digits(base=10): Returns an array of integers representing the base-radix digits of self. The first element is the least significant digit.
size: Returns the number of bytes in the machine representation of the integer.
odd?: Returns true if the integer is odd, false otherwise.
even?: Returns true if the integer is even, false otherwise.
Integer.sqrt(integer): (Class method) Returns the integer square root of the given non-negative integer.

How to use

To use this mrbgem, add it to your build_config.rb:

MRuby::Build.new do |conf|
  # ... (other configurations)
  conf.gem :core => 'mruby-numeric-ext'
end

Then you can use the extended methods:

p 5.positive?  # => true
p (-3).negative? # => true
p 0.zero?      # => true
p 5.nonzero?   # => 5
p 0.nonzero?   # => nil

p 7.allbits?(3)  # => false (binary 111 & 011 is 011, not 011)
p 7.anybits?(3)  # => true
p 7.nobits?(8)   # => true (binary 111 & 1000 is 000)

p 10.ceildiv(3)   # => 4
p (-10).ceildiv(3) # => -3

p 10.remainder(3) # => 1
p (-10).remainder(3) # => -1

p 2.pow(3)        # => 8
p 2.pow(3, 5)     # => 3 ( (2**3) % 5 )

p 12345.digits    # => [5, 4, 3, 2, 1]
p 12345.digits(16) # => [9, 3, 0, 3]

p 42.size         # => (depends on machine, e.g., 4 or 8)
p 5.bit_length    # => 3
p 5.odd?          # => true
p 4.even?         # => true
p Integer.sqrt(16) # => 4
p Integer.sqrt(17) # => 4