docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method Has

    Has<T>(ref ComponentTypeHandle<T>)

    Reports whether this chunk contains the specified component type.

    Declaration
    public readonly bool Has<T>(ref ComponentTypeHandle<T> typeHandle) where T : IComponentData, new()
    Parameters
    Type Name Description
    ComponentTypeHandle<T> typeHandle

    An object containing type and job safety information. To create this object, call GetComponentTypeHandle<T>(bool). Pass the object to a job using a public field you define as part of the job struct.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the specified component type.

    Type Parameters
    Name Description
    T

    The data type of the component.

    Remarks

    When an EntityQuery includes optional components (using WithAny<T1>()), some chunks returned by the query may contain such components and some may not. Use this function to determine whether or not the current chunk contains one of these optional component types.

    Has<T>(ComponentTypeHandle<T>)

    Obsolete. Use Has<T>(ref ComponentTypeHandle<T>) instead.

    Declaration
    [Obsolete("The typeHandle argument should now be passed by ref. (RemovedAfter Entities 1.0)", false)]
    public readonly bool Has<T>(ComponentTypeHandle<T> typeHandle) where T : IComponentData, new()
    Parameters
    Type Name Description
    ComponentTypeHandle<T> typeHandle

    An object containing type and job safety information. To create this object, call GetComponentTypeHandle<T>(bool). Pass the object to a job using a public field you define as part of the job struct.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the specified component type.

    Type Parameters
    Name Description
    T

    The data type of the component.

    Has<T>()

    Reports whether this chunk contains the specified component type.

    Declaration
    public readonly bool Has<T>()
    Returns
    Type Description
    bool

    True, if this chunk contains an array of the specified component type.

    Type Parameters
    Name Description
    T

    The data type of the component.

    Remarks

    When an EntityQuery includes optional components (using WithAny<T1>()), some chunks returned by the query may contain such components and some may not. Use this function to determine whether or not the current chunk contains one of these optional component types.

    Has(ref DynamicComponentTypeHandle)

    Reports whether this chunk contains the specified component type.

    Declaration
    public readonly bool Has(ref DynamicComponentTypeHandle typeHandle)
    Parameters
    Type Name Description
    DynamicComponentTypeHandle typeHandle

    Type handle for the component type to query.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the specified component type.

    Has(DynamicComponentTypeHandle)

    Obsolete. Use Has(ref DynamicComponentTypeHandle) instead.

    Declaration
    [Obsolete("The typeHandle argument should now be passed by ref. (RemovedAfter Entities 1.0)", false)]
    public readonly bool Has(DynamicComponentTypeHandle typeHandle)
    Parameters
    Type Name Description
    DynamicComponentTypeHandle typeHandle

    Type handle for the component type to query.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the specified component type.

    Has<T>(SharedComponentTypeHandle<T>)

    Reports whether this chunk contains a shared component of the specified component type.

    Declaration
    public readonly bool Has<T>(SharedComponentTypeHandle<T> typeHandle) where T : struct, ISharedComponentData
    Parameters
    Type Name Description
    SharedComponentTypeHandle<T> typeHandle

    An object containing type and job safety information. To create this object, call GetSharedComponentTypeHandle<T>(). Pass the object to a job using a public field you define as part of the job struct.

    Returns
    Type Description
    bool

    True, if this chunk contains a shared component of the specified type.

    Type Parameters
    Name Description
    T

    The data type of the shared component.

    Remarks

    When an EntityQuery includes optional components used as shared components (with WithAny<T1>()), some chunks returned by the query may have these shared components and some may not. Use this function to determine whether or not the current chunk contains one of these optional component types as a shared component.

    Has(ref DynamicSharedComponentTypeHandle)

    Reports whether this chunk contains a shared component of the specified component type.

    Declaration
    public readonly bool Has(ref DynamicSharedComponentTypeHandle typeHandle)
    Parameters
    Type Name Description
    DynamicSharedComponentTypeHandle typeHandle

    An object containing type and job safety information. To create this object, call GetDynamicSharedComponentTypeHandle(ComponentType).

    Returns
    Type Description
    bool

    True, if this chunk contains a shared component of the specified type.

    Remarks

    When an EntityQuery includes optional components used as shared components (with WithAny<T1>()), some chunks returned by the query may have these shared components and some may not. Use this function to determine whether or not the current chunk contains one of these optional component types as a shared component.

    Has(DynamicSharedComponentTypeHandle)

    Obsolete. Use Has(ref DynamicSharedComponentTypeHandle) instead.

    Declaration
    [Obsolete("The typeHandle argument should now be passed by ref. (RemovedAfter Entities 1.0)", false)]
    public readonly bool Has(DynamicSharedComponentTypeHandle typeHandle)
    Parameters
    Type Name Description
    DynamicSharedComponentTypeHandle typeHandle

    An object containing type and job safety information. To create this object, call GetDynamicSharedComponentTypeHandle(ComponentType).

    Returns
    Type Description
    bool

    True, if this chunk contains a shared component of the specified type.

    Remarks

    When an EntityQuery includes optional components used as shared components (with WithAny<T1>()), some chunks returned by the query may have these shared components and some may not. Use this function to determine whether or not the current chunk contains one of these optional component types as a shared component.

    Has<T>(ref BufferTypeHandle<T>)

    Reports whether this chunk contains a dynamic buffer containing the specified component type.

    Declaration
    public readonly bool Has<T>(ref BufferTypeHandle<T> bufferTypeHandle) where T : unmanaged, IBufferElementData
    Parameters
    Type Name Description
    BufferTypeHandle<T> bufferTypeHandle

    An object containing type and job safety information. To create this object, call GetBufferTypeHandle<T>(bool). Pass the object to a job using a public field you define as part of the job struct.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the dynamic buffers containing the specified component type.

    Type Parameters
    Name Description
    T

    The data type of the component stored in the dynamic buffer.

    Remarks

    When an EntityQuery includes optional dynamic buffer types (with WithAny<T1>()), some chunks returned by the query may have these dynamic buffers components and some may not. Use this function to determine whether or not the current chunk contains one of these optional dynamic buffers.

    Has<T>(BufferTypeHandle<T>)

    Obsolete. Use Has<T>(ref BufferTypeHandle<T>) instead.

    Declaration
    [Obsolete("The bufferTypeHandle argument should now be passed by ref. (RemovedAfter Entities 1.0)", false)]
    public readonly bool Has<T>(BufferTypeHandle<T> bufferTypeHandle) where T : unmanaged, IBufferElementData
    Parameters
    Type Name Description
    BufferTypeHandle<T> bufferTypeHandle

    An object containing type and job safety information. To create this object, call GetBufferTypeHandle<T>(bool). Pass the object to a job using a public field you define as part of the job struct.

    Returns
    Type Description
    bool

    True, if this chunk contains an array of the dynamic buffers containing the specified component type.

    Type Parameters
    Name Description
    T

    The data type of the component stored in the dynamic buffer.


    Did you find this page useful? Please give it a rating:

    Thanks for rating this page!

    Report a problem on this page

    What kind of problem would you like to report?

    • This page needs code samples
    • Code samples do not work
    • Information is missing
    • Information is incorrect
    • Information is unclear or confusing
    • There is a spelling/grammar error on this page
    • Something else

    Thanks for letting us know! This page has been marked for review based on your feedback.

    If you have time, you can provide more information to help us fix the problem faster.

    Provide more information

    You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:

    You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:

    You've told us there is information missing from this page. Please tell us more about what's missing:

    You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:

    You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:

    You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:

    You've told us this page has a problem. Please tell us more about what's wrong:

    Thank you for helping to make the Unity documentation better!

    Your feedback has been submitted as a ticket for our documentation team to review.

    We are not able to reply to every ticket submitted.

    In This Article
    • Has<T>(ref ComponentTypeHandle<T>)
    • Has<T>(ComponentTypeHandle<T>)
    • Has<T>()
    • Has(ref DynamicComponentTypeHandle)
    • Has(DynamicComponentTypeHandle)
    • Has<T>(SharedComponentTypeHandle<T>)
    • Has(ref DynamicSharedComponentTypeHandle)
    • Has(DynamicSharedComponentTypeHandle)
    • Has<T>(ref BufferTypeHandle<T>)
    • Has<T>(BufferTypeHandle<T>)
    Back to top
    Copyright © 2025 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)