Unsafe.CopyBlockUnaligned Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| CopyBlockUnaligned(Byte, Byte, UInt32) |
Copies bytes from the source address to the destination address without assuming architecture dependent alignment of the addresses. |
| CopyBlockUnaligned(Void*, Void*, UInt32) |
Copies bytes from the source address to the destination address without assuming architecture dependent alignment of the addresses. |
- Source:
- Unsafe.cs
- Source:
- Unsafe.cs
- Source:
- Unsafe.cs
Important
This API is not CLS-compliant.
Copies bytes from the source address to the destination address without assuming architecture dependent alignment of the addresses.
public:
static void CopyBlockUnaligned(System::Byte % destination, System::Byte % source, System::UInt32 byteCount);[System.CLSCompliant(false)]
public static void CopyBlockUnaligned(ref byte destination, ref byte source, uint byteCount);public static void CopyBlockUnaligned(ref byte destination, ref byte source, uint byteCount);[<System.CLSCompliant(false)>]
static member CopyBlockUnaligned : byte * byte * uint32 -> unitstatic member CopyBlockUnaligned : byte * byte * uint32 -> unitPublic Shared Sub CopyBlockUnaligned (ByRef destination As Byte, ByRef source As Byte, byteCount As UInteger)Parameters
- destination
- Byte
The managed pointer corresponding to the destination address to copy to.
- source
- Byte
The managed pointer corresponding to the source address to copy from.
- byteCount
- UInt32
The number of bytes to copy.
- Attributes
Remarks
This API corresponds to the unaligned.1 cpblk opcode sequence. No alignment assumptions are made about the destination or source pointers. See ECMA-335, Sec. III.3.30 ("cpblk - copy data from memory to memory") and Sec. III.2.5 ("unaligned. (prefix) - pointer instruction might be unaligned") for more information.
Caution
This API is not intended for copying arbitrary-length runs of memory. Consider instead using MemoryCopy or CopyTo for this scenario.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6 (package-provided), 6, 7, 8, 9, 10 |
| .NET Standard | 2.0 (package-provided) |
- Source:
- Unsafe.cs
- Source:
- Unsafe.cs
- Source:
- Unsafe.cs
Important
This API is not CLS-compliant.
Copies bytes from the source address to the destination address without assuming architecture dependent alignment of the addresses.
public:
static void CopyBlockUnaligned(void* destination, void* source, System::UInt32 byteCount);[System.CLSCompliant(false)]
public static void CopyBlockUnaligned(void* destination, void* source, uint byteCount);public static void CopyBlockUnaligned(void* destination, void* source, uint byteCount);[<System.CLSCompliant(false)>]
static member CopyBlockUnaligned : nativeptr<unit> * nativeptr<unit> * uint32 -> unitstatic member CopyBlockUnaligned : nativeptr<unit> * nativeptr<unit> * uint32 -> unitParameters
- destination
- Void*
The unmanaged pointer corresponding to the destination address to copy to.
- source
- Void*
The unmanaged pointer corresponding to the source address to copy from.
- byteCount
- UInt32
The number of bytes to copy.
- Attributes
Remarks
This API corresponds to the unaligned.1 cpblk opcode sequence. No alignment assumptions are made about the destination or source pointers. See ECMA-335, Sec. III.3.30 ("cpblk - copy data from memory to memory") and Sec. III.2.5 ("unaligned. (prefix) - pointer instruction might be unaligned") for more information.
Caution
This API is not intended for copying arbitrary-length runs of memory. Consider instead using MemoryCopy or CopyTo for this scenario.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6 (package-provided), 6, 7, 8, 9, 10 |
| .NET Standard | 2.0 (package-provided) |
