Change IllegalArgumentException to ArgumentError.

lib/utf/utf16.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.
 
 
 /**
  * Decodes the UTF-16 bytes as an iterable. Thus, the consumer can only convert
  * as much of the input as needed. Determines the byte order from the BOM,
  * or uses big-endian as a default. This method always strips a leading BOM.
- * Set the [replacementCodepoint] to null to throw an IllegalArgumentException
+ * Set the [replacementCodepoint] to null to throw an ArgumentError
  * rather than replace the bad value. The default value for
  * [replacementCodepoint] is U+FFFD.
  */
 IterableUtf16Decoder decodeUtf16AsIterable(List<int> bytes, [int offset = 0,
     int length, int replacementCodepoint =
     UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   return new IterableUtf16Decoder._(
       () => new Utf16BytesToCodeUnitsDecoder(bytes, offset, length,
       replacementCodepoint), replacementCodepoint);
 }
 
 /**
  * Decodes the UTF-16BE bytes as an iterable. Thus, the consumer can only
  * convert as much of the input as needed. This method strips a leading BOM by
  * default, but can be overridden by setting the optional parameter [stripBom]
  * to false. Set the [replacementCodepoint] to null to throw an
- * IllegalArgumentException rather than replace the bad value. The default
+ * ArgumentError rather than replace the bad value. The default
  * value for the [replacementCodepoint] is U+FFFD.
  */
 IterableUtf16Decoder decodeUtf16beAsIterable(List<int> bytes, [int offset = 0,
     int length, bool stripBom = true, int replacementCodepoint =
     UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   return new IterableUtf16Decoder._(
       () => new Utf16beBytesToCodeUnitsDecoder(bytes, offset, length, stripBom,
       replacementCodepoint), replacementCodepoint);
 }
 
 /**
  * Decodes the UTF-16LE bytes as an iterable. Thus, the consumer can only
  * convert as much of the input as needed. This method strips a leading BOM by
  * default, but can be overridden by setting the optional parameter [stripBom]
  * to false. Set the [replacementCodepoint] to null to throw an
- * IllegalArgumentException rather than replace the bad value. The default
+ * ArgumentError rather than replace the bad value. The default
  * value for the [replacementCodepoint] is U+FFFD.
  */
 IterableUtf16Decoder decodeUtf16leAsIterable(List<int> bytes, [int offset = 0,
     int length, bool stripBom = true, int replacementCodepoint =
     UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   return new IterableUtf16Decoder._(
       () => new Utf16leBytesToCodeUnitsDecoder(bytes, offset, length, stripBom,
       replacementCodepoint), replacementCodepoint);
 }
 
 /**
  * Produce a String from a sequence of UTF-16 encoded bytes. This method always
  * strips a leading BOM. Set the [replacementCodepoint] to null to throw  an
- * IllegalArgumentException rather than replace the bad value. The default
+ * ArgumentError rather than replace the bad value. The default
  * value for the [replacementCodepoint] is U+FFFD.
  */
 String decodeUtf16(List<int> bytes, [int offset = 0, int length,
     int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   Utf16BytesToCodeUnitsDecoder decoder = new Utf16BytesToCodeUnitsDecoder(bytes,
       offset, length, replacementCodepoint);
   List<int> codeunits = decoder.decodeRest();
   // TODO is16BitCodeUnit() is used to work around a bug with dart2js
   // (http://code.google.com/p/dart/issues/detail?id=1357). Consider
   // removing after this issue is resolved.
   if (_is16BitCodeUnit()) {
     return new String.fromCharCodes(codeunits);
   } else {
     return new String.fromCharCodes(
         _utf16CodeUnitsToCodepoints(codeunits, 0, null, replacementCodepoint));
   }
 }
 
 /**
  * Produce a String from a sequence of UTF-16BE encoded bytes. This method
  * strips a leading BOM by default, but can be overridden by setting the
  * optional parameter [stripBom] to false. Set the [replacementCodepoint] to
- * null to throw an IllegalArgumentException rather than replace the bad value.
+ * null to throw an ArgumentError rather than replace the bad value.
  * The default value for the [replacementCodepoint] is U+FFFD.
  */
 String decodeUtf16be(List<int> bytes, [int offset = 0, int length,
     bool stripBom = true,
     int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   List<int> codeunits = (new Utf16beBytesToCodeUnitsDecoder(bytes, offset,
       length, stripBom, replacementCodepoint)).decodeRest();
   // TODO is16BitCodeUnit() is used to work around a bug with dart2js
   // (http://code.google.com/p/dart/issues/detail?id=1357). Consider
   // removing after this issue is resolved.
   if (_is16BitCodeUnit()) {
     return new String.fromCharCodes(codeunits);
   } else {
     return new String.fromCharCodes(
         _utf16CodeUnitsToCodepoints(codeunits, 0, null, replacementCodepoint));
   }
 }
 
 /**
  * Produce a String from a sequence of UTF-16LE encoded bytes. This method
  * strips a leading BOM by default, but can be overridden by setting the
  * optional parameter [stripBom] to false. Set the [replacementCodepoint] to
- * null to throw an IllegalArgumentException rather than replace the bad value.
+ * null to throw an ArgumentError rather than replace the bad value.
  * The default value for the [replacementCodepoint] is U+FFFD.
  */
 String decodeUtf16le(List<int> bytes, [int offset = 0, int length,
     bool stripBom = true,
     int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   List<int> codeunits = (new Utf16leBytesToCodeUnitsDecoder(bytes, offset,
       length, stripBom, replacementCodepoint)).decodeRest();
   // TODO is16BitCodeUnit() is used to work around a bug with dart2js
   // (http://code.google.com/p/dart/issues/detail?id=1357). Consider
   // removing after this issue is resolved.
@@ skipping 163 matching lines @@
   }
 
   bool hasNext() => utf16EncodedBytesIterator.hasNext();
 
   int next() {
     if (utf16EncodedBytesIterator.remaining < 2) {
       utf16EncodedBytesIterator.next();
       if (replacementCodepoint != null) {
         return replacementCodepoint;
       } else {
-        throw new IllegalArgumentException(
+        throw new ArgumentError(
             "Invalid UTF16 at ${utf16EncodedBytesIterator.position}");
       }
     } else {
       return decode();
     }
   }
 
   int get position => utf16EncodedBytesIterator.position ~/ 2;
 
   void backup([int by = 1]) {
@@ skipping 45 matching lines @@
       skip();
     }
   }
 
   int decode() {
     int lo = utf16EncodedBytesIterator.next();
     int hi = utf16EncodedBytesIterator.next();
     return (hi << 8) + lo;
   }
 }