|
#define | RSTRING_EMBED_LEN_MAX ((mrb_int)(sizeof(void*) * 3 + sizeof(void*) - 32 / CHAR_BIT - 1)) |
|
#define | RSTR_SET_TYPE_FLAG(s, type) |
|
#define | RSTR_UNSET_TYPE_FLAG(s) |
|
#define | RSTR_EMBED_P(s) |
|
#define | RSTR_SET_EMBED_FLAG(s) |
|
#define | RSTR_UNSET_EMBED_FLAG(s) |
|
#define | RSTR_SET_EMBED_LEN(s, n) |
|
#define | RSTR_SET_LEN(s, n) |
|
#define | RSTR_EMBED_PTR(s) |
|
#define | RSTR_EMBED_LEN(s) |
|
#define | RSTR_EMBEDDABLE_P(len) |
|
#define | RSTR_PTR(s) |
|
#define | RSTR_LEN(s) |
|
#define | RSTR_CAPA(s) |
|
#define | RSTR_SHARED_P(s) |
|
#define | RSTR_SET_SHARED_FLAG(s) |
|
#define | RSTR_UNSET_SHARED_FLAG(s) |
|
#define | RSTR_FSHARED_P(s) |
|
#define | RSTR_SET_FSHARED_FLAG(s) |
|
#define | RSTR_UNSET_FSHARED_FLAG(s) |
|
#define | RSTR_NOFREE_P(s) |
|
#define | RSTR_SET_NOFREE_FLAG(s) |
|
#define | RSTR_UNSET_NOFREE_FLAG(s) |
|
#define | RSTR_ASCII_P(s) |
|
#define | RSTR_SET_ASCII_FLAG(s) |
|
#define | RSTR_UNSET_ASCII_FLAG(s) |
|
#define | RSTR_WRITE_ASCII_FLAG(s, v) |
|
#define | RSTR_COPY_ASCII_FLAG(dst, src) |
|
#define | mrb_str_ptr(s) |
| Returns a pointer from a Ruby string.
|
|
#define | RSTRING(s) |
|
#define | RSTRING_PTR(s) |
|
#define | RSTRING_EMBED_LEN(s) |
|
#define | RSTRING_LEN(s) |
|
#define | RSTRING_CAPA(s) |
|
#define | RSTRING_END(s) |
|
#define | RSTRING_CSTR(mrb, s) |
|
#define | MRB_STR_SHARED 1 |
|
#define | MRB_STR_FSHARED 2 |
|
#define | MRB_STR_NOFREE 4 |
|
#define | MRB_STR_EMBED 8 /* type flags up to here */ |
|
#define | MRB_STR_ASCII 16 |
|
#define | MRB_STR_EMBED_LEN_SHIFT 6 |
|
#define | MRB_STR_EMBED_LEN_BIT 5 |
|
#define | MRB_STR_EMBED_LEN_MASK (((1 << MRB_STR_EMBED_LEN_BIT) - 1) << MRB_STR_EMBED_LEN_SHIFT) |
|
#define | MRB_STR_TYPE_MASK 15 |
|
#define | mrb_str_index_lit(mrb, str, lit, off) |
|
#define | mrb_str_buf_new(mrb, capa) |
|
#define | mrb_string_value_ptr(mrb, str) |
|
#define | mrb_string_value_len(mrb, str) |
|
#define | mrb_str_strlen(mrb, s) |
|
#define | mrb_str_to_inum(mrb, str, base, badcheck) |
|
#define | mrb_str_cat_lit(mrb, str, lit) |
|
#define | mrb_str_cat2(mrb, str, ptr) |
|
#define | mrb_str_buf_cat(mrb, str, ptr, len) |
|
#define | mrb_str_buf_append(mrb, str, str2) |
|
|
void | mrb_str_modify (mrb_state *mrb, struct RString *s) |
|
void | mrb_str_modify_keep_ascii (mrb_state *mrb, struct RString *s) |
|
mrb_int | mrb_str_index (mrb_state *mrb, mrb_value str, const char *p, mrb_int len, mrb_int offset) |
| Finds the index of a substring in a string.
|
|
void | mrb_str_concat (mrb_state *mrb, mrb_value self, mrb_value other) |
| Appends self to other.
|
|
mrb_value | mrb_str_plus (mrb_state *mrb, mrb_value a, mrb_value b) |
| Adds two strings together.
|
|
mrb_value | mrb_ptr_to_str (mrb_state *mrb, void *p) |
| Converts pointer into a Ruby string.
|
|
mrb_value | mrb_obj_as_string (mrb_state *mrb, mrb_value obj) |
| Returns an object as a Ruby string.
|
|
mrb_value | mrb_str_resize (mrb_state *mrb, mrb_value str, mrb_int len) |
| Resizes the string's length.
|
|
mrb_value | mrb_str_substr (mrb_state *mrb, mrb_value str, mrb_int beg, mrb_int len) |
| Returns a sub string.
|
|
mrb_value | mrb_str_new_capa (mrb_state *mrb, mrb_int capa) |
|
const char * | mrb_string_cstr (mrb_state *mrb, mrb_value str) |
|
const char * | mrb_string_value_cstr (mrb_state *mrb, mrb_value *str) |
|
mrb_value | mrb_str_dup (mrb_state *mrb, mrb_value str) |
| Duplicates a string object.
|
|
mrb_value | mrb_str_intern (mrb_state *mrb, mrb_value self) |
| Returns a symbol from a passed in Ruby string.
|
|
mrb_value | mrb_str_to_integer (mrb_state *mrb, mrb_value str, mrb_int base, mrb_bool badcheck) |
|
double | mrb_str_to_dbl (mrb_state *mrb, mrb_value str, mrb_bool badcheck) |
|
mrb_bool | mrb_str_equal (mrb_state *mrb, mrb_value str1, mrb_value str2) |
| Returns true if the strings match and false if the strings don't match.
|
|
mrb_value | mrb_str_cat (mrb_state *mrb, mrb_value str, const char *ptr, size_t len) |
| Returns a concatenated string comprised of a Ruby string and a C string.
|
|
mrb_value | mrb_str_cat_cstr (mrb_state *mrb, mrb_value str, const char *ptr) |
| Returns a concatenated string comprised of a Ruby string and a C string.
|
|
mrb_value | mrb_str_cat_str (mrb_state *mrb, mrb_value str, mrb_value str2) |
|
mrb_value | mrb_str_append (mrb_state *mrb, mrb_value str, mrb_value str2) |
| Adds str2 to the end of str1.
|
|
int | mrb_str_cmp (mrb_state *mrb, mrb_value str1, mrb_value str2) |
| Returns 0 if both Ruby strings are equal.
|
|
char * | mrb_str_to_cstr (mrb_state *mrb, mrb_value str) |
| Returns a newly allocated C string from a Ruby string.
|
|
See Copyright Notice in mruby.h
Appends self to other.
Returns self as a concatenated string.
Example:
int
main(int argc,
char **argv)
{
// Variable declarations.
mrb_value str1;
mrb_value str2;
mrb_state *mrb = mrb_open();
if (!mrb)
{
// handle error
}
// Creates new Ruby strings.
str1 = mrb_str_new_lit(mrb, "abc");
str2 = mrb_str_new_lit(mrb, "def");
// Concatenates str2 to str1.
mrb_str_concat(mrb, str1, str2);
// Prints new Concatenated Ruby string.
mrb_p(mrb, str1);
mrb_close(mrb);
return 0;
}
Result:
=> "abcdef"
- Parameters
-
mrb | The current mruby state. |
self | String to concatenate. |
other | String to append to self. |
- Returns
- [mrb_value] Returns a new String appending other to self.
Adds two strings together.
Example:
int
main(int argc,
char **argv)
{
// Variable declarations.
mrb_value a;
mrb_value b;
mrb_value c;
mrb_state *mrb = mrb_open();
if (!mrb)
{
// handle error
}
// Creates two Ruby strings from the passed in C strings.
a = mrb_str_new_lit(mrb, "abc");
b = mrb_str_new_lit(mrb, "def");
// Prints both C strings.
mrb_p(mrb, a);
mrb_p(mrb, b);
// Concatenates both Ruby strings.
c = mrb_str_plus(mrb, a, b);
// Prints new Concatenated Ruby string.
mrb_p(mrb, c);
mrb_close(mrb);
return 0;
}
Result:
=> "abc" # First string
=> "def" # Second string
=> "abcdef" # First & Second concatenated.
- Parameters
-
mrb | The current mruby state. |
a | First string to concatenate. |
b | Second string to concatenate. |
- Returns
- [mrb_value] Returns a new String containing a concatenated to b.
Resizes the string's length.
Returns the amount of characters in the specified by len.
Example:
int
main(int argc,
char **argv)
{
// Variable declaration.
mrb_value str;
mrb_state *mrb = mrb_open();
if (!mrb)
{
// handle error
}
// Creates a new string.
str = mrb_str_new_lit(mrb, "Hello, world!");
// Returns 5 characters of
mrb_str_resize(mrb, str, 5);
mrb_p(mrb, str);
mrb_close(mrb);
return 0;
}
Result:
=> "Hello"
- Parameters
-
mrb | The current mruby state. |
str | The Ruby string to resize. |
len | The length. |
- Returns
- [mrb_value] An object as a Ruby string.
Returns a sub string.
Example:
int
main(int argc,
char const **argv)
{
// Variable declarations.
mrb_value str1;
mrb_value str2;
mrb_state *mrb = mrb_open();
if (!mrb)
{
// handle error
}
// Creates new string.
str1 = mrb_str_new_lit(mrb, "Hello, world!");
// Returns a sub-string within the range of 0..2
str2 = mrb_str_substr(mrb, str1, 0, 2);
// Prints sub-string.
mrb_p(mrb, str2);
mrb_close(mrb);
return 0;
}
Result:
=> "He"
- Parameters
-
mrb | The current mruby state. |
str | Ruby string. |
beg | The beginning point of the sub-string. |
len | The end point of the sub-string. |
- Returns
- [mrb_value] An object as a Ruby sub-string.