File: //usr/share/ri/3.0.0/system/String/succ-i.ri
U:RDoc::AnyMethod[iI" succ:ETI"String#succ;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [I"EReturns the successor to +self+. The successor is calculated by ;TI"incrementing characters.;To:RDoc::Markup::BlankLine o;
; [I"JThe first character to be incremented is the rightmost alphanumeric: ;TI"6or, if no alphanumerics, the rightmost character:;To:RDoc::Markup::Verbatim; [I"#'THX1138'.succ # => "THX1139"
;TI"''<<koala>>'.succ # => "<<koalb>>"
;TI"'***'.succ # => '**+'
;T:@format0o;
; [I"LThe successor to a digit is another digit, "carrying" to the next-left ;TI"Jcharacter for a "rollover" from 9 to 0, and prepending another digit ;TI"if necessary:;To;; [I"'00'.succ # => "01"
;TI"'09'.succ # => "10"
;TI"'99'.succ # => "100"
;T;
0o;
; [I"CThe successor to a letter is another letter of the same case, ;TI"9carrying to the next-left character for a rollover, ;TI":and prepending another same-case letter if necessary:;To;; [I"'aa'.succ # => "ab"
;TI"'az'.succ # => "ba"
;TI"'zz'.succ # => "aaa"
;TI"'AA'.succ # => "AB"
;TI"'AZ'.succ # => "BA"
;TI"'ZZ'.succ # => "AAA"
;T;
0o;
; [ I"IThe successor to a non-alphanumeric character is the next character ;TI";in the underlying character set's collating sequence, ;TI"9carrying to the next-left character for a rollover, ;TI"3and prepending another character if necessary:;To;; [I"s = 0.chr * 3
;TI"s # => "\x00\x00\x00"
;TI" s.succ # => "\x00\x00\x01"
;TI"s = 255.chr * 3
;TI"s # => "\xFF\xFF\xFF"
;TI"$s.succ # => "\x01\x00\x00\x00"
;T;
0o;
; [I"NCarrying can occur between and among mixtures of alphanumeric characters:;To;; [ I"s = 'zz99zz99'
;TI"s.succ # => "aaa00aa00"
;TI"s = '99zz99zz'
;TI"s.succ # => "100aa00aa"
;T;
0o;
; [I">The successor to an empty \String is a new empty \String:;To;; [I"''.succ # => ""
;T;
0o;
; [I"-String#next is an alias for String#succ.;T:
@fileI"
string.c;T:0@omit_headings_from_table_of_contents_below0I"string.succ -> new_str
;T0[[I" next;T@ I"();T@PFI"String;TcRDoc::NormalClass00