Add base64 decoder and change existing base64 encoder.

sdk/lib/crypto/crypto_base.dart

 // Copyright (c) 2013, 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.crypto;
 
 /**
  * Interface for cryptographic hash functions.
  *
  * The [add] method is used to add data to the hash. The [close] method
@@ skipping 105 matching lines @@
 abstract class CryptoUtils {
   /**
    * Convert a list of bytes (for example a message digest) into a hex
    * string.
    */
   static String bytesToHex(List<int> bytes) {
     return _CryptoUtils.bytesToHex(bytes);
   }
 
   /**
-   * Converts a list of bytes (for example a message digest) into a
-   * base64 encoded string optionally broken up in to lines of
-   * [lineLength] chars separated by '\r\n'.
+   * Converts a list of bytes into a Base 64 encoded string.
+   *
+   * The list can be any list of integers in the range 0..255,
+   * for example a message digest.
+   *
+   * If [addLineSeparator] is true, the resulting string will  be
+   * broken into lines of 76 characters, separated by "\r\n".
+   *
+   * If [urlSafe] is true, the result is URL and filename safe.
+   *
+   * If [usePadding] is false, Extra padding characters ('=') are not

[floitsch, 2013/03/22 17:22:05]

If [usePadding] is false, no extra padding characters ('=') are appended to the
output.

[mdakin1, 2013/03/25 17:05:02]

Done.

+   * appended to output.
+   *
+   * Based on RFC 4648 http://tools.ietf.org/html/rfc4648
+   *
    */
-  static String bytesToBase64(List<int> bytes, [int lineLength]) {
-    return _CryptoUtils.bytesToBase64(bytes, lineLength);
+  static String bytesToBase64(List<int> bytes,
+                              {bool urlSafe : false,
+                               bool addLineSeparator : false,
+                               bool usePadding : true}) {
+    return _CryptoUtils.bytesToBase64(bytes,
+                                      urlSafe,
+                                      addLineSeparator,
+                                      usePadding);
   }
+
+
+  /**
+   * Converts a Base 64 encoded String into list of bytes.
+   *
+   * Decoder ignores "\r\n" sequences from input. By default it also ignores
+   * all illegal characters unless [ignoreErrors] is false.
+   *
+   * Accepts both URL safe and unsafe Base 64 encoded strings.
+   *
+   * Returns an empty list if [input] is null.

[floitsch, 2013/03/22 17:22:05]

Why not throw a null-pointer exception? (in which case we shouldn't say anything
about `null` in the comment.

[mdakin1, 2013/03/25 17:05:02]

Done, no mention of null anymore.

+   *
+   * Based on RFC 4648 http://tools.ietf.org/html/rfc4648
+   */
+  static List<int> base64StringToBytes(String input, {bool ignoreErrors : true}) {
+    return _CryptoUtils.base64StringToBytes(input, ignoreErrors);
+  }
+
 }
 
 /**
  * HashExceptions are thrown on invalid use of a Hash
  * object.
  */
 class HashException {
   HashException(String this.message);
   toString() => "HashException: $message";
   String message;
 }