add trim

Author: szabgab

lib/Str.pod

@@ -291,4 +291,32 @@ Returns the codepoint number of the first character of the string
 
 Returns a list of codepoint numbers, one for each character in the string.
 
+=head2 trim
+
+    method trim(Str:D:) returns Str
+
+Remove leading and trailing white-spces. It can be use both as a method
+on strings and as a function. When used as a method it will return
+the trimmed string. In order to do in-place trimming, once needs to write
+C<.=trim>
+
+
+    my $line = '   hello world    ';
+    say '<' ~ $line.trim ~ '>';        # <hello world>
+    say '<' ~ trim($line) ~ '>';       # <hello world>
+    $line.trim;
+    say '<' ~ $line ~ '>';             # <   hello world    >
+    $line.=trim;
+    say '<' ~ $line ~ '>';             # <hello world>
+
+See also L<trim-trailing> and L<trim-leading>
+
+=head2 trim-trailing
+
+Remove the white-space charecters from the end of a string. See also L<trim>.
+
+=head2 trim-leading
+
+Remove the white-space charecters from the beginning of a string. See also L<trim>.
+
 =end pod