[#OSSL_trace_string]
= OSSL&lowbar;trace&lowbar;string
:mrdocs:

Write `data` to a trace BIO as text, optionally masking controls and truncating&period;

== Synopsis

Declared in `&lt;openssl&sol;trace&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OSSL&lowbar;trace&lowbar;string(
    xref:BIO.adoc[BIO]* out,
    int text,
    int full,
    unsigned char const* data,
    size&lowbar;t size);
----

== Return Value

Number of characters emitted, or &hyphen;1 on error&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| Destination BIO (typically the channel from OSSL&lowbar;trace&lowbar;begin())&period;
| *text*
| Non&hyphen;zero to emit raw text&semi; zero masks control characters except newlines&period;
| *full*
| Non&hyphen;zero to emit the full buffer&semi; zero truncates to OSSL&lowbar;TRACE&lowbar;STRING&lowbar;MAX characters&period;
| *data*
| Bytes to print&period;
| *size*
| Number of bytes at `data&period;`
|===


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