It’s day 7 of trying to make a working get/set method in Unreal C++.

These are the kind of thoughts you find yourself having:

So… I can’t convert something… into nothing.

It does have this helpful note:

I assume I am the user- le author of this code.

An operator is like = I guess.

I think it’s telling me that I have not defined a way for Get() to convert the pointer of my clock into nothing.

This could be translated as I have not defined a way to destroy the reference to this object.

I believe this is related to the C++ focus on memory allocation. I’ve watched a bunch of YouTube videos on C++ pointers and the key take-aways have been:

This is the reason I avoided C++ in the first place. Learning memory management AND the principles of software design at the same time was like: No, pay me to write you some janky Node code right now.

I need a metronome for LETSGO. A master main metronome to set the time of all instruments to.

Unreal has a subsystem called Quartz that provides a Clock containing a metronome. That gives BPM, time signatures, etc. Exactly what I need for a music game.

I have an Actor representing a Drum that needs access to the Actor representing MainClock

One does not simply get access to another actors members. The problem is if you start spawning a shit-ton of actors, and everyone’s accessing everyone else’s stuff, you run out of memory or something and things get slow.

Slow game bad.

So I believe that Unreal’s pattern for Actors accessing shared state is through its GameMode and GameState

So I’ve created a custom GameMode ALetsGoGameMode

And a GameState ALetsGoGameState

I have defined GameMode with methods Get() and Set() to access members of GameState.

The intent is for GameState to just have a bunch of publicly accessible members needed at runtime. Any Actor can Set/Get objects as needed.

The intent is for GameState to rarely initialize objects, just be the place where objects are shared.

I am trying to share this this clock/metronome UQuartzClockHandle

In GameState we have an object called MainClock.

Except its not an object. It is a pointer to an address in memory for where the object is stored.

That’s fine, if any Actor needs to Get() this thing, it can just dereference in its own context and continue on its merry way.

Except its not a pointer. It is a TWeakObjectPtr - an Unreal object that represents a pointer that is more chill about the pointers existence.

Except of course, that the error is it freaking about the pointers existence:

Cool. Cool cool cool.

Ok so, here’s the thing. ALetsGoGameMode looks a lot like the word ALetsGoGameState

This whole time I thought it was complaining about the GameMode’s Get() function:

Which is on line 14 of ALetsGoGameMode cpp file.

The actual error references line 14 of ALetsGoGameState

JIPPITY WOULD NEVER MAKE THIS MISTAKE

Damn dirty apes.

So this error suddenly makes some amount of sense now that I’m looking AT THE ACTUAL CORRECT FILE

I don’t remember writing this code. This was copypasta from probably Jippity just trying to get the thing working end to end.

It didn’t start as TWeakObjectPtr<UQuartzClockHandle> MainClock; either.

It would be insane to start with that.

No, it started with the reasonable:

But then like, Rider complained in Set() in MainClock = newClock

A squiggly line on the =

I am unfamiliar with languages telling me = is wrong.

Usually the = is right regardless of how wrong my code is.

So then I hop in the Discord and Laura, who is a superstar on the #cpp channel hinted that I can’t pass around UObjects by value or something, asking if I’m missing a ref somewhere or something.

Unfortunately I lost the thread, would link if I still had it.

I reaaally truly think I missing a ref somewhere. Or something.

So I try the only true way of writing C++ : randomly placing * and & characters in front of things to see if Rider stops complaining.

Rider did not stop complaining.

I watch the YouTube videos on pointers not being complicated actually.

Rider did not stop complaining.

I stumble on a TWeakObjectPtr, which sounds like it would make Rider chill out about pointers and let my = assign value somehow.

Now I get a conversion error trying to delete a TWeakObjectPtr. If you look at the wrong file, this error is incomprehensible.

If you look at this code:

It certainly looks like code that would break with an error like

Immediately and without thinking the first thing I do is attempt compile with the following:

Effective Debugging Technique:

Comment out your code until things start working again

Didn’t instantly fix, but did give another error, which is good, because:

New errors are a sign of progress.

It’s kind of profound that this is an honest to God fundamental truth of programming. Probably because it extends to all facets of life: New kinds of failure is literally progress.

Anyways, the original error specifies the line delete MainClock;

It would be reasonable to assume that one does not just delete a TWeakObjectPtr. They put magic in there managing a pointers lifecycle- the cost of said magic is that you can’t just treat it like you would other pointers.

At least, that’s a random assumption I’m pulling out of thin air. (Also a more-effective-than-youd-assume tool for effective programming)

The new error:

Ok, not making the wrong file mistake again: This error appears to occur on both State and Mode.

Specifically, the Unreal Header generation object(?)

Different error numbers, both prepended with code LNK

Google unreal header error code yields nothing.

unresolved external symbol yeilds result containing keyword LNK2019 to page:

So the Unreal Header tool, which does the magic to convert UCLASS into Unreal’s reflection system to actually use your class in Unreal can not find something called:

Garbage words.

class UClass * generating a pointer to a UClass object

__cdecl Z_Construct_UClass_ ID + Uclass name prepend

UQuartzClockHandle Hey thats the thing I’m trying to get to work!

_NoRegister(void) Hey this looks like the thing the original error complained about.

So an unregistered clock cannot be found in GameMode and GameState. That would make sense that you would not be able to find something that has not been registered.

This is happening in the Destructor for ALetsGoGameState which would be responsible for the voiding/nulling/deregistering/destroying a GameState.

Two things I want to try: Lets remove the destructor (dtor) completely and see if there’s different errors, then try calling a ~TWeakObjectPtr() dtor in the ALetsGoGameState dtor with the thought being it needs to be dtor turtles all the way down.

Aaaaand commenting all dtors has no change to the error. This would make sense as I have defined an empty dtor. Commenting it out will simply give it the default dtor which would be, probably, an empty dtor.

Ok this is the property defined in GameState:

The naive approach is:

This isn’t possible:

Asking about this in the Discord #cpp channel points to the Stickied comment pointing you to random blogs for:

and

So, Unreal is actually C# on top of C++. Neat I guess.

The section on UObjects points to something called Lyra which is a sample Unreal game you can download.

Finding a link to it on GitHub gives the following:

header:

cpp

This seems to mirror what I’m trying to accomplish with UQuartzClockHandle .

Fine. Lets try TObjectPtr instead of TWeakObjectPtr.

So replicating that in my code:

So I get a new error on this, so progress I guess.

Ok so lets do the same all-in-one-line as the Get:

Aaaaand we’re back:

COOOOOOL.

Ok back to Lyra:

There’s nothing in here indicating that I’m doing it wrong.

BUT

I did see something in that Slacker Unreal article posted above:

Quote:

💡

During compilation an unresolved external linker error might pop up, something that looks like the following:

error LNK2019: unresolved external symbol "__declspec(dllimport) public: static class UClass * __cdecl UUserWidget::StaticClass(void)" (__imp_?StaticClass@UUserWidget@@SAPEAVUClass@@XZ) referenced in function "class UUserWidget * __cdecl NewObject<class UUserWidget>(class UObject *)" (??$NewObject@VUUserWidget@@@@YAPEAVUUserWidget@@PEAVUObject@@@Z)

This error indicates that you are trying to access something that the linker is unable to find the symbols for.

This can be caused by a few different reasons, described below:

Missing dependency

The most common cause of this within unreal is missing a module dependency.

In the case of the example error above, we can see that is complaining about something related to the UUserWidget class. So, we google for the documentation page of this class, where we land on this:

As we can see, the module is mentioned on this page. To include this module in our project, we need to add it to our depencies. To do this open your <projectname>.Build.cs file (normally found in the project’s Source/<projectname> folder) and add the module as a string to the public or private dependencies, in case of this example we add the "UMG" module at the end:

PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore"

UQuartzClockHandle is part of AudioMixer.

Adding AudioMixer to the LETSGO.Build.cs file makes it compile.

So it works compiles now.

I’m not happy about this. There’s no joy in getting this to work.

This is a resigned, defeated victory. Phyyric in every sense of the word:

Creating a Get/Set method for a single property in Unreal has inflicted such a devastating toll on me that it is tantamount to defeat.

PAIN

But at least now I can get on with it: