2. Boost Unordered Translation (zh_Hans)
3. Doc / Modules / Root / Pages / Debuggability (adoc)
4. English
5. Zen

:14 :14
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Visualization structure 23/10000 · 23
8 :16
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — The visualizations mirror those for the standard unordered containers. A container has a maximum of 100 elements displayed at once. Each set element has its item name listed as `[i]`, where `i` is the index in the display, starting at `0`. Each map element has its item name listed as `[\{key-display}]` by default. For example, if the first element is the pair `("abc", 1)`, the item name will be `["abc"]`. This behaviour can be overridden by using the view "ShowElementsByIndex", which switches the map display behaviour to name the elements by index. This same view name is used in the standard unordered containers. 620/10000 · 620
9 :18
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — By default, the closed-addressing containers will show the `[hash_function]` and `[key_eq]`, the `[spare_hash_function]` and `[spare_key_eq]` if applicable, the `[allocator]`, and the elements. Using the view "detailed" adds the `[bucket_count]` and `[max_load_factor]`. Conversely, using the view "simple" shows only the elements, with no other items present. 360/10000 · 360
10 :20
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — By default, the open-addressing containers will show the `[hash_function]`, `[key_eq]`, `[allocator]`, and the elements. Using the view "simple" shows only the elements, with no other items present. Both the SIMD and the non-SIMD implementations are viewable through the Natvis framework. 288/10000 · 288
11 :22
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Iterators are displayed similarly to their standard counterparts. An iterator is displayed as though it were the element that it points to. An end iterator is simply displayed as `{ end iterator }`. 198/10000 · 198
:24 :24
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Fancy pointers 14/10000 · 14
13 :26
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — The container visualizations also work if you are using fancy pointers in your allocator, such as `boost::interprocess::offset_ptr`. While this is rare, Boost.Unordered has natvis customization points to support any type of fancy pointer. `boost::interprocess::offset_ptr` has support already defined in the Boost.Interprocess library, and you can add support to your own type by following the instructions contained in a comment near the end of the file link:https://github.com/boostorg/unordered/blob/develop/extra/boost_unordered.natvis[/extra/boost_unordered.natvis]. 571/10000 · 571
14 :28
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — GDB Pretty-Printers 19/10000 · 19
15 :30
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — All containers and iterators have a custom GDB pretty-printer. 62/10000 · 62
:32 :32
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Using in your project 21/10000 · 21
17 :34
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Always, when using pretty-printers, you must enable pretty-printing like below. This is typically a one-time setup. 115/10000 · 115
18 :36
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — ```plaintext (gdb) set print pretty on ``` 42/10000 · 42
19 :40
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — By default, if you compile into an ELF binary format, your binary will contain the Boost.Unordered pretty-printers. To use the embedded pretty-printers, ensure you allow auto-loading like below. This must be done every time you load GDB, or add it to a ".gdbinit" file. 269/10000 · 269
20 :42
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — ```plaintext (gdb) add-auto-load-safe-path [/path/to/executable] ``` 68/10000 · 68
21 :46
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — You can choose to compile your binary _without_ embedding the pretty-printers by defining `BOOST_ALL_NO_EMBEDDED_GDB_SCRIPTS`, which disables the embedded GDB pretty-printers for all Boost libraries that have this feature. 222/10000 · 222
22 :48
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — You can load the pretty-printers externally from the non-embedded Python script. Add the script, link:https://github.com/boostorg/unordered/blob/develop/extra/boost_unordered_printers.py[/extra/boost_unordered_printers.py], using the `source` command as shown below. 266/10000 · 266
23 :50
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — ```plaintext (gdb) source [/path/to/boost]/libs/unordered/extra/boost_unordered_printers.py ``` 95/10000 · 95
:54 :54
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — Visualization structure 23/10000 · 23
25 :56
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — The visualizations mirror the standard unordered containers. The map containers display an association from key to mapped value. The set containers display an association from index to value. An iterator is either displayed with its item, or as an end iterator. Here is what may be shown for an example `boost::unordered_map`, an example `boost::unordered_set`, and their respective begin and end iterators. 407/10000 · 407
26 :58
	English ↹ ↵ NBS … “ ” ‘ ’ ﹙-﹚ ‐ – — ```plaintext (gdb) print example_unordered_map $1 = boost::unordered_map with 3 elements = {["C"] = "c", ["B"] = "b", ["A"] = "a"} (gdb) print example_unordered_map_begin $2 = iterator = { {first = "C", second = "c"} } (gdb) print example_unordered_map_end $3 = iterator = { end iterator } (gdb) print example_unordered_set $4 = boost::unordered_set with 3 elements = {[0] = "c", [1] = "b", [2] = "a"} (gdb) print example_unordered_set_begin $5 = iterator = { "c" } (gdb) print example_unordered_set_end $6 = iterator = { end iterator } ``` 540/10000 · 540