Array: Add to End/Add to Beginning of Array

In Xano, arrays are powerful data structures that allow you to store and manipulate lists of items. Whether you're working with simple scalar values like text or numbers, or more complex objects with key-value pairs, arrays provide a flexible way to organize and process your data. In this tutorial, we'll explore two handy functions for working with arrays: "add to end of array" and "add to beginning of array."

Adding Elements to the End of an Array

Let's start with the "add to end of array" function. As the name suggests, this function allows you to append a new element to the end of an existing array. Here's how you can use it:

1. In your Function Stack, locate the "Data Manipulation" section and expand the "Arrays" category.
2. Click on the "add to end of array" function.
3. On the right side, you'll see the function setup. First, you need to select an existing array variable from your Function Stack.
4. Next, provide the value you want to add to the end of the array. This can be another variable, an input field, or a static value.
5. Click "Save" to apply the changes.

For example, let's say you have an array variable called myArray that contains the elements ["A", "B", "C", "D"]. If you want to add the value "Michael" to the end of this array, you can use the "add to end of array" function like this:

input: Enter a value
value: {{input}}
myNewArray = addToEndOfArray(myArray, value)

When you run this function and enter "Michael" in the input field, the myNewArray variable will be updated to ["A", "B", "C", "D", "Michael"].

Adding Elements to the Beginning of an Array

The "add to beginning of array" function works similarly, but instead of appending the new element to the end of the array, it prepends it to the beginning. Here's how you can use it:

1. In your Function Stack, locate the "Data Manipulation" section and expand the "Arrays" category.
2. Click on the "add to beginning of array" function.
3. On the right side, you'll see the function setup. First, you need to select an existing array variable from your Function Stack.
4. Next, provide the value you want to add to the beginning of the array. This can be another variable, an input field, or a static value.
5. Click "Save" to apply the changes.

Using the same example from before, if you want to add the value "Michael" to the beginning of the myArray variable, you can use the "add to beginning of array" function like this:

input: Enter a value
value: {{input}}
myNewArray = addToBeginningOfArray(myArray, value)

When you run this function and enter "Michael" in the input field, the myNewArray variable will be updated to ["Michael", "A", "B", "C", "D"].

Alternative Methods: Array Filters

Xano also provides array filters that can achieve similar results to the "add to end of array" and "add to beginning of array" functions. Two commonly used filters are:

• push: Adds an element to the end of an array and returns the new array.
• unshift: Adds an element to the beginning of an array and returns the new array.

While these filters can be useful in certain situations, the dedicated "add to end of array" and "add to beginning of array" functions can be more convenient when working with loops, especially forEach loops, where you need to extract something from each item to create a new list.

Conclusion

Working with arrays is a common task in application development, and Xano provides several tools to help you manipulate and transform arrays efficiently. The "add to end of array" and "add to beginning of array" functions are powerful utilities that allow you to append or prepend elements to existing arrays, making it easier to create new lists or update existing ones. Whether you're a no-code enthusiast, a citizen developer, or a traditional developer, these functions can streamline your workflow and help you build and deploy applications faster with Xano.