./src/share/classes/java/lang/String.java

rev 5707 : [mq]: StringRepeat

*** 2360,2369 ****
--- 2360,2385 ----
      public String[] split(String regex) {
          return split(regex, 0);
      }
  
      /**
+      * Set the value of this {@code String} to {@code n} concatenated copies of the
+      * current value.  If {@code n == 0}, then set the value to the empty string.
+      * 
+      * @param n the number of times to add the current value
+      * @return a reference to this String
+      * @throws IllegalArgumentException if n < 0
+      * @since 1.8
+      */
+     public String repeat( int n ) {
+         if (n < 0) {
+             throw new IllegalArgumentException( "n < 0");
+         }
+         return new StringBuilder().append(n, this).toString();
+     }
+ 
+     /**
       * Converts all of the characters in this {@code String} to lower
       * case using the rules of the given {@code Locale}.  Case mapping is based
       * on the Unicode Standard version specified by the {@link java.lang.Character Character}
       * class. Since case mappings are not always 1:1 char mappings, the resulting
       * {@code String} may be a different length than the original {@code String}.