[#BloombergLP-ball-BroadcastObserver]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::BroadcastObserver
:relfileprefix: ../../
:mrdocs:

This class provides a broadcasting implementation of the `Observer` protocol.

== Synopsis

Declared in `<ball_broadcastobserver.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class BroadcastObserver
    : public xref:BloombergLP/ball/Observer.adoc[Observer]
----

== Description

Other concrete observers may be registered and named with this broadcast observer (`registerObserver` method), retrieved (`findObserver` method), and unregistered (`deregisterObserver` method). The `publish` method of this class forwards the log records that it receives to the `publish` method of each registered observer.

== Base Classes

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/ball/Observer.adoc[Observer]`
| This class provides a protocol for receiving and processing log record output.
|===

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/ball/BroadcastObserver/ObserverRegistry.adoc[`ObserverRegistry`] 
| This `typedef` is an alias for the type of the registry maintained by this observer.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/ball/BroadcastObserver/2constructor.adoc[`BroadcastObserver`]         [.small]#[constructor]#
| Create a broadcast observer having no registered observers.
| xref:BloombergLP/ball/BroadcastObserver/2destructor.adoc[`~BroadcastObserver`] [.small]#[destructor]# [.small]#[virtual]#
| Destroy this broadcast observer. Note that this method has no effect on the lifetime of observers registered with this observer, if any.
| xref:BloombergLP/ball/BroadcastObserver/deregisterAllObservers.adoc[`deregisterAllObservers`] 
| Remove all observers from the registry of this broadcast observer.
| xref:BloombergLP/ball/BroadcastObserver/deregisterObserver.adoc[`deregisterObserver`] 
| Remove the named observer from the registry.
| xref:BloombergLP/ball/BroadcastObserver/findObserver-09.adoc[`findObserver`] 
| `findObserver` overloads
| xref:BloombergLP/ball/BroadcastObserver/numRegisteredObservers.adoc[`numRegisteredObservers`] 
| Return the number of observers registered with this broadcast observer.
| xref:BloombergLP/ball/BroadcastObserver/publish-06.adoc[`publish`] 
| `publish` overloads
| xref:BloombergLP/ball/BroadcastObserver/registerObserver.adoc[`registerObserver`] 
| Register the specified `observer` under `observerName`.
| xref:BloombergLP/ball/BroadcastObserver/releaseRecords.adoc[`releaseRecords`]  [.small]#[virtual]#
| Discard any shared reference to a `Record` object held by this observer.
| xref:BloombergLP/ball/BroadcastObserver/visitObservers-0d.adoc[`visitObservers`] 
| Invoke `visitor` on each observer in this broadcast observer's registry.
|===


== Using Declarations

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/ball/BroadcastObserver/publish-08.adoc[`publish`] 
| Import the base‐class `publish` overloads.
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#