Str.substr, Str.encode, Buf.decode

Author: moritz

lib/Buf.pod

@@ -5,7 +5,8 @@
     class Buf does Positional { ... }
 
 A C<Buf> (short for buffer) is a binary string, and generally returned from
-low-level IO operations. In the abstract it is just a list of integers, so
+low-level IO operations or from C<Str.encode>. In the abstract it is just
+a list of integers, so
 for example indexing into a C<Buf> with C<.[$idx]> returns an C<Int>.
 
 =head2 Methods
@@ -28,4 +29,10 @@ Returns C<False> if and only if the buffer is empty.
 
 Returns the number of elements of the buffer.
 
+=head3 decode
+
+    multi method decode(Buf:D: Str:D $encoding = 'UTF-8') returns Str:D
+
+Applies an encoding to turn the buffer into a C<Str>
+
 =end pod

lib/Str.pod

@@ -234,6 +234,14 @@ Examples:
     multi sub    substr(Str:D $s, Int:D $from, Int:D $chars = $s.chars - $from) returns Str:D
     multi method substr(Str:D $s: Int:D $from, Int:D $chars = $s.chars - $from) returns Str:D
 
-TODO
+Returns a part of the string, starting from the character with index C<$from>
+(where the first character has index 0) and with length C<$chars>.
+
+=head3 encode
+
+    multi method encode(Str:D: Str:D $encoding = 'UTF-8') returns Buf:D
+
+Returns a buffer (ie a binary representation) of the string in the given
+encoding.
 
 =end pod