[#FSChaCha20Poly1305-Decrypt-0e]
= xref:FSChaCha20Poly1305.adoc[FSChaCha20Poly1305]::Decrypt
:relfileprefix: ../
:mrdocs:

`Decrypt` overloads

== Synopses

Declared in `<crypto/chacha20poly1305.h>`

Decrypt a message with a specified aad. Returns true if valid.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
xref:FSChaCha20Poly1305/Decrypt-05.adoc[Decrypt](
    std::span<std::byte const> cipher,
    std::span<std::byte const> aad,
    std::span<std::byte> plain) noexcept;
----

[.small]#xref:FSChaCha20Poly1305/Decrypt-05.adoc[_» more..._]#

Decrypt a message with a specified aad and split the result. Returns true if valid.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
xref:FSChaCha20Poly1305/Decrypt-07.adoc[Decrypt](
    std::span<std::byte const> cipher,
    std::span<std::byte const> aad,
    std::span<std::byte> plain1,
    std::span<std::byte> plain2) noexcept;
----

[.small]#xref:FSChaCha20Poly1305/Decrypt-07.adoc[_» more..._]#

== Return Value

true if the tag is valid and decryption succeeded, false otherwise.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *cipher*
| The ciphertext and authentication tag to decrypt and verify.
| *aad*
| The associated data to authenticate.
| *plain*
| Output buffer receiving the recovered plaintext.
| *plain1*
| Output buffer receiving the first part of the recovered plaintext.
| *plain2*
| Output buffer receiving the second part of the recovered plaintext.
|===


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