std::basic_stacktrace
De cppreference.com
| Definido en el archivo de encabezado <stacktrace>
|
||
template< class Allocator >
class basic_stacktrace;
|
(1) | (desde C++23) |
using stacktrace =
std::basic_stacktrace<std::allocator<std::stacktrace_entry>>;
|
(2) | (desde C++23) |
1) La plantilla de clase
basic_stacktrace representa una instantnea de todo el listado de pila o su parte dada. Satisface los requerimientos de AllocatorAwareContainer, SequenceContainer, y ReversibleContainer, excepto que solo se soportan el movimiento, la asignacin, el intercambio, y las operaciones para contenedores de secuencia calificados const, y la semntica de las funciones de comparacin es distinta de aquella requerida por un contenedor.2) Alias de tipo conveniente para el listado de pila,
basic_stacktrace, usando el asignador de memoria por defecto, std::allocator.La secuencia de invocacin de la evaluacin actual \(\small{ {x}_{0} }\)x0 en el hilo de ejecucin actual es una secuencia \(\small{ ({x}_{0}, \dots, {x}_{n})}\)(x0, ..., xn) de evaluaciones tales que, para \(\small{i \ge 0}\)i0, \(\small{ {x}_{i} }\)xi est dentro de la invocacin de funcin \(\small{ {x}_{i+1} }\)xi+1.
Un listado de pila es una representacin aproximada de una secuencia de invocacin y consiste en entradas de listado de pila.
Una entrada de listado de pila representa una evaluacin en un listado de pila. Se representa por std::stacktrace_entry en la biblioteca estndar de C++.
Parmetros de plantilla
| Allocator | - | Un asignador de memoria que se usa para adquirir/liberar memoria y para construir/destruir los elementos en esa memoria. El tipo debe cumplir con los requerimientos de Allocator. El programa est mal formado si Allocator::value_type no es std::stacktrace_entry.
|
Tipos miembro
| Tipo miembro | Definicin |
value_type(C++23)
|
std::stacktrace_entry |
const_reference(C++23)
|
const value_type&
|
reference(C++23)
|
value_type&
|
const_iterator(C++23)
|
Tipo const RandomAccessIterator definido por la implementacin que modela a random_access_iterator.
|
iterator(C++23)
|
const_iterator
|
reverse_iterator(C++23)
|
std::reverse_iterator<iterator>
|
reverse_const_iterator(C++23)
|
std::reverse_iterator<const_iterator>
|
difference_type(C++23)
|
Tipo entero con signo definido por la implementacin. |
size_type(C++23)
|
Tipo entero sin signo definido por la implementacin. |
allocator_type(C++23)
|
Allocator (asignador de memoria).
|
Funciones miembro
(C++23) |
Crea un nuevo objeto basic_stacktrace (funcin miembro pblica) |
(C++23) |
Destruye el objeto basic_stacktrace. (funcin miembro pblica) |
(C++23) |
Asigna al objeto basic_stacktrace (funcin miembro pblica) |
[esttico] (C++23) |
Obtiene el listado de pila actual o su parte dada (funcin miembro esttica pblica) |
(C++23) |
Devuelve el asignador de memoria asociado. (funcin miembro pblica) |
Iteradores | |
(C++23) |
Devuelve un iterador al comienzo. (funcin miembro pblica) |
(C++23) |
Devuelve un iterador al final. (funcin miembro pblica) |
(C++23) |
Devuelve un iterador inverso al comienzo. (funcin miembro pblica) |
(C++23) |
Devuelve un iterador inverso al final. (funcin miembro pblica) |
Capacidad | |
(C++23) |
Comprueba si el objeto basic_stacktrace est vaco. (funcin miembro pblica) |
(C++23) |
Devuelve el nmero de entradas de listado de pila. (funcin miembro pblica) |
(C++23) |
Devuelve el nmero mximo posible de entradas de listado de pila. (funcin miembro pblica) |
Acceso a elementos | |
(C++23) |
Accede a una entrada de listado de pila especificada. (funcin miembro pblica) |
(C++23) |
Accede a la entrada de listado de pila especificada con comprobacin de lmites. (funcin miembro pblica) |
Modificadores | |
(C++23) |
Intercambia el contenido. (funcin miembro pblica) |
Funciones no miembro
(C++23) |
Compara los tamaos y el contenido de dos valores basic_stacktrace. (plantilla de funcin) |
| Especializa el algoritmo std::swap (plantilla de funcin) | |
(C++23) |
Devuelve una cadena con una descripcin del listado de pila, basic_stacktrace (plantilla de funcin) |
(C++23) |
Ejecuta salida de flujo del listado de pila, basic_stracktrace (plantilla de funcin) |
Clases auxiliares
| Soporte para hash (resumen) para el listado de pila, std::basic_stacktrace (especializacin de plantilla de clase) |
Notas
Se proporciona el soporte de asignadores de memoria personalizados para usar a basic_stacktrace en una ruta de acceso activa o en ambientes embebidos. Los usuarios pueden asignar memoria de objetos stacktrace_entry en la pila o en algn otro lugar, si es apropriado.
Ejemplo
| Esta seccin est incompleta Razn: sin ejemplo |
Vase tambin
(C++23) |
Representacin de una evaluacin en un listado de pila (clase) |