CustomMessage | このプラグインはyuttyann44581によって作成されています。

Do you have any examples or advice regarding how to create a reference cycle?

The general advise is to not create them. ;)

You are already structuring your application with state classes, which is the recommended way to avoid the problem. To be clear, two actors having handles to each other is not an issue in itself and happens all the time. Messages hold a reference to the sender, which usually leads to two actors now holding references to each other. The cycles the manual is warning against are permanent cycles that persist even after an actor terminates.

If you are using stateful actors, there are no permanent cycles. The state gets destroyed when terminating, e.g., due to calling self->quit(). However, the actor object itself cannot be destroyed at that point. Actors are reference counted, hence the underlying object lives on until no more reference to it remains. If two actors hold a reference to each other via member variables, you have a memory leak. You can only run into this problem if you implement an actor by deriving from one of the actor types directly, e.g., by inheriting from event_based_actor. The CAF manual and other resources always advocate not inheriting from actor types but if you do (and you don't since you follow the best practice of using state classes), you also need to worry about potential cycles.

As to how actors can end up refererring to each other: there are a couple of ways. Messages point back to the sender, so by storing the sender information in some way you have created a cycle if the sender also still holds a reference to the receiver. You can of course also include an actor handle in a message and then store it this way. In your example above, you start both actors in main. However, in a server-worker relation, you often have the server start the worker. The server can pass a handle to itself to the worker if for some reason the workers need to know their parent. So in your case, you could have the display actor spawn the duck and then store the duck actor handle.

Just to re-iterate, there's no need to think about cycles in your application unless you implement actors by inheriting from one the CAF actor types directly and you store references to other actors in member variables. As long as you don't do that, you can safely skip the manual section that talks about breaking cycles.