Big merge from experimental to bleeding edge.

sdk/lib/core/int.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.core;
 
 /**
  * Representation of Dart integers containing integer specific
  * operations and specialization of operations inherited from [num].
  *
@@ skipping 52 matching lines @@
 
   /**
    * Returns a representation of this [int] value.
    *
    * It should always be the case that if [:i:] is an [int] value,
    * then [:i == int.parse(i.toString()):].
    */
   String toString();
 
   /**
+   * Converts [this] to a string representation in the given [radix].
+   *
+   * In the string representation, lower-case letters are used for digits above
+   * '9'.
+   *
+   * The [radix] argument must be an integer in the range 2 to 36.
+   */
+  String toRadixString(int radix);
+
+  /**
    * Parse [source] as an integer literal and return its value.
    *
-   * Accepts "0x" prefix for hexadecimal numbers, otherwise defaults
-   * to base-10.
+   * The [radix] must be in the range 2..36. The digits used are
+   * first the decimal digits 0..9, and then the letters 'a'..'z'.
+   * Accepts capital letters as well.
    *
-   * Throws a [FormatException] if [source] is not a valid integer literal.
+   * If no [radix] is given then it defaults to 16 if the string starts
+   * with "0x", "-0x" or "+0x" and 10 otherwise.
+   *
+   * The [source] must be a non-empty sequence of base-[radix] digits,
+   * optionally prefixed with a minus or plus sign ('-' or '+').
+   *
+   * It must always be the case for an int [:n:] and radix [:r:] that
+   * [:n == parseRadix(n.toRadixString(r), r):].
+   *
+   * If the [source] is not a valid integer literal, optionally prefixed by a
+   * sign, the [onError] is called with the [source] as argument, and its return
+   * value is used instead. If no [onError] is provided, a [FormatException]
+   * is thrown.
    */
-  external static int parse(String source);
+  external static int parse(String source,
+                            { int radix,
+                              int onError(String source) });
 }