5 // Paolo Molaro (lupus@ximian.com)
6 // Dan Lewis (dihlewis@yahoo.co.uk)
8 // (C) 2001 Ximian, Inc. http://www.ximian.com
12 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
14 // Permission is hereby granted, free of charge, to any person obtaining
15 // a copy of this software and associated documentation files (the
16 // "Software"), to deal in the Software without restriction, including
17 // without limitation the rights to use, copy, modify, merge, publish,
18 // distribute, sublicense, and/or sell copies of the Software, and to
19 // permit persons to whom the Software is furnished to do so, subject to
20 // the following conditions:
22 // The above copyright notice and this permission notice shall be
23 // included in all copies or substantial portions of the Software.
25 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
29 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
30 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
31 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
34 using System
.Runtime
.CompilerServices
;
35 using System
.Runtime
.InteropServices
;
39 public static class Buffer
{
41 public static int ByteLength (Array array
)
43 // note: the other methods in this class also use ByteLength to test for
44 // null and non-primitive arguments as a side-effect.
47 throw new ArgumentNullException ("array");
49 int length
= ByteLengthInternal (array
);
51 throw new ArgumentException (Locale
.GetText ("Object must be an array of primitives."));
56 public static byte GetByte (Array array
, int index
)
58 if (index
< 0 || index
>= ByteLength (array
))
59 throw new ArgumentOutOfRangeException ("index", Locale
.GetText(
60 "Value must be non-negative and less than the size of the collection."));
62 return GetByteInternal (array
, index
);
65 public static void SetByte (Array array
, int index
, byte value)
67 if (index
< 0 || index
>= ByteLength (array
))
68 throw new ArgumentOutOfRangeException ("index", Locale
.GetText(
69 "Value must be non-negative and less than the size of the collection."));
71 SetByteInternal (array
, index
, value);
74 public static void BlockCopy (Array src
, int srcOffset
, Array dst
, int dstOffset
, int count
)
77 throw new ArgumentNullException ("src");
80 throw new ArgumentNullException ("dst");
83 throw new ArgumentOutOfRangeException ("srcOffset", Locale
.GetText(
84 "Non-negative number required."));
87 throw new ArgumentOutOfRangeException ("dstOffset", Locale
.GetText (
88 "Non-negative number required."));
91 throw new ArgumentOutOfRangeException ("count", Locale
.GetText (
92 "Non-negative number required."));
94 // We do the checks in unmanaged code for performance reasons
95 bool res
= BlockCopyInternal (src
, srcOffset
, dst
, dstOffset
, count
);
97 // watch for integer overflow
98 if ((srcOffset
> ByteLength (src
) - count
) || (dstOffset
> ByteLength (dst
) - count
))
99 throw new ArgumentException (Locale
.GetText (
100 "Offset and length were out of bounds for the array or count is greater than " +
101 "the number of elements from index to the end of the source collection."));
106 [MethodImplAttribute (MethodImplOptions
.InternalCall
)]
107 private extern static int ByteLengthInternal (Array array
);
109 [MethodImplAttribute (MethodImplOptions
.InternalCall
)]
110 private extern static byte GetByteInternal (Array array
, int index
);
112 [MethodImplAttribute (MethodImplOptions
.InternalCall
)]
113 private extern static void SetByteInternal (Array array
, int index
, int value);
115 [MethodImplAttribute (MethodImplOptions
.InternalCall
)]
116 internal extern static bool BlockCopyInternal (Array src
, int src_offset
, Array dest
, int dest_offset
, int count
);