From 6fbe2dd36e30a2ecbfa770d3ebfbb8e601d97bd3 Mon Sep 17 00:00:00 2001 From: BurdetteLamar Date: Thu, 21 Aug 2025 17:36:09 -0500 Subject: [DOC] Tweaks for String#insert --- doc/string/insert.rdoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 doc/string/insert.rdoc (limited to 'doc') diff --git a/doc/string/insert.rdoc b/doc/string/insert.rdoc new file mode 100644 index 0000000000..d8252d5ec5 --- /dev/null +++ b/doc/string/insert.rdoc @@ -0,0 +1,16 @@ +Inserts the given +other_string+ into +self+; returns +self+. + +If the given +index+ is non-negative, inserts +other_string+ at offset +index+: + + 'foo'.insert(0, 'bar') # => "barfoo" + 'foo'.insert(1, 'bar') # => "fbaroo" + 'foo'.insert(3, 'bar') # => "foobar" + 'тест'.insert(2, 'bar') # => "теbarст" # Characters, not bytes. + 'こんにちは'.insert(2, 'bar') # => "こんbarにちは" + +If the +index+ is negative, counts backward from the end of +self+ +and inserts +other_string+ _after_ the offset: + + 'foo'.insert(-2, 'bar') # => "fobaro" + +Related: see {Modifying}[rdoc-ref:String@Modifying]. -- cgit v1.2.3