boostorg/conversion
1
0
Fork 1
mirror of https://github.com/boostorg/conversion.git synced 2025-07-30 20:47:25 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add some missing verbatim markers

Browse Source 
i.e. completed one unbalanced and the rest for some non-verbatim
identifiers.
This commit is contained in:
Georg Sauthoff
2018-10-16 21:22:10 +02:00
parent 29997a9fe1
commit a770ff87d7
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
doc/conversion.qbk
View File

@ -91,7 +91,7 @@ crosscasts of pointers to polymorphic objects, but error notification in
the form of a returned value of 0 is inconvenient to test, or worse yet, the form of a returned value of 0 is inconvenient to test, or worse yet,
easy to forget to test. The throwing form of `dynamic_cast`, which easy to forget to test. The throwing form of `dynamic_cast`, which
works on references, can be used on pointers through the ugly expression works on references, can be used on pointers through the ugly expression
`&dynamic_cast<T&>(*p), which causes undefined `&dynamic_cast<T&>(*p)`, which causes undefined
behavior if `p` is `0`. The `polymorphic_cast` behavior if `p` is `0`. The `polymorphic_cast`
template performs a `dynamic_cast` on a pointer, and throws an template performs a `dynamic_cast` on a pointer, and throws an
exception if the `dynamic_cast` returns 0. exception if the `dynamic_cast` returns 0.
@ -99,12 +99,12 @@ exception if the `dynamic_cast` returns 0.
For crosscasts, or when the success of a cast can only be known at runtime, For crosscasts, or when the success of a cast can only be known at runtime,
or when efficiency is not important, `polymorphic_cast` is preferred. or when efficiency is not important, `polymorphic_cast` is preferred.
The C++ built-in dynamic_cast must be used to cast references rather than pointers. The C++ built-in `dynamic_cast` must be used to cast references rather than pointers.
It is also the only cast that can be used to check whether a given interface is supported; in that case a return of 0 isn't an error condition. It is also the only cast that can be used to check whether a given interface is supported; in that case a return of 0 isn't an error condition.
[#polymorphic_pointer_cast] [#polymorphic_pointer_cast]
While polymorphic_downcast and polymorphic_cast work with built-in pointer types only, While `polymorphic_downcast` and `polymorphic_cast` work with built-in pointer types only,
polymorphic_pointer_downcast and polymorphic_pointer_cast are more generic versions `polymorphic_pointer_downcast` and `polymorphic_pointer_cast` are more generic versions
with support for any pointer type for which the following expressions would be valid: with support for any pointer type for which the following expressions would be valid:
For `polymorphic_pointer_downcast`: For `polymorphic_pointer_downcast`:
@ -192,6 +192,6 @@ This includes C++ built-in pointers, `std::shared_ptr`,
`polymorphic_pointer_downcast` was contributed by [@http://www.boost.org/people/boris_rasin.htm Boris Rasin] `polymorphic_pointer_downcast` was contributed by [@http://www.boost.org/people/boris_rasin.htm Boris Rasin]
and `polymorphic_pointer_cast` by Antony Polukhin. and `polymorphic_pointer_cast` by Antony Polukhin.
An old numeric_cast that was contributed by [@http://www.boost.org/people/kevlin_henney.htm Kevlin Henney] An old `numeric_cast` that was contributed by [@http://www.boost.org/people/kevlin_henney.htm Kevlin Henney]
is now superseeded by the [@boost:numeric_conversion/doc/html/html/boost_numericconversion/improved_numeric_cast__.html Boost Numeric Conversion Library] is now superseeded by the [@boost:numeric_conversion/doc/html/html/boost_numericconversion/improved_numeric_cast__.html Boost Numeric Conversion Library]
[endsect] [endsect]