Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(284)

Unified Diff: lib/src/base64/encoder.dart

Issue 1349373002: Improve the style of code in lib/. (Closed) Base URL: git@github.com:dart-lang/crypto.git@master
Patch Set: Code review changes Created 5 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « lib/src/base64/decoder_sink.dart ('k') | lib/src/base64/encoder_sink.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: lib/src/base64/encoder.dart
diff --git a/lib/src/base64/encoder.dart b/lib/src/base64/encoder.dart
new file mode 100644
index 0000000000000000000000000000000000000000..49c9fa8abfc6f764125ae2fbccc4c5f908aedf36
--- /dev/null
+++ b/lib/src/base64/encoder.dart
@@ -0,0 +1,151 @@
+// Copyright (c) 2015, 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.
+
+library crypto.base64.encoder;
+
+import 'dart:convert';
+
+import 'package:charcode/ascii.dart';
+
+import 'encoder_sink.dart';
+
+/// A String representing a mapping from numbers between 0 and 63, inclusive, to
+/// their corresponding encoded character.
+///
+/// This is the table for URL-safe encodings.
+const _encodeTableUrlSafe =
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+
+/// A String representing a mapping from numbers between 0 and 63, inclusive, to
+/// their corresponding encoded character.
+///
+/// This is the table for URL-unsafe encodings.
+const _encodeTable =
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+
+/// The line length for Base64 strings with line separators.
+const _lineLength = 76;
+
+/// An encoder that converts sequences of bytes to strings using [Base64][rfc].
+///
+/// [rfc]: https://tools.ietf.org/html/rfc4648
+class Base64Encoder extends Converter<List<int>, String> {
+ /// Whether this encoder generates URL-safe strings.
+ final bool _urlSafe;
+
+ /// Whether this encoder adds line breaks to the output.
+ final bool _addLineSeparator;
+
+ /// The sequence of bytes to use as a padding character.
+ final List<int> _pad;
+
+ /// Creates a new [Base64Encoder].
+ ///
+ /// The default [BASE64.encoder] will be good enough for most cases. A new
+ /// codec only needs to be instantiated when you want to do multiple
+ /// conversions with the same configuration.
+ ///
+ /// If [urlSafe] is `true`, a URL-safe alphabet will be used. Specifically,
+ /// the characters `-` and `_` will be used instead of `+` and `/`.
+ ///
+ /// If [addLineSeparator] is `true`, `\r\n` line separators will be added
+ /// every 76 characters.
+ ///
+ /// If [encodePaddingCharacter] is `true`, the padding character `=` will be
+ /// written as `%3D`.
+ const Base64Encoder(
+ {bool urlSafe: false,
+ bool addLineSeparator: false,
+ bool encodePaddingCharacter: false})
+ : _urlSafe = urlSafe,
+ _addLineSeparator = addLineSeparator,
+ _pad = encodePaddingCharacter
+ ? const [$percent, $3, $D]
+ : const [$equal];
+
+ /// Converts [bytes] to Base64.
+ ///
+ /// If [start] and [end] are provided, only the sublist `bytes.sublist(start,
+ /// end)` is converted.
+ String convert(List<int> bytes, [int start = 0, int end]) {
+ RangeError.checkValidRange(start, end, bytes.length);
+ if (end == null) end = bytes.length;
+
+ var length = end - start;
+ if (length == 0) return "";
+
+ var lookup = _urlSafe ? _encodeTableUrlSafe : _encodeTable;
+
+ // The total length of the 24-bit chunks.
+ var remainderLength = length.remainder(3);
+ var chunkLength = length - remainderLength;
+
+ // The size of the base output.
+ var baseOutputLength = (length ~/ 3) * 4;
+ var remainderOutputLength = remainderLength > 0 ? 3 + _pad.length : 0;
+
+ var outputLength = baseOutputLength + remainderOutputLength;
+ if (_addLineSeparator) {
+ // Add extra expected length to account for line separators.
+ outputLength += ((outputLength - 1) ~/ _lineLength) * 2;
+ }
+ var out = new List<int>(outputLength);
+
+ // Encode 24 bit chunks.
+ var input = start;
+ var output = 0;
+ var chunks = 0;
+ while (input < chunkLength) {
+ // Get a 24-bit chunk from the next three input bytes. Mask each byte to
+ // make sure we don't do something bad if the user passes in non-byte
+ // ints.
+ var chunk = (bytes[input++] << 16) & 0x00FF0000;
+ chunk |= (bytes[input++] << 8) & 0x0000FF00;
+ chunk |= bytes[input++] & 0x000000FF;
+
+ // Split the 24-bit chunk into four 6-bit sections to encode as
+ // characters.
+ out[output++] = lookup.codeUnitAt(chunk >> 18);
+ out[output++] = lookup.codeUnitAt((chunk >> 12) & 0x3F);
+ out[output++] = lookup.codeUnitAt((chunk >> 6) & 0x3F);
+ out[output++] = lookup.codeUnitAt(chunk & 0x3F);
+
+ // Add an optional line separator for every 76 characters we emit; that
+ // is, every 19 chunks.
+ chunks++;
+ if (_addLineSeparator && chunks == 19 && output < outputLength - 2) {
+ out[output++] = $cr;
+ out[output++] = $lf;
+ chunks = 0;
+ }
+ }
+
+ // If the input length isn't a multiple of 3, encode the remaining bytes and
+ // add padding.
+ if (remainderLength == 1) {
+ var byte = bytes[input];
+ out[output++] = lookup.codeUnitAt(byte >> 2);
+ out[output++] = lookup.codeUnitAt((byte << 4) & 0x3F);
+ out.setRange(output, output + _pad.length, _pad);
+ out.setRange(output + _pad.length, output + 2 * _pad.length, _pad);
+ } else if (remainderLength == 2) {
+ var byte1 = bytes[input++];
+ var byte2 = bytes[input];
+ out[output++] = lookup.codeUnitAt(byte1 >> 2);
+ out[output++] = lookup.codeUnitAt(((byte1 << 4) | (byte2 >> 4)) & 0x3F);
+ out[output++] = lookup.codeUnitAt((byte2 << 2) & 0x3F);
+ out.setRange(output, output + _pad.length, _pad);
+ }
+
+ return new String.fromCharCodes(out);
+ }
+
+ Base64EncoderSink startChunkedConversion(Sink<String> sink) {
+ StringConversionSink stringSink = sink is StringConversionSink
+ ? sink
+ : new StringConversionSink.from(sink);
+
+ return new Base64EncoderSink(stringSink, _urlSafe, _addLineSeparator);
+ }
+}
« no previous file with comments | « lib/src/base64/decoder_sink.dart ('k') | lib/src/base64/encoder_sink.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698