filler for memory

Author: msebolt

docs/standard-library/cstdlib.md

@@ -7,7 +7,7 @@ ms.assetid: 0a6aaebf-84e9-4b60-ae90-17e11981cf54
 ---
 # <cstdlib>
 
-Includes the Standard C library header \<stdlib.h> and adds the associated names to the `std` namespace. Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
+Includes the C Standard library header \<stdlib.h> and adds the associated names to the `std` namespace. Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
 
 > [!NOTE]
 > \<stdlib.h> doesn't include the type **wchar_t**.
@@ -123,7 +123,7 @@ Next, all open C streams (as mediated by the function signatures declared in <cs
 
 Finally, control is returned to the host environment. If status is zero or EXIT_SUCCESS, an implementation-defined form of the status successful termination is returned. If status is EXIT_FAILURE, an implementation-defined form of the status unsuccessful termination is returned. Otherwise the status returned is implementation-defined.
 
-### <a name="getevn"></a> getenv
+### <a name="getenv"></a> getenv
 
 ```cpp
 char* getenv(const char* name);

docs/standard-library/memory-functions.md

@@ -11,12 +11,15 @@ helpviewer_keywords: ["std::addressof [C++]", "std::align [C++]", "std::allocate
 |-|-|-|
 |[addressof](#addressof)|[align](#align)|[allocate_shared](#allocate_shared)|
 |[const_pointer_cast](#const_pointer_cast)|[declare_no_pointers](#declare_no_pointers)|[declare_reachable](#declare_reachable)|
-|[default_delete](#default_delete)|[dynamic_pointer_cast](#dynamic_pointer_cast)|[get_deleter](#get_deleter)|
+|[default_delete](#default_delete)|[destroy_at](../standard-library/memory-functions.md#destroy_at)|[destroy](../standard-library/memory-functions.md#destroy)|
+|[destroy_n](../standard-library/memory-functions.md#destroy_n)|[dynamic_pointer_cast](#dynamic_pointer_cast)|[get_deleter](#get_deleter)|
 |[get_pointer_safety](#get_pointer_safety)|[get_temporary_buffer](#get_temporary_buffer)|[make_shared](#make_shared)|
 |[make_unique](#make_unique)|[owner_less](#owner_less)|[return_temporary_buffer](#return_temporary_buffer)|
 |[static_pointer_cast](#static_pointer_cast)|[swap (C++ Standard Library)](#swap)|[undeclare_no_pointers](#undeclare_no_pointers)|
 |[undeclare_reachable](#undeclare_reachable)|[uninitialized_copy](#uninitialized_copy)|[uninitialized_copy_n](#uninitialized_copy_n)|
-|[uninitialized_fill](#uninitialized_fill)|[uninitialized_fill_n](#uninitialized_fill_n)|
+|[uninitialized_default_construct](../standard-library/memory-functions.md#uninitialized_default_construct)|[uninitialized_default_construct_n](../standard-library/memory-functions.md#uninitialized_default_construct_n)|[uninitialized_fill](#uninitialized_fill)|
+|[uninitialized_fill_n](#uninitialized_fill_n)|[uninitialized_move](../standard-library/memory-functions.md#uninitialized_move)|[uninitialized_move_n](../standard-library/memory-functions.md#uninitialized_move_n)|
+|[uninitialized_value_construct](../standard-library/memory-functions.md#uninitialized_value_construct)|[uninitialized_value_construct_n](../standard-library/memory-functions.md#uninitialized_value_construct_n)||
 
 ## <a name="addressof"></a>  addressof
 
@@ -233,14 +236,41 @@ The type of elements in the array to be deleted.
 
 The template class describes a `deleter` that deletes scalar objects allocated with **operator new**, suitable for use with template class `unique_ptr`. It also has the explicit specialization `default_delete<Type[]>`.
 
+## <a name="destroy_at"></a> destroy_at
+
+```cpp
+template <class T>
+    void destroy_at(T* location);
+```
+
+Same as `location->~T()`.
+
+## <a name="destroy"></a> destroy
+
+```cpp
+template <class ForwardIterator>
+    void destroy(ForwardIterator first, ForwardIterator last);
+```
+
+Same as `for (; first!=last; ++first) destroy_at(addressof(*first)); `.
+
+## <a name="destroy_n"></a> destroy_n
+
+```cpp
+template <class ForwardIterator, class Size>
+    ForwardIterator destroy_n(ForwardIterator first, Size n);
+```
+
+Same as `for (; n > 0; (void)++first, --n) destroy_at(addressof(*first)); return first;`.
+
 ## <a name="dynamic_pointer_cast"></a>  dynamic_pointer_cast
 
 Dynamic cast to shared_ptr.
 
 ```cpp
 template <class Ty, class Other>
-shared_ptr<Ty>
-dynamic_pointer_cast(const shared_ptr<Other>& sp);
+    shared_ptr<Ty>
+    dynamic_pointer_cast(const shared_ptr<Other>& sp);
 ```
 
 ### Parameters
@@ -1011,13 +1041,47 @@ The template function effectively executes the following:
 
 unless the code throws an exception. In that case, all constructed objects are destroyed and the exception is rethrown.
 
+## <a name="uninitialized_default_construct"></a> uninitialized_default_construct
+
+```cpp
+template <class ForwardIterator>
+    void uninitialized_default_construct(ForwardIterator first, ForwardIterator last); 
+```
+
+### Remarks
+
+Same as:
+
+```cpp
+for (; first != last; ++first)
+    ::new (static_cast<void*>(addressof(*first)))
+        typename iterator_traits<ForwardIterator>::value_type;
+```
+
+## <a name="uninitialized_default_construct_n"></a> uninitialized_default_construct_n
+
+```cpp
+template <class ForwardIterator, class Size>
+    ForwardIterator uninitialized_default_construct_n(ForwardIterator first, Size n)
+```
+
+### Remarks
+
+Same as:
+
+```cpp
+for (; n>0; (void)++first, --n)
+    ::new (static_cast<void*>(addressof(*first)))
+        typename iterator_traits<ForwardIterator>::value_type; return first;
+```
+
 ## <a name="uninitialized_fill"></a>  uninitialized_fill
 
 Copies objects of a specified value into an uninitialized destination range.
 
 ```cpp
 template <class ForwardIterator, class Type>
-void uninitialized_fill(ForwardIterator first, ForwardIterator last, const Type& val);
+    void uninitialized_fill(ForwardIterator first, ForwardIterator last, const Type& val);
 ```
 
 ### Parameters
@@ -1089,7 +1153,7 @@ Copies objects of a specified value into specified number of elements into an un
 
 ```cpp
 template <class FwdIt, class Size, class Type>
-void uninitialized_fill_n(ForwardIterator first, Size count, const Type& val);
+    void uninitialized_fill_n(ForwardIterator first, Size count, const Type& val);
 ```
 
 ### Parameters
@@ -1147,6 +1211,76 @@ int main() {
 }
 ```
 
+## <a name="uninitialized_move"></a>  uninitialized_move
+
+```cpp
+template <class InputIterator, class ForwardIterator>
+    ForwardIterator uninitialized_move(InputIterator first, InputIterator last, ForwardIterator result); 
+```
+
+### Remarks
+
+Same as:
+
+```cpp
+for (; first != last; (void)++result, ++first)
+    ::new (static_cast<void*>(addressof(*result)))
+        typename iterator_traits<ForwardIterator>::value_type(std::move(*first)); 
+        return result;
+```
+
+If an exception is thrown, some objects in the range might be left in a valid but unspecified state.
+
+## <a name="uninitialized_move_n"></a>  uninitialized_move_n
+
+```cpp
+template <class InputIterator, class Size, class ForwardIterator>
+    pair<InputIterator, ForwardIterator> uninitialized_move_n(InputIterator first, Size n, ForwardIterator result);
+```
+
+### Remarks
+
+Same as:
+
+```cpp
+for (; n > 0; ++result, (void) ++first, --n)
+    ::new (static_cast<void*>(addressof(*result)))
+        typename iterator_traits<ForwardIterator>::value_type(std::move(*first)); return {first,result};
+```
+
+If an exception is thrown, some objects in the range might be left in a valid but unspecified state.
+
+## <a name="uninitialized_value_construct"></a> uninitialized_value_construct
+
+```cpp
+template <class ForwardIterator>
+    void uninitialized_value_construct(ForwardIterator first, ForwardIterator last);
+```
+
+### Remarks
+
+Same as:
+
+```cpp
+for (; first != last; ++first)
+    ::new (static_cast<void*>(addressof(*first)))
+        typename iterator_traits<ForwardIterator>::value_type();
+```
+
+## <a name="uninitialized_value_construct_n"></a> uninitialized_value_construct_n
+
+```cpp
+template <class ForwardIterator, class Size>
+    ForwardIterator uninitialized_value_construct_n(ForwardIterator first, Size n);
+```
+
+Same as:
+```cpp
+for (; n>0; (void)++first, --n)
+    ::new (static_cast<void*>(addressof(*first)))
+        typename iterator_traits<ForwardIterator>::value_type(); return first;
+```
+
 ## See also
 
 [\<memory>](../standard-library/memory.md)<br/>

docs/standard-library/memory.md

@@ -28,9 +28,9 @@ Defines a class, an operator, and several templates that help allocate and free
 |[declare_no_pointers](../standard-library/memory-functions.md#declare_no_pointers)|Informs a garbage collector that the characters starting at a specified address and falling within the indicated block size contain no traceable pointers.|
 |[declare_reachable](../standard-library/memory-functions.md#declare_reachable)|Informs garbage collection that the indicated address is to allocated storage and is reachable.|
 |[default_delete](../standard-library/memory-functions.md#default_delete)|Deletes objects allocated with `operator new`. Suitable for use with `unique_ptr`.|
-|[destroy_at](../standard-library/memory-functions.md#destroy_at)||
-|[destroy](../standard-library/memory-functions.md#destroy)||
-|[destroy_n](../standard-library/memory-functions.md#destroy_n)||
+|[destroy_at](../standard-library/memory-functions.md#destroy_at)|Shorthand `destroy` method.|
+|[destroy](../standard-library/memory-functions.md#destroy)|Shorthand `destroy` method.|
+|[destroy_n](../standard-library/memory-functions.md#destroy_n)|Shorthand `destroy` method.|
 |[dynamic_pointer_cast](../standard-library/memory-functions.md#dynamic_pointer_cast)|Dynamic cast to `shared_ptr`.|
 |[get_deleter](../standard-library/memory-functions.md#get_deleter)|Get deleter from `shared_ptr`.|
 |[get_pointer_safety](../standard-library/memory-functions.md#get_pointer_safety)|Returns the type of pointer safety assumed by any garbage collector.|
@@ -45,14 +45,14 @@ Defines a class, an operator, and several templates that help allocate and free
 |[undeclare_reachable](../standard-library/memory-functions.md#undeclare_reachable)|Informs a `garbage_collector` that a specified memory location is not reachable.|
 |[uninitialized_copy](../standard-library/memory-functions.md#uninitialized_copy)|Copies objects from a specified input range into an uninitialized destination range.|
 |[uninitialized_copy_n](../standard-library/memory-functions.md#uninitialized_copy_n)|Creates a copy of a specified number of elements from an input iterator. The copies are put in a forward iterator.|
-|[uninitialized_default_construct](../standard-library/memory-functions.md#uninitialized_default_construct)||
-|[uninitialized_default_construct_n](../standard-library/memory-functions.md#uninitialized_default_construct_n)||
+|[uninitialized_default_construct](../standard-library/memory-functions.md#uninitialized_default_construct)|Shorthand `uninitialized_default_construct` method.|
+|[uninitialized_default_construct_n](../standard-library/memory-functions.md#uninitialized_default_construct_n)|Shorthand `uninitialized_construct` method.|
 |[uninitialized_fill](../standard-library/memory-functions.md#uninitialized_fill)|Copies objects of a specified value into an uninitialized destination range.|
 |[uninitialized_fill_n](../standard-library/memory-functions.md#uninitialized_fill_n)|Copies objects of a specified value into specified number of elements an uninitialized destination range.|
-|[uninitialized_move](../standard-library/memory-functions.md#uninitialized_move)||
-|[uninitialized_move_n](../standard-library/memory-functions.md#uninitialized_move_n)||
-|[uninitialized_value_construct](../standard-library/memory-functions.md#uninitialized_value_construct)||
-|[uninitialized_value_construct_n](../standard-library/memory-functions.md#uninitialized_value_construct_n)||
+|[uninitialized_move](../standard-library/memory-functions.md#uninitialized_move)|Shorthand `uninitialized_move` method.|
+|[uninitialized_move_n](../standard-library/memory-functions.md#uninitialized_move_n)|Shorthand `uninitialized_move` method.|
+|[uninitialized_value_construct](../standard-library/memory-functions.md#uninitialized_value_construct)|Shorthand `uninitialized_value_construct` method.|
+|[uninitialized_value_construct_n](../standard-library/memory-functions.md#uninitialized_value_construct_n)|Shorthand `uninitialized_value_construct` method.|
 
 ### Operators
 

docs/standard-library/new-functions.md

@@ -37,7 +37,7 @@ A value of type *T\** that points to X.
 
 Also referred to as a pointer optimization barrier.
 
-An invocation of this function may be used in a core constant expression whenever the value of its argument may be used in a core constant expression. A byte of storage is reachable through a pointer value that points to an object Y if it is within the storage occupied by Y, an object that's pointer-interconvertible with Y, or the immediately-enclosing array object if Y is an array element. The program is ill-formed if T is a function type or cv void. If a new object is created in storage occupied by an existing object of the same type, a pointer to the original object can be used to refer to the new object unless the type contains const or reference members; in the latter cases, this function can be used to obtain a usable pointer to the new object.
+Used as a constant expression when the value of its argument may be used in a constant expression. A byte of storage is reachable through a pointer value that points to an object if within the storage occupied by another object, an object with a similar pointer.
 
 ### Example