Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

`std::vector::data`: puntero al búfer y límites del rango

Obtén un puntero a los elementos de un vector, pásalo junto con el número de elementos y reconoce cuándo deja de ser válido.

Versión: ISO C++23; implementation support may vary

Sintaxis

#include <vector>

// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;

std::vector::data, declarada en <vector>, devuelve en tiempo constante un puntero sin gestión de recursos al almacenamiento contiguo del vector, sin copiar ni transferir la propiedad. Si el vector no está vacío, devuelve la dirección del primer elemento. Un vector no const devuelve T*, que permite modificar los elementos existentes; un vector const devuelve const T*. A través de const T* no puedes asignar un valor nuevo al elemento en sí, pero, si T es un tipo de clase, sí puedes modificar los miembros del elemento declarados mutable. Ambas sobrecargas son noexcept y son constexpr desde C++20. La especialización std::vector<bool> no tiene una función miembro data() estándar.

Si p = v.data() y n = v.size(), [p, p + n) es un rango semiabierto válido. En un vector no vacío, p + n apunta justo después del último elemento y no debe desreferenciarse. Si n == 0, p puede ser nullptr o no, pero no se puede desreferenciar en ninguno de los dos casos. Comprueba v.empty() o n == 0, no si el puntero es nulo.

Pasa a la función que recibe el búfer el puntero y el número de elementos, o bien dos punteros que delimiten el rango. size() cuenta elementos, no bytes; para char, ambas cantidades coinciden. Un búfer std::vector<char> no tiene un terminador \0 automático, y un \0 interno no pone fin a una lectura limitada por la longitud. Si el búfer está vacío, comprueba que la función acepte una cantidad de cero y un puntero posiblemente nulo. reserve() por sí sola no crea elementos: usa resize() antes de escribir en elementos adicionales.

No liberes la memoria a través de ese puntero ni lo uses después de que se destruya el búfer. Una reasignación de memoria invalida los punteros a elementos y el límite final anterior. push_back() puede reasignar la memoria; incluso sin reasignación, un puntero a un primer elemento existente sigue siendo válido, pero hay que volver a calcular el límite final. Tras cambios estructurales en el vector, lo más sencillo es volver a llamar a data() y size().

Ejemplos

#include <cstddef>
#include <iostream>
#include <vector>

void print_bytes(const char* first, std::size_t count) {
    const char* last = first + count;
    for (auto p = first; p != last; ++p) {
        std::cout << (*p == '\0' ? '0' : *p) << ' ';
    }
    std::cout << '\n';
}

int main() {
    std::vector<char> bytes{'A', '\0'};
    bytes.push_back('B');
    const auto& input = bytes;
    print_bytes(input.data(), input.size());
}

Resultado

A 0 B 

`print_bytes` calcula el puntero que queda justo después del último elemento y procesa los tres bytes. Muestra el `\0` interno como un `0` visible, y `<<` inserta un espacio después de cada carácter, incluido `B`, antes del salto de línea.

Lecciones relacionadas

  • C++ · Lección 27 · Avanzado · Versión: 3
  • C++ · Lección 58 · Avanzado · Versión: 3

Fuentes