docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method TryGetSingleton

    TryGetSingleton<T>(EntityQuery, out T)

    Gets the value of a singleton component, for read/write access.

    Declaration
    public static bool TryGetSingleton<T>(this EntityQuery query, out T value) where T : class
    Parameters
    Type Name Description
    EntityQuery query

    The query

    T value

    The component.

    Returns
    Type Description
    bool

    A copy of the singleton component.

    Type Parameters
    Name Description
    T

    The component type. This type must not implement IEnableableComponent.

    Remarks

    A singleton component is a component of which only one instance exists that satisfies this query.

    Exceptions
    Type Condition
    InvalidOperationException

    Thrown if the singleton is zero-size, or if it implements an enableable component.

    See Also
    GetSingleton<T>(EntityQuery)
    GetSingletonRW<T>(EntityQuery)
    GetSingleton<T>()
    GetSingletonRW<T>()
    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)