[#CTxOut]
= CTxOut
:mrdocs:

An output of a transaction. It contains the public key that the next input must be able to sign with to claim it.

== Synopsis

Declared in `<primitives/transaction.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class CTxOut;
----

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:CTxOut/2constructor-0a.adoc[`CTxOut`]         [.small]#[constructor]#
| Constructors
| xref:CTxOut/IsNull.adoc[`IsNull`] 
| Returns true when the output holds no value.
| xref:CTxOut/SetNull.adoc[`SetNull`] 
| Resets the output to its null state.
| xref:CTxOut/ToString.adoc[`ToString`] 
| Returns a human‐readable description of the output.
|===


== Data Members

[cols="1,4"]
|===
| Name| Description
| xref:CTxOut/nValue.adoc[`nValue`] 
| Amount of value carried by this output, in satoshis.
| xref:CTxOut/scriptPubKey.adoc[`scriptPubKey`] 
| Script defining the conditions required to spend this output.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:operator_eq-0ee.adoc[operator==]`
| Compares two outputs for equality.
|===

== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:GetDustThreshold.adoc[`GetDustThreshold`]
| Compute the minimum output value below which an output is considered dust.
| xref:IsDust.adoc[`IsDust`]
| Test whether an output is dust at the given relay fee rate.
| xref:wallet/CalculateMaximumSignedInputSize-0c.adoc[`wallet::CalculateMaximumSignedInputSize`]
| Get the marginal bytes if spending the specified output from this transaction. Use CoinControl to determine whether to expect signature grinding when calculating the size of the input spend.
| xref:wallet/CalculateMaximumSignedInputSize-0f.adoc[`wallet::CalculateMaximumSignedInputSize`]
| Get the marginal bytes if spending the specified output, using an explicit signing provider.
| xref:wallet/FindNonChangeParentOutput.adoc[`wallet::FindNonChangeParentOutput`]
| Find non‐change parent output.
|===


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