YouTip

[ C++ Container Class ](#) * * * `data` is a very special function in vector. It **returns a pointer to the underlying array**, allowing you to use vector like a C array. `data` is a member function of the container class, used to **return a pointer to the container's internal data storage**. This enables vector to interoperate with C-style APIs or other code that requires raw pointers. `data` provides a bridge between vector and C language code, demonstrating the powerful compatibility of vector. **Word Meaning**: `data` means "data", indicating obtaining a pointer to the underlying data. * * * ## Basic Syntax and Parameters `data` is a member function of the container class, and calling it requires no parameters. ### Syntax Format T* data();const T* data() const; ### Parameter Description * **Parameters**: No parameters * `data` does not accept any parameters. ### Function Description * **Return Value**: Returns a **pointer** to the underlying array. If the container is a const container, returns a const pointer. * **Effect**: The returned pointer points to the first element of the container, equivalent to `&operator[](0)`. * **Note**: If the container is empty, the returned pointer is undefined (but usually not a null pointer). * * * ## Examples Let's thoroughly master the usage of `data` through a series of examples. ### Example 1: Basic Usage - Obtaining the Underlying Array Pointer ## Example #include #include int main(){ // 1. Create a vector std::vector numbers ={10, 20, 30, 40, 50}; std::cout<<"vector size is: "<< numbers.size()<< std::endl; // 2. Use data to get the underlying array pointer int* ptr = numbers.data(); std::cout<<"Access through pointer: "<< std::endl; for(size_t i =0; i < numbers.size();++i){ std::cout<<"ptr["<< i <<"] = "<< ptr<< std::endl; } return 0; } **Expected Output:** vector size is: 5Access through pointer: ptr = 10 ptr = 20 ptr = 30 ptr = 40 ptr = 50 **Code Analysis:** 1. `numbers.data()` returns a pointer to the first element. 2. Through the returned pointer, you can use array subscript syntax to access all elements. ### Example 2: Modifying Elements Through Pointer The pointer returned by `data` can be used to modify elements. ## Example #include #include int main(){ std::vector numbers ={10, 20, 30}; std::cout<<"Before modification: "; for(int n : numbers){ std::cout<< n <<" "; } std::cout<< std::endl; // Get pointer through data() and modify elements int* ptr = numbers.data(); ptr=100; ptr=200; ptr=300; std::cout<<"After modification: "; for(int n : numbers){ std::cout<< n <<" "; } std::cout<< std::endl; return 0; } **Expected Output:** Before modification: 10 20 30After modification: 100 200 300 **Code Analysis:** * The pointer returned by `data()` can directly modify the internal data of the vector. ### Example 3: Interacting with C-style APIs One of the main uses of `data` is to interact with C functions that require array pointers. ## Example #include #include #include // for memset // A hypothetical C-style function that calculates the sum of an array int sumArray(const int* arr, size_t size){ int sum =0; for(size_t i =0; i < size;++i){ sum += arr; } return sum; } int main(){ std::vector numbers ={1, 2, 3, 4, 5}; // Use data() to pass vector to C-style function int total = sumArray(numbers.data(), numbers.size()); std::cout<<"Array elements: "; for(int n : numbers){ std::cout<< n <<" "; } std::cout<< std::endl; std::cout<<"Sum: "<< total << std::endl; return 0; } **Expected Output:** Array elements: 1 2 3 4 5Sum: 15 **Code Analysis:** * `numbers.data()` passes the internal array pointer of the vector to a function that accepts `const int*`. * This demonstrates the seamless interaction capability between vector and C code. ### Example 4: Using memset to Manipulate Memory You can directly manipulate the underlying memory of vector through `data()`. ## Example #include #include #include // for memset int main(){ std::vector numbers ={10, 20, 30, 40, 50}; std::cout<<"Before clearing: "; for(int n : numbers){ std::cout<< n <<" "; } std::cout<< std::endl; // Use memset to set all bytes to 0 // Note: This is only valid for integer types, complex types may cause problems std::memset(numbers.data(), 0, numbers.size()*sizeof(int)); std::cout<<"After clearing: "; for(int n : numbers){ std::cout<< n <<" "; } std::cout<< std::endl; return 0; } **Expected Output:** Before clearing: 10 20 30 40 50After clearing: 0 0 0 0 0 **Code Analysis:** * `data()` allows direct manipulation of the underlying memory of the vector. * Using `memset` can quickly set all elements to zero. * Note: This method is not suitable for object types that contain constructors. ### Example 5: Safe Use of Returned Pointer When a vector is reallocated, previously obtained pointers become invalid. ## Example #include #include int main(){ std::vector numbers ={1, 2, 3}; // Get data pointer int* ptr = numbers.data(); std::cout<<"Value pointed to by original pointer: "<<*ptr << std::endl; // Adding elements may cause memory reallocation numbers.push_back(4); numbers.push_back(5); numbers.push_back(6); numbers.push_back(7); numbers.push_back(8); numbers.push_back(9); numbers.push_back(10); // Warning: ptr may already be invalid! // In modern implementations, reallocation usually doesn't happen, but this shouldn't be relied upon std::cout<<"After adding elements, value pointed to by data() pointer: "<<*(numbers.data())<< std::endl; // Safe practice: get new pointer each time using data() ptr = numbers.data(); std::cout<<"After re-obtaining pointer: "<<*ptr << std::endl; return 0; } **Code Analysis:** * When the vector capacity is insufficient, `push_back` will cause memory reallocation. * After reallocation, the pointer previously returned by `data()` becomes invalid (becomes a dangling pointer). * Safe practice: call `data()` again each time it is used, or use `reserve()` to pre-allocate sufficient space. * * C++ Container Class ](#)