FName::TraceNamesOnConnection

function Core Since 5.0

#include "UObject/NameTypes.h"

Access: public Specifiers: static

Description

Emits all currently registered FNames to the Unreal Insights trace channel when a new profiler connection is established. Ensures that trace tools can resolve FName hashes captured before the connection opened.

Caveats & Gotchas

• Only compiled in when UE_TRACE_ENABLED is defined. Any call site must be guarded with `#if UE_TRACE_ENABLED` to avoid linker errors in trace-disabled configurations.
• The engine's trace infrastructure calls this automatically on connection — calling it manually is rarely necessary and will re-emit the entire name table, which can be expensive on a large title.

Signature

CORE_API static void TraceNamesOnConnection();

Return Type

void

Example

Force name flush for a custom trace listener C++

#if UE_TRACE_ENABLED
// Re-emit all names for a newly connected custom profiler session
FName::TraceNamesOnConnection();
#endif

Version History

Introduced in: 5.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?