[#absl-Symbolize]
= xref:absl.adoc[absl]::Symbolize
:relfileprefix: ../
:mrdocs:

Symbolizes a program counter (instruction pointer value) `pc` and, on success, writes the name to `out`. The symbol name is demangled, if possible. Note that the symbolized name may be truncated and will be NUL‐terminated. Demangling is supported for symbols generated by GCC 3.x or newer). Returns `false` on failure.

== Synopsis

Declared in `<absl/debugging/symbolize.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
Symbolize(
    void const* pc,
    char* out,
    int out_size);
----

== Description

Example:

// Print a program counter and its symbol name. static void DumpPCAndSymbol(void *pc) { char tmp[1024]; const char *symbol = "(unknown)"; if (absl::Symbolize(pc, tmp, sizeof(tmp))) { symbol = tmp; } absl::PrintF("%p %sn", pc, symbol); }

== Return Value

True on success, false if the program counter could not be symbolized.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pc*
| Program counter (instruction pointer value) to symbolize.
| *out*
| Buffer to receive the demangled symbol name.
| *out_size*
| Size, in bytes, of the `out` buffer.
|===


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