[#ENGINE_get_first]
= ENGINE_get_first
:mrdocs:

Return the first ENGINE in OpenSSL's loaded list.

== Synopsis

Declared in `<openssl/engine.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
xref:ENGINE.adoc[ENGINE]*
ENGINE_get_first();
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]. Use of this entity is allowed but discouraged.
====
== Description

Pair with ENGINE_get_next() to iterate; release the returned reference with ENGINE_free() when finished, unless ENGINE_get_next() has already released it.

== Return Value

Structural reference to the first ENGINE, or NULL if the list is empty.


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