Gemstone Common Library
Show/Hide TOC

# ArrayExtensionsCombine(Byte, Byte, Byte, Byte, Byte) Method

Combines buffers together as a single image.

## Definition

Namespace: Gemstone.ArrayExtensions
Assembly: Gemstone.Common (in Gemstone.Common.dll) Version: 1.0.175 -- Release Build+70cfebd19f80455d07e1cf93607e59f6af0e38f4
C#
View Source Request Example

    public static byte[] Combine(
    	this byte[] source,
    	byte[] other1,
    	byte[] other2,
    	byte[] other3,
    	byte[] other4
    )

VB
View Source Request Example

    <ExtensionAttribute>
    Public Shared Function Combine (
    	source As Byte(),
    	other1 As Byte(),
    	other2 As Byte(),
    	other3 As Byte(),
    	other4 As Byte()
    ) As Byte()

C++
View Source Request Example

    public:
    [ExtensionAttribute]
    static array<unsigned char>^ Combine(
    	array<unsigned char>^ source,
    	array<unsigned char>^ other1,
    	array<unsigned char>^ other2,
    	array<unsigned char>^ other3,
    	array<unsigned char>^ other4
    )

JavaScript
View Source Request Example

    Gemstone.ArrayExtensions.ArrayExtensions.Combine = function(source, other1, other2, other3, other4);

#### Parameters

source Byte
  Source buffer.
other1 Byte
  First buffer to combine to source buffer.
other2 Byte
  Second buffer to combine to source buffer.
other3 Byte
  Third buffer to combine to source buffer.
other4 Byte
  Fourth buffer to combine to source buffer.

#### Return Value

Byte
Combined buffers.

#### Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type Byte. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

## Remarks

Only use this function if you need a copy of the combined buffers, it will be optimal to use the Linq function ConcatTSource(IEnumerableTSource, IEnumerableTSource) if you simply need to iterate over the combined buffers.

## Exceptions

InvalidOperationException | Cannot create a byte array with more than 2,147,483,591 elements.

## See Also

#### Reference

ArrayExtensions Class
Combine Overload
Gemstone.ArrayExtensions Namespace