|
Ruby 4.1.0dev (2026-11-18 revision bcf3b03b44ae598e3adb59d359cf32202091a318)
|
Ruby's String. More...
#include <rstring.h>
Data Fields | |
| struct RBasic | basic |
| Basic part, including flags and class. | |
| rb_len_t | len |
| Length of the string, not including terminating NUL character. | |
| union { | |
| struct { | |
| char * ptr | |
| Pointer to the contents of the string. More... | |
| union { | |
| rb_len_t capa | |
| Capacity of *ptr. More... | |
| VALUE shared | |
| Parent of the string. More... | |
| } aux | |
| Auxiliary info. More... | |
| } heap | |
| Strings that use separated memory region for contents use this pattern. More... | |
| struct { | |
| char ary [1] | |
| } embed | |
| Embedded contents. More... | |
| } | as |
| String's specific fields. | |
Ruby's String.
A string in ruby conceptually has these information:
It is worth noting that a string is not an array of characters in ruby. It has never been. In 1.x a string was an array of integers. Since 2.x a string is no longer an array of anything. A string is a string – just like a Time is not an integer.
| union { ... } RString::as |
String's specific fields.
Referenced by rb_str_no_gvl_safe_acquire(), and rb_str_resize().
| union { ... } RString::aux |
Auxiliary info.
| struct RBasic RString::basic |
| rb_len_t RString::capa |
| struct { ... } RString::embed |
Embedded contents.
| struct { ... } RString::heap |
Strings that use separated memory region for contents use this pattern.
| rb_len_t RString::len |
| char* RString::ptr |
| VALUE RString::shared |
Parent of the string.
Nowadays strings can share their contents each other, constructing gigantic nest of objects. This situation is called "shared", and this is the field to control such properties.
Definition at line 240 of file rstring.h.
Referenced by rb_str_drop_bytes().