[#PEM_read_bio]
= PEM_read_bio
:mrdocs:

Read one PEM object from a BIO, returning name, header, and decoded data.

== Synopsis

Declared in `<openssl/pem.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
PEM_read_bio(
    xref:BIO.adoc[BIO]* bp,
    char** name,
    char** header,
    unsigned char** data,
    long* len);
----

== Return Value

1 on success, or 0 on failure / end of input.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *bp*
| BIO to read from.
| *name*
| Receives a newly allocated PEM type name (caller frees with OPENSSL_free).
| *header*
| Receives a newly allocated PEM header block, or an empty string.
| *data*
| Receives newly allocated decoded payload bytes.
| *len*
| Receives the length of *`data` in bytes.
|===


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