[#OSSL_trace_string]
= OSSL_trace_string
:mrdocs:

Write `data` to a trace BIO as text, optionally masking controls and truncating.

== Synopsis

Declared in `<openssl/trace.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OSSL_trace_string(
    xref:BIO.adoc[BIO]* out,
    int text,
    int full,
    unsigned char const* data,
    size_t size);
----

== Return Value

Number of characters emitted, or ‐1 on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| Destination BIO (typically the channel from OSSL_trace_begin()).
| *text*
| Non‐zero to emit raw text; zero masks control characters except newlines.
| *full*
| Non‐zero to emit the full buffer; zero truncates to OSSL_TRACE_STRING_MAX characters.
| *data*
| Bytes to print.
| *size*
| Number of bytes at `data.`
|===


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