VUdon - Array Extensions

Collection of array extension methods compatible with UdonSharp 1.x which adds partial feature set from List

Method	Parameters	Returns	Description
`Add`	`T`	`T[]`	Adds an item to an array
`AddRange`	`T[]`	`T[]`	Adds the elements of the specified collection to the end of the array
`AddUnique`	`T`	`T[]`	Adds an item to an array and ensures duplicates are not added
`Contains`	`T`	`bool`	Determines whether an element is in the array
`FirstOrDefault`		`T`	Returns the first element, or default value if the array is empty
`GetElementTypeUdon`		`Type`	Gets the element type of the array type
`GetRange`	`Int, Int`	`T[]`	Creates a shallow copy of a range of elements in the source
`IndexOf`	`T` (`Int`, `Int`)	`Int`	Returns the zero-based index of the first occurrence of a value in the T[]
`Insert`	`Int, T`	`T[]`	Inserts item to array at index
`InsertRange`	`Int, T[]`	`T[]`	Inserts the elements of a collection into the [] at the specified index
`LastIndexOf`	`T` (`Int`, `Int`)	`Int`	Returns the zero-based index of the last occurrence of a value in the T[]
`LastOrDefault`		`T`	Returns the last element, or default value if the array is empty
`Remove`	`T`	`T[]`	Removes item from array
`RemoveAt`	`Int`	`T[]`	Removes item at index from array
`RemoveRange`	`Int, Int`	`T[]`	Removes a range of elements from the T[]
`Resize`	`Int`	`T[]`	Resizes array
`Reverse`		`T[]`	Reverses Array

⚠️ For performance reasons this extension method library doesn't implement null checks! Please ensure the arrays you're accessing with the methods from this library are initialized.

Usage Demonstration

using UdonSharp;
using UnityEngine;
using Varneon.VUdon.ArrayExtensions;

public class UdonArrayExtensionDemo : UdonSharpBehaviour
{
    [SerializeField]
    private string[] strings;

    [SerializeField]
    private string[] range;

    [SerializeField]
    private string text;

    [SerializeField]
    private int index;

    [SerializeField]
    private int count;

    public void UsageDemo()
    {
        // Add item to array
        strings = strings.Add(text);

        // Add range of elements to array
        strings = strings.AddRange(range);
        
        // Check if item is contained in array
        Debug.Log(strings.Contains(text));

        // Get range of elements in array
        Debug.Log(string.Join("\n", strings.GetRange(index, count)));

        // Get the first index of element in array
        Debug.Log(strings.IndexOf(text));

        // Get the first index of element in array, starting at index
        Debug.Log(strings.IndexOf(text, index));

        // Get the first index of element in array in a range starting at index at the size of count
        Debug.Log(strings.IndexOf(text, index, count));

        // Insert item to array
        strings = strings.Insert(index, text);

        // Insert array of items to array
        strings = strings.InsertRange(index, range);

        // Get the last index of element in array
        Debug.Log(strings.LastIndexOf(text));

        // Get the last index of element in array, starting at index
        Debug.Log(strings.LastIndexOf(text, index));

        // Get the last index of element in array in a range starting at index at the size of count
        Debug.Log(strings.LastIndexOf(text, index, count));

        // Remove item from array
        strings = strings.Remove(text);

        // Remove item at index from array
        strings = strings.RemoveAt(index);

        // Remove range of elements from array
        strings = strings.RemoveRange(index, count);

        // Reverse array
        strings = strings.Reverse();

        // Get the first element in array
        Debug.Log(strings.FirstOrDefault());

        // Get the last element in array
        Debug.Log(strings.LastOrDefault());

        // Get the element type of a type
        Debug.Log(strings.GetType().GetElementTypeUdon());

        // Add unique item to array (if item exists in array, it won't be added)
        strings = strings.AddUnique(text);

        // Resize array
        strings = strings.Resize(index);
    }
}

Installation

Import with VRChat Creator Companion:

Download com.varneon.vudon.array-extensions.zip from here

Unpack the .zip somewhere

In VRChat Creator Companion, navigate to Settings > User Packages > Add

Navigate to the unpacked folder, com.varneon.vudon.array-extensions and click Select Folder

VUdon - Array Extensions should now be visible under Local User Packages in the project view in VRChat Creator Companion

Click Add

Import with Unity Package Manager (git):

In the Unity toolbar, select Window > Package Manager > [+] > Add package from git URL...

Paste the following link: https://github.com/Varneon/VUdon-ArrayExtensions.git?path=/Packages/com.varneon.vudon.array-extensions

Import from Unitypackage:

Download latest com.varneon.vudon.array-extensions.unitypackage from here

Import the downloaded .unitypackage into your Unity project

varneon / vudon-arrayextensions Goto Github PK

vudon-arrayextensions's Introduction

VUdon - Array Extensions

⚠️ For performance reasons this extension method library doesn't implement null checks! Please ensure the arrays you're accessing with the methods from this library are initialized.

Usage Demonstration

Installation

Import with VRChat Creator Companion:

Import with Unity Package Manager (git):

Import from Unitypackage:

Developed by Varneon with ♥️

vudon-arrayextensions's People

Contributors

Stargazers

Watchers

vudon-arrayextensions's Issues

Recommend Projects

Recommend Topics

Recommend Org