mcs/class/corlib/System.Text/EncoderReplacementFallbackBuffer.cs

   1 //
   2 // EncoderReplacementFallbackBuffer.cs
   3 //
   4 // Author:
   5 //      Atsushi Enomoto <atsushi@ximian.com>
   6 //
   7
   8 //
   9 // Copyright (C) 2005 Novell, Inc (http://www.novell.com)
  10 //
  11 // Permission is hereby granted, free of charge, to any person obtaining
  12 // a copy of this software and associated documentation files (the
  13 // "Software"), to deal in the Software without restriction, including
  14 // without limitation the rights to use, copy, modify, merge, publish,
  15 // distribute, sublicense, and/or sell copies of the Software, and to
  16 // permit persons to whom the Software is furnished to do so, subject to
  17 // the following conditions:
  18 //
  19 // The above copyright notice and this permission notice shall be
  20 // included in all copies or substantial portions of the Software.
  21 //
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29 //
  30
  31 namespace System.Text
  32 {
  33         // This EncoderFallbackBuffer is simple. It ignores the input buffers.
  34         // EncoderFallbackBuffer users could implement their own complex
  35         // fallback buffers.
  36
  37         public sealed class EncoderReplacementFallbackBuffer
  38                 : EncoderFallbackBuffer
  39         {
  40                 string replacement;
  41                 int current;
  42                 bool fallback_assigned;
  43
  44                 public EncoderReplacementFallbackBuffer (
  45                         EncoderReplacementFallback fallback)
  46                 {
  47                         if (fallback == null)
  48                                 throw new ArgumentNullException ("fallback");
  49                         replacement = fallback.DefaultString;
  50                         current = 0;
  51                 }
  52
  53                 public override int Remaining {
  54                         get { return replacement.Length - current; }
  55                 }
  56
  57                 public override bool Fallback (char charUnknown, int index)
  58                 {
  59                         return Fallback (index);
  60                 }
  61
  62                 public override bool Fallback (char charUnknownHigh, char charUnknownLow, int index)
  63                 {
  64                         return Fallback (index);
  65                 }
  66
  67                 // hmm, what is this index for???
  68                 private bool Fallback (int index)
  69                 {
  70                         if (fallback_assigned && Remaining != 0)
  71                                 throw new ArgumentException ("Reentrant Fallback method invocation occured. It might be because either this FallbackBuffer is incorrectly shared by multiple threads, invoked inside Encoding recursively, or Reset invocation is forgotten.");
  72                         if (index < 0)
  73                                 throw new ArgumentOutOfRangeException ("index");
  74                         fallback_assigned = true;
  75                         current = 0;
  76
  77                         return replacement.Length > 0;
  78                 }
  79
  80                 public override char GetNextChar ()
  81                 {
  82                         if (current >= replacement.Length)
  83                                 return char.MinValue;
  84                         return replacement [current++];
  85                 }
  86
  87                 public override bool MovePrevious ()
  88                 {
  89                         if (current == 0)
  90                                 return false;
  91                         current--;
  92                         return true;
  93                 }
  94
  95                 public override void Reset ()
  96                 {
  97                         current = 0;
  98                 }
  99         }
 100 }
 101