RealDocs

UActorComponent::IsPreUnregistered

function Engine Since 5.0
#include "Components/ActorComponent.h"
Access: public Specifiers: inline

Description

Returns true after the pre-unregistering pass has completed, meaning the component is no longer active but may not yet have been fully removed from the world's component lists.

Caveats & Gotchas

  • A pre-unregistered component is no longer ticking or rendering, but it may still be reachable through `AActor::GetComponents()` until the actor's component list is fully flushed.
  • This is a brief intermediate state; most code should check `!IsRegistered()` rather than `IsPreUnregistered()` to determine that a component is inactive.

Signature

inline bool IsPreUnregistered() const

Return Type

bool

Example

Verify component is fully inactive C++
// Prefer IsRegistered() for general inactive checks
if (!MyComponent->IsRegistered())
{
    // Component is not active — could be pre-unregistered, fully unregistered, or never registered
}
// Use IsPreUnregistered() only when you need to distinguish this specific phase
if (MyComponent->IsPreUnregistered())
{
    UE_LOG(LogTemp, Verbose, TEXT("Component in pre-unregistered state"));
}

Version History

Introduced in: 5.0

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.