pub struct RString { /* private fields */ }
Expand description
String
Implementations
sourceimpl RString
impl RString
sourcepub fn new(string: &str) -> Self
👎Deprecated since 0.3.2: please use new_usascii_unchecked
or new_utf8
instead
pub fn new(string: &str) -> Self
new_usascii_unchecked
or new_utf8
insteadCreates a new instance of Ruby String
containing given string
.
Examples
use rutie::{RString, VM};
let string = RString::new("Hello, World!");
assert_eq!(string.to_str(), "Hello, World!");
Ruby:
str = 'Hello, World!'
str == 'Hello, World!'
sourcepub fn new_utf8(string: &str) -> Self
pub fn new_utf8(string: &str) -> Self
Creates a new instance of Ruby String
, with UTF8 encoding, containing
given string
.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello, World!");
assert_eq!(string.to_string(), "Hello, World!".to_string());
Ruby:
str = 'Hello, World!'
str == 'Hello, World!'
sourcepub fn new_usascii_unchecked(string: &str) -> Self
pub fn new_usascii_unchecked(string: &str) -> Self
Creates a new instance of Ruby String
containing given string
.
Examples
use rutie::{RString, VM};
let string = RString::new_usascii_unchecked("Hello, World!");
assert_eq!(string.to_str(), "Hello, World!");
Ruby:
str = 'Hello, World!'
str == 'Hello, World!'
sourcepub fn from_bytes(bytes: &[u8], enc: &Encoding) -> Self
pub fn from_bytes(bytes: &[u8], enc: &Encoding) -> Self
Creates a new instance of Ruby String
from given byte
sequence with given Encoding
.
Examples
use rutie::{RString, Encoding, EncodingSupport, VM};
let bytes = [197, 130, 97, 197, 130];
let enc = Encoding::find("UTF-8").unwrap();
let string = RString::from_bytes(&bytes, &enc);
assert_eq!(string.to_str(), "łał");
VM::require("enc/encdb");
VM::require("enc/trans/transdb");
let result = string.encode(Encoding::find("UTF-16").unwrap(), None);
assert_eq!(result.to_bytes_unchecked(), [254, 255, 1, 66, 0, 97, 1, 66])
sourcepub fn to_string(&self) -> String
pub fn to_string(&self) -> String
Retrieves underlying Rust String
from Ruby String
object.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello, World!");
assert_eq!(string.to_string(), "Hello, World!".to_string());
Ruby:
str = 'Hello, World!'
str == 'Hello, World!'
sourcepub fn to_string_unchecked(&self) -> String
pub fn to_string_unchecked(&self) -> String
Retrieves underlying Rust String
from Ruby String
object.
Unlike to_string()
it does not perform any checks for internal null-bytes.
This function may be used to safely get binary data from Ruby.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello,\0World!");
assert_eq!(string.to_string_unchecked(), "Hello,\0World!".to_string());
Ruby:
str = 'Hello,\0World!'
str == 'Hello,\0World!'
sourcepub fn to_vec_u8_unchecked(&self) -> Vec<u8>
pub fn to_vec_u8_unchecked(&self) -> Vec<u8>
Retrieves Vec<u8>
from Ruby String
object.
Unlike to_string()
it does not perform any checks for internal null-bytes.
This function may be used to safely get binary data from Ruby.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello,\0World!");
assert_eq!(string.to_vec_u8_unchecked(), (b"Hello,\0World!").to_vec());
sourcepub fn to_str(&self) -> &str
pub fn to_str(&self) -> &str
Retrieves underlying &str
from Ruby String
object.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello, World!");
assert_eq!(string.to_str(), "Hello, World!");
Ruby:
str = 'Hello, World!'
str == 'Hello, World!'
sourcepub fn to_str_unchecked(&self) -> &str
pub fn to_str_unchecked(&self) -> &str
Retrieves underlying &str
from Ruby String
object.
Unlike to_str()
it does not perform any checks for internal null-bytes.
This function may be used to safely get binary data from Ruby.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello,\0World!");
assert_eq!(string.to_str_unchecked(), "Hello,\0World!");
Ruby:
str = 'Hello,\0World!'
str == 'Hello,\0World!'
sourcepub fn to_bytes_unchecked(&self) -> &[u8] ⓘ
pub fn to_bytes_unchecked(&self) -> &[u8] ⓘ
Retrieves underlying &[u8]
from Ruby String
object.
Unlike to_str()
it does not perform any checks for internal null-bytes.
This function may be used to safely get binary data from Ruby.
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello,\0World!");
assert_eq!(string.to_bytes_unchecked(), b"Hello,\0World!");
sourcepub fn codepoints(&self) -> Array
pub fn codepoints(&self) -> Array
Returns an array of each characters codepoints. This is useful as a strings encoding determines where the codepoints are.
Examples
use rutie::{Object, RString, Array, Fixnum, Encoding, EncodingSupport, VM};
VM::require("enc/encdb");
VM::require("enc/trans/transdb");
let string = RString::from_bytes(b"foo\x93_a", &Encoding::find("cp932").unwrap());
let codepoints: Array = [102, 111, 111, 37727, 97].
into_iter().map(|cp| Fixnum::new(*cp as i64).to_any_object()).collect();
assert!(string.codepoints().equals(&codepoints), "not equal!");
Ruby:
str = "foo\x93_a".force_encoding("cp932")
str.codepoints == [102, 111, 111, 37727, 97]
sourcepub fn bytesize(&self) -> i64
pub fn bytesize(&self) -> i64
Returns the length of the string in bytes
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello, World!");
let utf8_string = RString::new_utf8("⓯");
assert_eq!(string.bytesize(), 13);
assert_eq!(utf8_string.bytesize(), 3);
Ruby:
string = 'Hello, World!'
utf8_string = '⓯'
string.bytesize == 13
utf8_string.bytesize == 3
sourcepub fn count_chars(&self) -> i64
pub fn count_chars(&self) -> i64
Returns the number of characters in the string
Examples
use rutie::{RString, VM};
let string = RString::new_utf8("Hello, World!");
let utf8_string = RString::new_utf8("⓯");
assert_eq!(string.count_chars(), 13);
assert_eq!(utf8_string.count_chars(), 1);
Ruby:
string = 'Hello, World!'
utf8_string = '⓯'
string.length == 13
utf8_string.length == 1
sourcepub fn concat(&mut self, string: &str)
pub fn concat(&mut self, string: &str)
Appends a given string slice onto the end of this String.
Examples
use rutie::{RString, VM};
let mut string = RString::new_utf8("Hello, ");
string.concat("World!");
assert_eq!(string.to_string(), "Hello, World!".to_string());
Ruby:
str = 'Hello, '
str << 'World!'
str == 'Hello, World!'
Trait Implementations
sourceimpl EncodingSupport for RString
impl EncodingSupport for RString
sourcefn encoding(&self) -> Encoding
fn encoding(&self) -> Encoding
Get the strings Encoding
.
Examples
use rutie::{RString, VM, EncodingSupport};
let string = RString::new_utf8("Hello");
string.encoding();
Ruby:
string = "Hello"
string.encoding()
sourcefn force_encoding(&mut self, enc: Encoding) -> Result<Self, AnyException>
fn force_encoding(&mut self, enc: Encoding) -> Result<Self, AnyException>
Changes the encoding to encoding and returns Result<Self, AnyException>
.
Examples
use rutie::{RString, VM, EncodingSupport, Encoding};
let mut string = RString::new_utf8("Hello");
string.force_encoding(Encoding::us_ascii());
assert_eq!(string.encoding().name(), "US-ASCII");
Ruby:
string = "Hello"
string.force_encoding(Encoding::US_ASCII)
string.encoding.name == "US-ASCII"
sourcefn encode(&self, enc: Encoding, opts: Option<Hash>) -> Self
fn encode(&self, enc: Encoding, opts: Option<Hash>) -> Self
Transcodes to encoding and returns Self
.
Examples
use rutie::{RString, VM, EncodingSupport, Encoding};
let mut string = RString::new_utf8("Hello");
let result = string.encode(Encoding::us_ascii(), None);
assert_eq!(result.encoding().name(), "US-ASCII");
Ruby:
string = "Hello"
result = string.encode(Encoding::US_ASCII)
result.encoding.name == "US-ASCII"
sourcefn is_valid_encoding(&self) -> bool
fn is_valid_encoding(&self) -> bool
Transcodes to encoding and returns Self
.
Examples
use rutie::{RString, VM, EncodingSupport, Encoding, Object};
let mut string = RString::new_utf8("Hello");
assert!(string.is_valid_encoding(), "not valid encoding!");
VM::require("enc/encdb");
VM::require("enc/trans/transdb");
let result = VM::eval("'Hello'.force_encoding('UTF-32')").unwrap().
try_convert_to::<RString>().unwrap();
assert!(!result.is_valid_encoding(), "is valid encoding!");
Ruby:
string = "Hello"
string.valid_encoding? == true
result = string.encode(Encoding::UTF_32)
result.valid_encoding? == false
sourceimpl Object for RString
impl Object for RString
sourcefn singleton_class(&self) -> Class
fn singleton_class(&self) -> Class
sourcefn get_data<'a, T>(&'a self, wrapper: &'a dyn DataTypeWrapper<T>) -> &'_ T
fn get_data<'a, T>(&'a self, wrapper: &'a dyn DataTypeWrapper<T>) -> &'_ T
sourcefn get_data_mut<'a, T>(
&'a mut self,
wrapper: &'a dyn DataTypeWrapper<T>
) -> &'_ mut T
fn get_data_mut<'a, T>(
&'a mut self,
wrapper: &'a dyn DataTypeWrapper<T>
) -> &'_ mut T
sourcefn define_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
fn define_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
sourcefn define_private_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
fn define_private_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
sourcefn define_singleton_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
fn define_singleton_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
sourcefn def<I: Object, O: Object>(&mut self, name: &str, callback: Callback<I, O>)
fn def<I: Object, O: Object>(&mut self, name: &str, callback: Callback<I, O>)
define_method
(similar to Ruby syntax def some_method
).sourcefn def_private<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
fn def_private<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
define_private_method
(similar to Ruby syntax private def some_method
).sourcefn def_self<I: Object, O: Object>(&mut self, name: &str, callback: Callback<I, O>)
fn def_self<I: Object, O: Object>(&mut self, name: &str, callback: Callback<I, O>)
define_singleton_method
(similar to Ruby def self.some_method
).sourcefn send(&self, method: &str, arguments: Option<&[AnyObject]>) -> AnyObject
fn send(&self, method: &str, arguments: Option<&[AnyObject]>) -> AnyObject
Object#send
method Read moresourcefn respond_to(&self, method: &str) -> bool
fn respond_to(&self, method: &str) -> bool
sourcefn protect_send(
&self,
method: &str,
arguments: Option<&[AnyObject]>
) -> Result<AnyObject, AnyException>
fn protect_send(
&self,
method: &str,
arguments: Option<&[AnyObject]>
) -> Result<AnyObject, AnyException>
protect_send
returns Result<AnyObject, AnyObject> Read moresourcefn protect_public_send(
&self,
method: &str,
arguments: Option<&[AnyObject]>
) -> Result<AnyObject, AnyException>
fn protect_public_send(
&self,
method: &str,
arguments: Option<&[AnyObject]>
) -> Result<AnyObject, AnyException>
protect_public_send
returns Result<AnyObject, AnyObject> Read moresourcefn to_any_object(&self) -> AnyObject
fn to_any_object(&self) -> AnyObject
AnyObject
Read moresourcefn instance_variable_get(&self, variable: &str) -> AnyObject
fn instance_variable_get(&self, variable: &str) -> AnyObject
sourcefn instance_variable_set<T: Object>(
&mut self,
variable: &str,
value: T
) -> AnyObject
fn instance_variable_set<T: Object>(
&mut self,
variable: &str,
value: T
) -> AnyObject
sourceunsafe fn to<T: Object>(&self) -> T
unsafe fn to<T: Object>(&self) -> T
sourcefn try_convert_to<T: VerifiedObject>(&self) -> Result<T, AnyException>
fn try_convert_to<T: VerifiedObject>(&self) -> Result<T, AnyException>
sourceimpl TryConvert<AnyObject> for RString
impl TryConvert<AnyObject> for RString
Implicit or nil
conversion
Examples
use rutie::{RString, Fixnum, VM, TryConvert, NilClass, Object};
let four = Fixnum::new(4);
let result = RString::try_convert(four.to_any_object());
assert_eq!(result, Err(NilClass::new()));
let five = RString::new_utf8("5");
let result2 = RString::try_convert(five.to_any_object());
if let Ok(r) = result2 {
assert_eq!(r.to_str(), "5")
} else {
unreachable!()
}
Ruby:
four = 4
result = String.try_convert(four)
result == nil
five = "5"
result = String.try_convert(five)
result == "5"