VOOZH about

URL: https://apidock.com/ruby/String/next

⇱ String#next - APIdock

method

next

ruby latest stable - Class: String
next()
public

Returns the successor to str. The successor is calculated by incrementing characters starting from the rightmost alphanumeric (or the rightmost character if there are no alphanumerics) in the string. Incrementing a digit always results in another digit, and incrementing a letter results in another letter of the same case. Incrementing nonalphanumerics uses the underlying character set’s collating sequence.

If the increment generates a “carry,” the character to the left of it is incremented. This process repeats until there is no carry, adding an additional character if necessary.

"abcd".succ #=> "abce"
"THX1138".succ #=> "THX1139"
"<<koala>>".succ #=> "<<koalb>>"
"1999zzz".succ #=> "2000aaa"
"ZZZ9999".succ #=> "AAAA0000"
"***".succ #=> "**+"
VALUE
rb_str_succ(VALUE orig)
{
 VALUE str;
 str = rb_str_new_with_class(orig, RSTRING_PTR(orig), RSTRING_LEN(orig));
 rb_enc_cr_str_copy_for_substr(str, orig);
 OBJ_INFECT(str, orig);
 return str_succ(str);
}

Related methods