---
name: "Array.unshift"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Array.unshift"
---

# Array.unshift(3kaya)

Add a value onto the start of an array.

## NAME

Array::unshift - Add a value onto the start of an array.

## SYNOPSIS

**Void unshift(** *a val, var \[a\] array* **)**

## ARGUMENTS

**val** The value to unshift

**array** The array

## DESCRIPTION

Add a value onto the start of an array.

-

   array = \[1,2,3\];\
    unshift(array,4);\
    // array = \[4,1,2,3\]

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Array.addAt (3kaya)**

**Array.push (3kaya)**

**Array.pop (3kaya)**

**Array.shift (3kaya)**