Skip to content

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

License

Notifications You must be signed in to change notification settings

Varneon/VUdon-ArrayExtensions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VUdon - Array Extensions GitHub Repo stars GitHub all releases GitHub tag (latest SemVer)

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

  1. Download com.varneon.vudon.array-extensions.zip from here
  2. Unpack the .zip somewhere
  3. In VRChat Creator Companion, navigate to Settings > User Packages > Add
  4. Navigate to the unpacked folder, com.varneon.vudon.array-extensions and click Select Folder
  5. VUdon - Array Extensions should now be visible under Local User Packages in the project view in VRChat Creator Companion
  6. Click Add
  1. In the Unity toolbar, select Window > Package Manager > [+] > Add package from git URL...
  2. Paste the following link: https://github.com/Varneon/VUdon-ArrayExtensions.git?path=/Packages/com.varneon.vudon.array-extensions

Import from Unitypackage:

  1. Download latest com.varneon.vudon.array-extensions.unitypackage from here
  2. Import the downloaded .unitypackage into your Unity project

Developed by Varneon with ♥️

Twitter Follow YouTube Channel Subscribers GitHub followers

About

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

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages