---
title: "SymbolInstanceArray | JavaScript maps SDK"
description: "Documentation for MapTiler SDK"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Class SymbolInstanceArray

#### Hierarchy ([View Summary](https://docs.maptiler.com/sdk-js/api-reference/hierarchy/#Externals.SymbolInstanceArray))

-   [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/)
    -   SymbolInstanceArray

##### Index

### Constructors[](#constructors)

[constructor](#constructor)

### Properties[](#properties)

[arrayBuffer](#arraybuffer) [bytesPerElement](#bytesperelement) [capacity](#capacity) [float32](#float32) [int16](#int16) [isTransferred](#istransferred) [length](#length) [members](#members) [uint16](#uint16) [uint32](#uint32) [uint8](#uint8)

### Methods[](#methods)

[clear](#clear) [emplace](#emplace) [emplaceBack](#emplaceback) [freeBufferAfterUpload](#freebufferafterupload) [get](#get) [reserve](#reserve) [resize](#resize) [deserialize](#deserialize) [serialize](#serialize)

## Constructors[](#constructors-1)

### constructor[](#constructor)

-   new SymbolInstanceArray(): SymbolInstanceArray[](#constructorsymbolinstancearray)
    
    #### Returns SymbolInstanceArray
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[constructor](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#constructor)
    

## Properties[](#properties-1)

### arrayBuffer[](#arraybuffer)

arrayBuffer: ArrayBuffer

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[arrayBuffer](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#arraybuffer)

### bytesPerElement[](#bytesperelement)

bytesPerElement: number

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[bytesPerElement](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#bytesperelement)

### capacity[](#capacity)

capacity: number

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[capacity](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#capacity)

### float32[](#float32)

float32: Float32Array

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[float32](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#float32)

### int16[](#int16)

int16: Int16Array

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[int16](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#int16)

### isTransferred[](#istransferred)

isTransferred: boolean

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[isTransferred](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#istransferred)

### length[](#length)

length: number

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[length](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#length)

### members[](#members)

members: [StructArrayMember](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.StructArrayMember/)\[\]

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[members](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#members)

### uint16[](#uint16)

uint16: Uint16Array

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[uint16](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#uint16)

### uint32[](#uint32)

uint32: Uint32Array

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[uint32](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#uint32)

### uint8[](#uint8)

uint8: Uint8Array

Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[uint8](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#uint8)

## Methods[](#methods-1)

### clear[](#clear)

-   clear(): void[](#clear-1)
    
    Resets the length of the array to 0 without de-allocating capacity.
    
    #### Returns void
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[clear](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#clear)
    

### emplace[](#emplace)

-   emplace(  
        i: number,  
        v0: number,  
        v1: number,  
        v2: number,  
        v3: number,  
        v4: number,  
        v5: number,  
        v6: number,  
        v7: number,  
        v8: number,  
        v9: number,  
        v10: number,  
        v11: number,  
        v12: number,  
        v13: number,  
        v14: number,  
        v15: number,  
        v16: number,  
        v17: number,  
        v18: number,  
        v19: number,  
        v20: number,  
        v21: number,  
        v22: number,  
        v23: number,  
        v24: number,  
        v25: number,  
        v26: number,  
        v27: number,  
    ): number[](#emplace-1)
    
    #### Parameters
    
    -   i: number
    -   v0: number
    -   v1: number
    -   v2: number
    -   v3: number
    -   v4: number
    -   v5: number
    -   v6: number
    -   v7: number
    -   v8: number
    -   v9: number
    -   v10: number
    -   v11: number
    -   v12: number
    -   v13: number
    -   v14: number
    -   v15: number
    -   v16: number
    -   v17: number
    -   v18: number
    -   v19: number
    -   v20: number
    -   v21: number
    -   v22: number
    -   v23: number
    -   v24: number
    -   v25: number
    -   v26: number
    -   v27: number
    
    #### Returns number
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[emplace](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#emplace)
    

### emplaceBack[](#emplaceback)

-   emplaceBack(  
        v0: number,  
        v1: number,  
        v2: number,  
        v3: number,  
        v4: number,  
        v5: number,  
        v6: number,  
        v7: number,  
        v8: number,  
        v9: number,  
        v10: number,  
        v11: number,  
        v12: number,  
        v13: number,  
        v14: number,  
        v15: number,  
        v16: number,  
        v17: number,  
        v18: number,  
        v19: number,  
        v20: number,  
        v21: number,  
        v22: number,  
        v23: number,  
        v24: number,  
        v25: number,  
        v26: number,  
        v27: number,  
    ): number[](#emplaceback-1)
    
    #### Parameters
    
    -   v0: number
    -   v1: number
    -   v2: number
    -   v3: number
    -   v4: number
    -   v5: number
    -   v6: number
    -   v7: number
    -   v8: number
    -   v9: number
    -   v10: number
    -   v11: number
    -   v12: number
    -   v13: number
    -   v14: number
    -   v15: number
    -   v16: number
    -   v17: number
    -   v18: number
    -   v19: number
    -   v20: number
    -   v21: number
    -   v22: number
    -   v23: number
    -   v24: number
    -   v25: number
    -   v26: number
    -   v27: number
    
    #### Returns number
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[emplaceBack](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#emplaceback)
    

### freeBufferAfterUpload[](#freebufferafterupload)

-   freeBufferAfterUpload(): void[](#freebufferafterupload-1)
    
    Replace the buffer with an empty one so typed views release the original ArrayBuffer for GC.
    
    #### Returns void
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[freeBufferAfterUpload](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#freebufferafterupload)
    

### get[](#get)

-   get(index: number): [SymbolInstanceStruct](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.SymbolInstanceStruct/)[](#get-1)
    
    Return the SymbolInstanceStruct at the given location in the array.
    
    #### Parameters
    
    -   index: number
        
        The index of the element.
        
    
    #### Returns [SymbolInstanceStruct](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.SymbolInstanceStruct/)
    

### reserve[](#reserve)

-   reserve(n: number): void[](#reserve-1)
    
    Indicate a planned increase in size, so that any necessary allocation may be done once, ahead of time.
    
    #### Parameters
    
    -   n: number
        
        The expected size of the array.
        
    
    #### Returns void
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[reserve](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#reserve)
    

### resize[](#resize)

-   resize(n: number): void[](#resize-1)
    
    Resize the array. If `n` is greater than the current length then additional elements with undefined values are added. If `n` is less than the current length then the array will be reduced to the first `n` elements.
    
    #### Parameters
    
    -   n: number
        
        The new size of the array.
        
    
    #### Returns void
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[resize](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#resize)
    

### `Static`deserialize[](#deserialize)

-   deserialize(input: [SerializedStructArray](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.SerializedStructArray/)): any[](#deserialize-1)
    
    #### Parameters
    
    -   input: [SerializedStructArray](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.SerializedStructArray/)
    
    #### Returns any
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[deserialize](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#deserialize)
    

### `Static`serialize[](#serialize)

-   serialize(  
        array: [StructArray](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArray/),  
        transferables?: [Transferable](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.Transferable/)\[\],  
    ): [SerializedStructArray](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.SerializedStructArray/)[](#serialize-1)
    
    Serialize a StructArray instance. Serializes both the raw data and the metadata needed to reconstruct the StructArray base class during deserialization.
    
    #### Parameters
    
    -   array: [StructArray](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArray/)
    -   `Optional`transferables: [Transferable](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.Transferable/)\[\]
    
    #### Returns [SerializedStructArray](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.SerializedStructArray/)
    
    Inherited from [StructArrayLayout8i15ui1ul2f2ui64](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/).[serialize](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.StructArrayLayout8i15ui1ul2f2ui64/#serialize)
