[#PEM_read_bio_ex]
= PEM_read_bio_ex
:mrdocs:

Read one PEM object from a BIO with controllable decoding behaviour.

== Synopsis

Declared in `<openssl/pem.h>`

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

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *bp*
| BIO to read from.
| *name*
| Receives the allocated type name from the BEGIN line; caller frees it.
| *header*
| Receives allocated encapsulation headers, or an empty string; caller frees it.
| *data*
| Receives allocated base64‐decoded payload; caller frees it.
| *len*
| Receives the length of `data` in bytes.
| *flags*
| Bitwise OR of PEM_FLAG_SECURE, PEM_FLAG_EAY_COMPATIBLE, and/or PEM_FLAG_ONLY_B64.
|===


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