docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method TryGetSingletonRW

    TryGetSingletonRW<T>(out RefRW<T>)

    Gets a reference to the value of a singleton component, and returns whether or not a singleton component of the specified type matches inside the EntityQuery. Note that if querying a singleton component from a system-associated entity, the query must include either EntityQueryOptions.IncludeSystems or the SystemInstance component.

    Declaration
    public bool TryGetSingletonRW<T>(out RefRW<T> value) where T : unmanaged, IComponentData
    Parameters
    Type Name Description
    RefRW<T> value

    The reference of the component

    Returns
    Type Description
    bool

    A reference to the singleton component.

    Type Parameters
    Name Description
    T

    The component type.

    Remarks

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

    Exceptions
    Type Condition
    InvalidOperationException

    Thrown if the number of entities that match this query is greater than one.

    See Also
    GetSingletonRW<T>()
    SetSingleton<T>(T)
    GetSingletonEntity()
    GetSingletonBuffer<T>(bool)
    GetSingleton<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)