You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If **`true`**, use international format. The default value is **`false`**.
39
39
40
40
### Remarks
41
41
42
-
The manipulator returns an object that, when extracted from the stream `str`, behaves as a `formatted input function` that calls the member function `get` for the locale facet `money_get` associated with `str`, using *use_intl* to indicate international format. If successful, the call stores in *amount* the extracted monetary value. The manipulator then returns `str`.
42
+
The manipulator returns an object that, when extracted from the stream `str`, behaves as a `formatted input function` that calls the member function `get` for the locale facet `money_get` associated with `str`, using *`use_intl`* to indicate international format. If successful, the call stores in *`amount`* the extracted monetary value. The manipulator then returns `str`.
43
43
44
44
`Money` must be of type **`long double`** or an instantiation of `basic_string` with the same element and traits parameters as `str`.
45
45
46
-
## <a name="iomanip_get_time"></a> get_time
46
+
## <a name="iomanip_get_time"></a> `get_time`
47
47
48
48
Extracts a time value from a stream using a desired format. Returns the value in a parameter as a time structure.
The desired format to use to obtain the time value.
62
62
63
63
### Remarks
64
64
65
65
The manipulator returns an object that, when extracted from the stream `str`, behaves as a `formatted input function` that calls the member function `get` for the locale facet `time_get` associated with `str`, using `tptr` to indicate the time structure and `fmt` to indicate the beginning of a null-terminated format string. If successful, the call stores in the time structure the values associated with any extracted time fields. The manipulator then returns `str`.
66
66
67
-
## <aname="iomanip_put_money"></a> put_money
67
+
## <aname="iomanip_put_money"></a> `put_money`
68
68
69
69
Inserts a monetary amount using the desired format into a stream.
The time value to write to the stream, provided in a time structure.
107
107
108
-
*time_format*\
108
+
*`time_format`*\
109
109
The desired format to write the time value.
110
110
111
111
### Remarks
112
112
113
-
The manipulator returns an object that, when inserted into the stream `str`, behaves as a `formatted output function`. The output function calls the member function `put` for the locale facet `time_put` associated with `str`. The output function uses *time_ptr* to indicate the time structure and *time_format* to indicate the beginning of a null-terminated format string. If successful, the call inserts literal text from the format string and converted values from the time structure. The manipulator then returns `str`.
113
+
The manipulator returns an object that, when inserted into the stream `str`, behaves as a `formatted output function`. The output function calls the member function `put` for the locale facet `time_put` associated with `str`. The output function uses *`time_ptr`* to indicate the time structure and *`time_format`* to indicate the beginning of a null-terminated format string. If successful, the call inserts literal text from the format string and converted values from the time structure. The manipulator then returns `str`.
114
114
115
-
## <aname="quoted"></a> quoted
115
+
## <aname="quoted"></a> `quoted`
116
116
117
-
**(New in C++14)** An iostream manipulator that enables convenient round-tripping of strings into and out of streams using the >> and << operators.
117
+
**(New in C++14)** An iostream manipulator that enables convenient round-tripping of strings into and out of streams using the `>>` and `<<` operators.
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.`[setf](../standard-library/ios-base-class.md#setf)`(ios_base::`[fmtflags](../standard-library/ios-base-class.md#fmtflags)`, mask)`, and then returns `str`.
297
+
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(ios_base::fmtflags, mask)`, and then returns `str`, see [`setf`](../standard-library/ios-base-class.md#setf) and [`fmtflags`](../standard-library/ios-base-class.md#fmtflags).
298
298
299
299
### Example
300
300
301
-
See [setw](../standard-library/iomanip-functions.md#setw) for an example of using `resetiosflags`.
301
+
See [`setw`](../standard-library/iomanip-functions.md#setw) for an example of using `resetiosflags`.
302
302
303
-
## <aname="setbase"></a> setbase
303
+
## <aname="setbase"></a> `setbase`
304
304
305
305
Set base for integers.
306
306
@@ -310,26 +310,26 @@ T3 setbase(int base);
310
310
311
311
### Parameters
312
312
313
-
*base*\
313
+
*`base`*\
314
314
The number base.
315
315
316
316
### Return Value
317
317
318
-
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(mask,` [ios_base::basefield](../standard-library/ios-base-class.md#fmtflags)`)`, and then returns `str`. Here, `mask` is determined as follows:
318
+
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(mask, ios_base::basefield)`, and then returns `str`, see [`ios_base::basefield`](../standard-library/ios-base-class.md#fmtflags). Here, `mask` is determined as follows:
319
319
320
-
- If *base* is 8, then `mask` is `ios_base::`[oct](../standard-library/ios-functions.md#oct).
320
+
- If *`base`* is 8, then `mask` is [`ios_base::oct`](../standard-library/ios-functions.md#oct).
321
321
322
-
- If *base* is 10, then mask is `ios_base::`[dec](../standard-library/ios-functions.md#dec).
322
+
- If *`base`* is 10, then mask is [`ios_base::dec`](../standard-library/ios-functions.md#dec).
323
323
324
-
- If *base* is 16, then `mask` is `ios_base::`[hex](../standard-library/ios-functions.md#hex).
324
+
- If *`base`* is 16, then `mask` is [`ios_base::hex`](../standard-library/ios-functions.md#hex).
325
325
326
-
- If *base* is any other value, then mask is `ios_base::`[fmtflags](../standard-library/ios-base-class.md#fmtflags)`(0)`.
326
+
- If *`base`* is any other value, then mask is [`ios_base::fmtflags(0)`](../standard-library/ios-base-class.md#fmtflags)`.
327
327
328
328
### Example
329
329
330
-
See [setw](../standard-library/iomanip-functions.md#setw) for an example of using `setbase`.
330
+
See [`setw`](../standard-library/iomanip-functions.md#setw) for an example of using `setbase`.
331
331
332
-
## <a name="setfill"></a> setfill
332
+
## <a name="setfill"></a> `setfill`
333
333
334
334
Sets the character that will be used to fill spaces in a right-justified display.
335
335
@@ -340,18 +340,18 @@ T4 setfill(Elem Ch);
340
340
341
341
### Parameters
342
342
343
-
*Ch*\
343
+
*`Ch`*\
344
344
The character that will be used to fill spaces in a right-justified display.
345
345
346
346
### Return Value
347
347
348
-
The template manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.`[fill](../standard-library/basic-ios-class.md#fill)`(Ch)`, and then returns `str`. The type `Elem` must be the same as the element type for the stream `str`.
348
+
The template manipulator returns an object that, when extracted from or inserted into the stream `str`, calls [`str.fill(Ch)`](../standard-library/basic-ios-class.md#fill), and then returns `str`. The type `Elem` must be the same as the element type for the stream `str`.
349
349
350
350
### Example
351
351
352
-
See [setw](../standard-library/iomanip-functions.md#setw) for an example of using `setfill`.
352
+
See [`setw`](../standard-library/iomanip-functions.md#setw) for an example of using `setfill`.
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.`[setf](../standard-library/ios-base-class.md#setf)`(mask)`, and then returns `str`.
369
+
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(mask)`, and then returns `str`, see [`setf`](../standard-library/ios-base-class.md#setf).
370
370
371
371
### Example
372
372
373
-
See [setw](../standard-library/iomanip-functions.md#setw) for an example of using `setiosflags`.
373
+
See [`setw`](../standard-library/iomanip-functions.md#setw) for an example of using `setiosflags`.
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.`[precision](../standard-library/ios-base-class.md#precision)`(Prec)`, and then returns `str`.
390
+
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.precision(Prec)`, and then returns `str`, see [`precision`](../standard-library/ios-base-class.md#precision).
391
391
392
392
### Example
393
393
394
-
See [setw](../standard-library/iomanip-functions.md#setw) for an example of using `setprecision`.
394
+
See [`setw`](../standard-library/iomanip-functions.md#setw) for an example of using `setprecision`.
395
395
396
-
## <aname="setw"></a> setw
396
+
## <aname="setw"></a> `setw`
397
397
398
398
Specifies the width of the display field for the next element in the stream.
399
399
@@ -403,16 +403,16 @@ T6 setw(streamsize Wide);
403
403
404
404
### Parameters
405
405
406
-
*Wide*\
406
+
*`Wide`*\
407
407
The width of the display field.
408
408
409
409
### Return Value
410
410
411
-
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.`[width](../standard-library/ios-base-class.md#width)`(Wide)`, then returns `str`.
411
+
The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.width(Wide)`, then returns `str`, see [`width`](../standard-library/ios-base-class.md#width).
412
412
413
413
### Remarks
414
414
415
-
setw sets the width only for the next element in the stream and must be inserted before each element whose width you want to specify.
415
+
`setw` sets the width only for the next element in the stream and must be inserted before each element whose width you want to specify.
This section provides a [general description](../standard-library/what-a-stream-is.md) of the iostream classes and then describes [output streams](../standard-library/output-streams.md), [input streams](../standard-library/input-streams.md), and [input/output streams](../standard-library/input-output-streams.md). The end of the section provides information about advanced iostream programming.
11
11
12
-
There is also a discussion on [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) and [the stdext namespace](../standard-library/stdext-namespace.md).
12
+
There is also a discussion on [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) and the [`stdext` namespace](../standard-library/stdext-namespace.md).
The _ITERATOR_DEBUG_LEVEL macro controls whether [checked iterators](../standard-library/checked-iterators.md) and [debug iterator support](../standard-library/debug-iterator-support.md) are enabled. This macro supersedes and combines the functionality of the older _SECURE_SCL and _HAS_ITERATOR_DEBUGGING macros.
11
+
The `_ITERATOR_DEBUG_LEVEL` macro controls whether [checked iterators](../standard-library/checked-iterators.md) and [debug iterator support](../standard-library/debug-iterator-support.md) are enabled. This macro supersedes and combines the functionality of the older `_SECURE_SCL` and `_HAS_ITERATOR_DEBUGGING` macros.
12
12
13
13
## Macro Values
14
14
15
-
The following table summarizes the possible values for the _ITERATOR_DEBUG_LEVEL macro.
15
+
The following table summarizes the possible values for the `_ITERATOR_DEBUG_LEVEL` macro.
@@ -24,25 +24,25 @@ The following table summarizes the possible values for the _ITERATOR_DEBUG_LEVEL
24
24
||0 (Default)|Disables checked iterators.|
25
25
||1|Enables checked iterators; iterator debugging is not relevant.|
26
26
27
-
In release mode, the compiler generates an error if you specify _ITERATOR_DEBUG_LEVEL as 2.
27
+
In release mode, the compiler generates an error if you specify `_ITERATOR_DEBUG_LEVEL` as 2.
28
28
29
29
## Remarks
30
30
31
-
The _ITERATOR_DEBUG_LEVEL macro controls whether [checked iterators](../standard-library/checked-iterators.md) are enabled, and in Debug mode, whether [debug iterator support](../standard-library/debug-iterator-support.md) is enabled. If _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, checked iterators ensure that the bounds of your containers are not overwritten. If _ITERATOR_DEBUG_LEVEL is 0, iterators are not checked. When _ITERATOR_DEBUG_LEVEL is defined as 1, any unsafe iterator use causes a runtime error and the program is terminated. When _ITERATOR_DEBUG_LEVEL is defined as 2, unsafe iterator use causes an assert and a runtime error dialog that lets you break into the debugger.
31
+
The `_ITERATOR_DEBUG_LEVEL` macro controls whether [checked iterators](../standard-library/checked-iterators.md) are enabled, and in Debug mode, whether [debug iterator support](../standard-library/debug-iterator-support.md) is enabled. If `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, checked iterators ensure that the bounds of your containers are not overwritten. If `_ITERATOR_DEBUG_LEVEL` is 0, iterators are not checked. When `_ITERATOR_DEBUG_LEVEL` is defined as 1, any unsafe iterator use causes a runtime error and the program is terminated. When `_ITERATOR_DEBUG_LEVEL` is defined as 2, unsafe iterator use causes an assert and a runtime error dialog that lets you break into the debugger.
32
32
33
-
Because the _ITERATOR_DEBUG_LEVEL macro supports similar functionality to the _SECURE_SCL and _HAS_ITERATOR_DEBUGGING macros, you may be uncertain which macro and macro value to use in a particular situation. To prevent confusion, we recommend that you use only the _ITERATOR_DEBUG_LEVEL macro. This table describes the equivalent _ITERATOR_DEBUG_LEVEL macro value to use for various values of _SECURE_SCL and _HAS_ITERATOR_DEBUGGING in existing code.
33
+
Because the `_ITERATOR_DEBUG_LEVEL` macro supports similar functionality to the `_SECURE_SCL` and `_HAS_ITERATOR_DEBUGGING` macros, you may be uncertain which macro and macro value to use in a particular situation. To prevent confusion, we recommend that you use only the `_ITERATOR_DEBUG_LEVEL` macro. This table describes the equivalent `_ITERATOR_DEBUG_LEVEL` macro value to use for various values of `_SECURE_SCL` and `_HAS_ITERATOR_DEBUGGING` in existing code.
|2 (Debug default)|(not relevant)|1 (enabled in Debug mode)|
40
40
41
-
For information on how to disable warnings about checked iterators, see [_SCL_SECURE_NO_WARNINGS](../standard-library/scl-secure-no-warnings.md).
41
+
For information on how to disable warnings about checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](../standard-library/scl-secure-no-warnings.md).
42
42
43
43
### Example
44
44
45
-
To specify a value for the _ITERATOR_DEBUG_LEVEL macro, use a [/D](../build/reference/d-preprocessor-definitions.md) compiler option to define it on the command line, or use `#define` before the C++ Standard Library headers are included in your source files. For example, on the command line, to compile *sample.cpp* in debug mode and to use debug iterator support, you can specify the _ITERATOR_DEBUG_LEVEL macro definition:
45
+
To specify a value for the `_ITERATOR_DEBUG_LEVEL` macro, use a [`/D`](../build/reference/d-preprocessor-definitions.md) compiler option to define it on the command line, or use `#define` before the C++ Standard Library headers are included in your source files. For example, on the command line, to compile *sample.cpp* in debug mode and to use debug iterator support, you can specify the `_ITERATOR_DEBUG_LEVEL` macro definition:
0 commit comments