-
Notifications
You must be signed in to change notification settings - Fork 0
JRuby and Truffle Interop
JRuby+Truffle supports standard Truffle interop messages. This document explains what it does when it receives them, how to get it to explicitly send them, how to get it to send them using more idiomatic Ruby, and how what messages it sends for normal Ruby operations on foreign objects.
Interop ignores visibility entirely.
- How Ruby responds to messages
- How to explicitly send messages from Ruby
- How to send messages using idiomatic Ruby
- What messages are sent for Ruby syntax on foreign objects
- Import and export
Returns true only for instances of Method and Proc.
Calls either a Method or Proc, passing the arguments as you'd expect. Doesn't pass a block.
Calls the method with the name you provided, passing the arguments as you'd expect. Doesn't pass a block.
Returns true only for instances of Array, Hash and String.
Call size on the object.
Returns true only for instances of String with a length of 1, which allows them to be unboxed as a character.
For a String, returns the first character. Unboxing empty strings is not supported and will cause an UnsupportedMessageException. For all other objects returns the object.
Returns true only for the nil object.
The name must be a Java int or String, or a Ruby String or Symbol.
If the receiver is a Ruby String and the name is an integer, read a byte from the string, ignoring the encoding. If the index is out of range you'll get 0:
READ(string, integer) → string.get_byte(integer)
For the following conditions the name cannot be a Java int.
Otherwise, if the name starts with @, read it as an instance variable:
READ(object, "@name") → object.instance_variable_get("name")
Otherwise, if there isn't a method defined on the object with the same name as the name, and there is a method defined on the object called [], call [] with the name as the argument:
READ(object, name) → object[name] unless object.responds_to?(name)
Otherwise, perform a method call using the name as the called method name:
READ(object, name) → object.name if object.responds_to?(name)
In all cases where a call is made no block is passed.
The name must be a Java String, or a Ruby String or Symbol.
If the name starts with @, write it as an instance variable:
WRITE(object, "@name", value) → object.instance_variable_set("name", value)
Otherwise, if there isn't a method defined on the object with the same name as the name, and there is a method defined on the object called []=, call []= with the name and value as the two arguments:
WRITE(object, name, value) → object[name] = value unless object.responds_to?(name)
Otherwise, perform a method call using the name appended with = as the called method name, and the value as the argument:
WRITE(object, name, value) → object.name = value if object.responds_to?(name + "=")
In all cases where a call is made no block is passed.
Truffle::Interop.executable?(value)
Truffle::Interop.execute(receiver, *args)
Truffle::Interop.invoke(receiver, name, *args)
name can be a String or Symbol.
Truffle::Interop.size?(value)
Truffle::Interop.size(value)
Truffle::Interop.boxed?(value)
Truffle::Interop.unbox(value)
Truffle::Interop.null?(value)
Truffle::Interop.read(object, name)
If name is a String or Symbol it will be converted into a Java String.
Truffle::Interop.read(object, name, value)
If name is a String or Symbol it will be converted into a Java String.
Not supported.
object.call(*args)
object.name(*args)
object.name! if there are no arguments (otherwise it is a READ)
Not supported.
Not supported.
Not supported.
Not supported.
value.nil?
object.name
object[name], where name is a String or Symbol in most cases, or an integer, or anything else
object.name = value
object[name] = value, where name is a String or Symbol in most cases, or an integer, or anything else
object[name] (#[](name)) sends READ
object.name with no arguments send READ
object[name] = value (#[]=(name, value)) sends WRITE
object.name = value (#name=(value)) sends WRITE
object.call(*args) sends EXECUTE
object.nil? sends IS_NIL
object.name(*args) sends INVOKE (with no arguments it sends READ)
object.name! sends INVOKE
Truffle::Interop.export(:name, value)
Truffle::Interop.export_method(:name) (looks for name in Object)
value = Truffle::Interop.import(:name)
Truffle::Interop.import_method(:name) (defines name in Object)