bslfmt_formatterpointer

Detailed Description

Provide a formatter customization for pointer types.

Outline

• Purpose
• Classes
• Canonical Header
• Description
  • Usage
    • Example: Formatting a pointer

Purpose

Provide a formatter customization for pointer types

Classes

• bsl::formatter<void *, t_CHAR>: formatter specialization for void *
• bsl::formatter<const void *, t_CHAR>: specialization for const void *
• bsl::formatter<bsl::nullptr_t, t_CHAR>: specialization for bsl::nullptr_t

Canonical Header

bsl_format.h

Description

This component provides partial specializations of bsl::formatter catering for pointer types.

This header is not intended to be included directly. Please include <bsl_format.h> to be able to use specializations of the bsl::formatter for pointer types.

Usage

In this section we show the intended use of this component.

Example: Formatting a pointer

We do not expect most users of bsl::format to interact with this type directly and instead use bsl::format or bsl::vformat, so this example is necessarily unrealistic.

Suppose we want to test pointer formatter's ability to format a pointer with defined alignment and padding.

 bslfmt::MockParseContext<char> mpc("*<6p", 1);
 
 bsl::formatter<const void *, char> f;
 mpc.advance_to(f.parse(mpc));
 
 const void *value = 0;
 
 bslfmt::MockFormatContext<char> mfc(value, 0, 0);
 
 mfc.advance_to(bsl::as_const(f).format(value, mfc));
 
 assert("0x0***" == mfc.finalString());