[#OBJ_obj2txt]
= OBJ_obj2txt
:mrdocs:

Format an ASN1_OBJECT as text (dotted OID and/or registered name).

== Synopsis

Declared in `<openssl/objects.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OBJ_obj2txt(
    char* buf,
    int buf_len,
    xref:ASN1_OBJECT.adoc[ASN1_OBJECT] const* a,
    int no_name);
----

== Return Value

Length of the text (excluding NUL) that was or would be written, or ‐1 on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *buf*
| Destination buffer for the NUL‐terminated text, or NULL to measure length only.
| *buf_len*
| Capacity of `buf` in bytes when non‐NULL.
| *a*
| Object identifier to render.
| *no_name*
| When non‐zero, always emit numeric OID form; when zero, prefer a known name.
|===


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