<!doctype html><html lang="en">
 <head>
  <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
  <meta content="width=device-width, initial-scale=1, shrink-to-fit=no" name="viewport">
  <title>P2249R2: Mixed comparisons for smart pointers</title>
<style data-fill-with="stylesheet">/******************************************************************************
 *                   Style sheet for the W3C specifications                   *
 *
 * Special classes handled by this style sheet include:
 *
 * Indices
 *   - .toc for the Table of Contents (<ol class="toc">)
 *     + <span class="secno"> for the section numbers
 *   - #toc for the Table of Contents (<nav id="toc">)
 *   - ul.index for Indices (<a href="#ref">term</a><span>, in § N.M</span>)
 *   - table.index for Index Tables (e.g. for properties or elements)
 *
 * Structural Markup
 *   - table.data for general data tables
 *     -> use 'scope' attribute, <colgroup>, <thead>, and <tbody> for best results !
 *     -> use <table class='complex data'> for extra-complex tables
 *     -> use <td class='long'> for paragraph-length cell content
 *     -> use <td class='pre'> when manual line breaks/indentation would help readability
 *   - dl.switch for switch statements
 *   - ol.algorithm for algorithms (helps to visualize nesting)
 *   - .figure and .caption (HTML4) and figure and figcaption (HTML5)
 *     -> .sidefigure for right-floated figures
 *   - ins/del
 *     -> ins/del.c### for candidate and proposed changes (amendments)
 *
 * Code
 *   - pre and code
 *
 * Special Sections
 *   - .note       for informative notes             (div, p, span, aside, details)
 *   - .example    for informative examples          (div, p, pre, span)
 *   - .issue      for issues                        (div, p, span)
 *   - .advisement for loud normative statements     (div, p, strong)
 *   - .annoying-warning for spec obsoletion notices (div, aside, details)
 *   - .correction for "candidate corrections"       (div, aside, details, section)
 *   - .addition   for "candidate additions"         (div, aside, details, section)
 *   - .correction.proposed for "proposed corrections" (div, aside, details, section)
 *   - .addition.proposed   for "proposed additions"   (div, aside, details, section)
 *
 * Definition Boxes
 *   - pre.def   for WebIDL definitions
 *   - table.def for tables that define other entities (e.g. CSS properties)
 *   - dl.def    for definition lists that define other entitles (e.g. HTML elements)
 *
 * Numbering
 *   - .secno for section numbers in .toc and headings (<span class='secno'>3.2</span>)
 *   - .marker for source-inserted example/figure/issue numbers (<span class='marker'>Issue 4</span>)
 *   - ::before styled for CSS-generated issue/example/figure numbers:
 *     -> Documents wishing to use this only need to add
 *        figcaption::before,
 *        .caption::before { content: "Figure "  counter(figure) " ";  }
 *        .example::before { content: "Example " counter(example) " "; }
 *        .issue::before   { content: "Issue "   counter(issue) " ";   }
 *
 * Header Stuff (ignore, just don't conflict with these classes)
 *   - .head for the header
 *   - .copyright for the copyright
 *
 * Outdated warning for old specs
 *
 * Miscellaneous
 *   - .overlarge for things that should be as wide as possible, even if
 *     that overflows the body text area. This can be used on an item or
 *     on its container, depending on the effect desired.
 *     Note that this styling basically doesn't help at all when printing,
 *     since A4 paper isn't much wider than the max-width here.
 *     It's better to design things to fit into a narrower measure if possible.
 *
 *   - js-added ToC jump links (see fixup.js)
 *
 ******************************************************************************/

/* color variables included separately for reliability */

/******************************************************************************/
/*                                    Body                                    */
/******************************************************************************/

	html {
	}

	body {
		counter-reset: example figure issue;

		/* Layout */
		max-width: 50em;			  /* limit line length to 50em for readability   */
		margin: 0 auto;				/* center text within page                    */
		padding: 1.6em 1.5em 2em 50px; /* assume 16px font size for downlevel clients */
		padding: 1.6em 1.5em 2em calc(26px + 1.5em); /* leave space for status flag    */

		/* Typography */
		line-height: 1.5;
		font-family: sans-serif;
		widows: 2;
		orphans: 2;
		word-wrap: break-word;
		overflow-wrap: break-word;
		hyphens: auto;

		color: black;
		color: var(--text);
		background: white top left fixed no-repeat;
		background: var(--bg) top left fixed no-repeat;
		background-size: 25px auto;
	}


/******************************************************************************/
/*                         Front Matter & Navigation                          */
/******************************************************************************/

/** Header ********************************************************************/

	div.head { margin-bottom: 1em; }
	div.head hr { border-style: solid; }

	div.head h1 {
		font-weight: bold;
		margin: 0 0 .1em;
		font-size: 220%;
	}

	div.head h2 { margin-bottom: 1.5em;}

/** W3C Logo ******************************************************************/

	.head .logo {
		float: right;
		margin: 0.4rem 0 0.2rem .4rem;
	}

	.head img[src*="logos/W3C"] {
		display: block;
		border: solid #1a5e9a;
		border: solid var(--logo-bg);
		border-width: .65rem .7rem .6rem;
		border-radius: .4rem;
		background: #1a5e9a;
		background: var(--logo-bg);
		color: white;
		color: var(--logo-text);
		font-weight: bold;
	}

	.head a:hover > img[src*="logos/W3C"],
	.head a:focus > img[src*="logos/W3C"] {
		opacity: .8;
	}

	.head a:active > img[src*="logos/W3C"] {
		background: #c00;
		background: var(--logo-active-bg);
		border-color: #c00;
		border-color: var(--logo-active-bg);
	}

	/* see also additional rules in Link Styling section */

/** Copyright *****************************************************************/

	p.copyright,
	p.copyright small { font-size: small; }

/** Back to Top / ToC Toggle **************************************************/

	@media print {
		#toc-nav {
			display: none;
		}
	}
	@media not print {
		#toc-nav {
			position: fixed;
			z-index: 3;
			bottom: 0; left: 0;
			margin: 0;
			min-width: 1.33em;
			border-top-right-radius: 2rem;
			box-shadow: 0 0 2px;
			font-size: 1.5em;
		}
		#toc-nav > a {
			display: block;
			white-space: nowrap;

			height: 1.33em;
			padding: .1em 0.3em;
			margin: 0;

			box-shadow: 0 0 2px;
			border: none;
			border-top-right-radius: 1.33em;

			color: #707070;
			color: var(--tocnav-normal-text);
			background: white;
			background: var(--tocnav-normal-bg);
		}
		#toc-nav > a:hover,
		#toc-nav > a:focus {
			color: black;
			color: var(--tocnav-hover-text);
			background: #f8f8f8;
			background: var(--tocnav-hover-bg);
		}
		#toc-nav > a:active {
			color: #c00;
			color: var(--tocnav-active-text);
			background: white;
			background: var(--tocnav-active-bg);
		}

		#toc-nav > #toc-jump {
			padding-bottom: 2em;
			margin-bottom: -1.9em;
		}

		/* statusbar gets in the way on keyboard focus; remove once browsers fix */
		#toc-nav > a[href="#toc"]:not(:hover):focus:last-child {
			padding-bottom: 1.5rem;
		}

		#toc-nav:not(:hover) > a:not(:focus) > span + span {
			/* Ideally this uses :focus-within on #toc-nav */
			display: none;
		}
		#toc-nav > a > span + span {
			padding-right: 0.2em;
		}
	}

/** ToC Sidebar ***************************************************************/

	/* Floating sidebar */
	@media screen {
		body.toc-sidebar #toc {
			position: fixed;
			top: 0; bottom: 0;
			left: 0;
			width: 23.5em;
			max-width: 80%;
			max-width: calc(100% - 2em - 26px);
			overflow: auto;
			padding: 0 1em;
			padding-left: 42px;
			padding-left: calc(1em + 26px);
			color: black;
			color: var(--tocsidebar-text);
			background: inherit;
			background-color: #f7f8f9;
			background-color: var(--tocsidebar-bg);
			z-index: 1;
			box-shadow: -.1em 0 .25em rgba(0,0,0,.1) inset;
			box-shadow: -.1em 0 .25em var(--tocsidebar-shadow) inset;
		}
		body.toc-sidebar #toc h2 {
			margin-top: .8rem;
			font-variant: small-caps;
			font-variant: all-small-caps;
			text-transform: lowercase;
			font-weight: bold;
			color: gray;
			color: hsla(203,20%,40%,.7);
			color: var(--tocsidebar-heading-text);
		}
		body.toc-sidebar #toc-jump:not(:focus) {
			width: 0;
			height: 0;
			padding: 0;
			position: absolute;
			overflow: hidden;
		}
	}
	/* Hide main scroller when only the ToC is visible anyway */
	@media screen and (max-width: 28em) {
		body.toc-sidebar {
			overflow: hidden;
		}
	}

	/* Sidebar with its own space */
	@media screen and (min-width: 78em) {
		body:not(.toc-inline) #toc {
			position: fixed;
			top: 0; bottom: 0;
			left: 0;
			width: 23.5em;
			overflow: auto;
			padding: 0 1em;
			padding-left: 42px;
			padding-left: calc(1em + 26px);
			color: black;
			color: var(--tocsidebar-text);
			background: inherit;
			background-color: #f7f8f9;
			background-color: var(--tocsidebar-bg);
			z-index: 1;
			box-shadow: -.1em 0 .25em rgba(0,0,0,.1) inset;
			box-shadow: -.1em 0 .25em var(--tocsidebar-shadow) inset;
		}
		body:not(.toc-inline) #toc h2 {
			margin-top: .8rem;
			font-variant: small-caps;
			font-variant: all-small-caps;
			text-transform: lowercase;
			font-weight: bold;
			color: gray;
			color: hsla(203,20%,40%,.7);
			color: var(--tocsidebar-heading-text);
		}

		body:not(.toc-inline) {
			padding-left: 29em;
		}
		/* See also Overflow section at the bottom */

		body:not(.toc-inline) #toc-jump:not(:focus) {
			width: 0;
			height: 0;
			padding: 0;
			position: absolute;
			overflow: hidden;
		}
	}
	@media screen and (min-width: 90em) {
		body:not(.toc-inline) {
			margin: 0 4em;
		}
	}

/******************************************************************************/
/*                                Sectioning                                  */
/******************************************************************************/

/** Headings ******************************************************************/

	h1, h2, h3, h4, h5, h6, dt {
		page-break-after: avoid;
		page-break-inside: avoid;
		font: 100% sans-serif;   /* Reset all font styling to clear out UA styles */
		font-family: inherit;	/* Inherit the font family. */
		line-height: 1.2;		/* Keep wrapped headings compact */
		hyphens: manual;		/* Hyphenated headings look weird */
	}

	h2, h3, h4, h5, h6 {
		margin-top: 3rem;
	}

	h1, h2, h3 {
		color: #005A9C;
		color: var(--heading-text);
	}

	h1 { font-size: 170%; }
	h2 { font-size: 140%; }
	h3 { font-size: 120%; }
	h4 { font-weight: bold; }
	h5 { font-style: italic; }
	h6 { font-variant: small-caps; }
	dt { font-weight: bold; }

/** Subheadings ***************************************************************/

	h1 + h2,
	#profile-and-date {
		/* #profile-and-date is a subtitle in an H2 under the H1 */
		margin-top: 0;
	}
	h2 + h3,
	h3 + h4,
	h4 + h5,
	h5 + h6 {
		margin-top: 1.2em; /* = 1 x line-height */
	}

/** Section divider ***********************************************************/

	:not(.head) > :not(.head) + hr {
		font-size: 1.5em;
		text-align: center;
		margin: 1em auto;
		height: auto;
		color: black;
		color: var(--hr-text);
		border: transparent solid 0;
		background: transparent;
	}
	:not(.head) > hr::before {
		content: "\2727\2003\2003\2727\2003\2003\2727";
	}

/******************************************************************************/
/*                            Paragraphs and Lists                            */
/******************************************************************************/

	p {
		margin: 1em 0;
	}

	dd > p:first-child,
	li > p:first-child {
		margin-top: 0;
	}

	ul, ol {
		margin-left: 0;
		padding-left: 2em;
	}

	li {
		margin: 0.25em 0 0.5em;
		padding: 0;
	}

	dl dd {
		margin: 0 0 .5em 2em;
	}

	.head dd + dd { /* compact for header */
		margin-top: -.5em;
	}

	/* Style for algorithms */
	ol.algorithm ol:not(.algorithm),
	.algorithm > ol ol:not(.algorithm) {
	border-left: 0.5em solid #DEF;
	border-left: 0.5em solid var(--algo-border);
	}

	/* Put nice boxes around each algorithm. */
	[data-algorithm]:not(.heading) {
	 padding: .5em;
	 border: thin solid #ddd;
	 border: thin solid var(--algo-border);
	 border-radius: .5em;
	 margin: .5em calc(-0.5em - 1px);
	}
	[data-algorithm]:not(.heading) > :first-child {
	 margin-top: 0;
	}
	[data-algorithm]:not(.heading) > :last-child {
	 margin-bottom: 0;
	}

	/* Style for switch/case <dl>s */
	dl.switch > dd > ol.only,
	dl.switch > dd > .only > ol {
	margin-left: 0;
	}
	dl.switch > dd > ol.algorithm,
	dl.switch > dd > .algorithm > ol {
	margin-left: -2em;
	}
	dl.switch {
	padding-left: 2em;
	}
	dl.switch > dt {
	text-indent: -1.5em;
	margin-top: 1em;
	}
	dl.switch > dt + dt {
	margin-top: 0;
	}
	dl.switch > dt::before {
	content: '\21AA';
	padding: 0 0.5em 0 0;
	display: inline-block;
	width: 1em;
	text-align: right;
	line-height: 0.5em;
	}

/** Terminology Markup ********************************************************/


/******************************************************************************/
/*                                 Inline Markup                              */
/******************************************************************************/

/** Terminology Markup ********************************************************/
	dfn   { /* Defining instance */
		font-weight: bolder;
	}
	a > i { /* Instance of term */
		font-style: normal;
	}
	dt dfn code, code.idl {
		font-size: inherit;
	}
	dfn var {
		font-style: normal;
	}

/** Change Marking ************************************************************/

	del {
		color: #aa0000;
		color: var(--del-text);
		background: transparent;
		background: var(--del-bg);
		text-decoration: line-through;
	}
	ins {
		color: #006100;
		color: var(--ins-text);
		background: transparent;
		background: var(--ins-bg);
		text-decoration: underline;
	}

	/* for amendments (candidate/proposed changes) */

	.amendment ins, .correction ins, .addition ins,
	ins[class^=c] {
		text-decoration-style: dotted;
	}
	.amendment del, .correction del, .addition del,
	del[class^=c] {
		text-decoration-style: dotted;
	}
	.amendment.proposed ins, .correction.proposed ins, .addition.proposed ins,
	ins[class^=c].proposed {
		text-decoration-style: double;
	}
	.amendment.proposed del, .correction.proposed del, .addition.proposed del,
	del[class^=c].proposed {
		text-decoration-style: double;
	}

/** Miscellaneous improvements to inline formatting ***************************/

	sup {
		vertical-align: super;
		font-size: 80%
	}

/******************************************************************************/
/*                                    Code                                    */
/******************************************************************************/

/** General monospace/pre rules ***********************************************/

	pre, code, samp {
		font-family: Menlo, Consolas, "DejaVu Sans Mono", Monaco, monospace;
		font-size: .9em;
		hyphens: none;
		text-transform: none;
		text-align: left;
		text-align: start;
		font-variant: normal;
		orphans: 3;
		widows: 3;
		page-break-before: avoid;
	}
	pre code,
	code code {
		font-size: 100%;
	}

	pre {
		margin-top: 1em;
		margin-bottom: 1em;
		overflow: auto;
	}

/** Inline Code fragments *****************************************************/

	/* Do something nice. */

/******************************************************************************/
/*                                    Links                                   */
/******************************************************************************/

/** General Hyperlinks ********************************************************/

	/* We hyperlink a lot, so make it less intrusive */
	a[href] {
		color: #034575;
		color: var(--a-normal-text);
		text-decoration: underline #707070;
		text-decoration: underline var(--a-normal-underline);
		text-decoration-skip-ink: none;
	}
	a:visited {
		color: #034575;
		color: var(--a-visited-text);
		text-decoration-color: #bbb;
		text-decoration-color: var(--a-visited-underline);
	}

	/* Indicate interaction with the link */
	a[href]:focus,
	a[href]:hover {
		text-decoration-thickness: 2px;
	}
	a[href]:active {
		color: #c00;
		color: var(--a-active-text);
		text-decoration-color: #c00;
		text-decoration-color: var(--a-active-underline);
	}

	/* Backout above styling for W3C logo */
	.head .logo,
	.head .logo a {
		border: none;
		text-decoration: none;
		background: transparent;
	}

/******************************************************************************/
/*                                    Images                                  */
/******************************************************************************/

	img {
		border-style: none;
	}

	img, svg {
		/* Intentionally not color-scheme aware. */
		background: white;
	}

	/* For autogen numbers, add
	  .caption::before, figcaption::before { content: "Figure " counter(figure) ". "; }
	*/

	figure, .figure, .sidefigure {
		page-break-inside: avoid;
		text-align: center;
		margin: 2.5em 0;
	}
	.figure img,	.sidefigure img,	figure img,
	.figure object, .sidefigure object, figure object {
		max-width: 100%;
		margin: auto;
		height: auto;
	}
	.figure pre, .sidefigure pre, figure pre {
		text-align: left;
		display: table;
		margin: 1em auto;
	}
	.figure table, figure table {
		margin: auto;
	}
	@media screen and (min-width: 20em) {
		.sidefigure {
			float: right;
			width: 50%;
			margin: 0 0 0.5em 0.5em;
		}
	}
	.caption, figcaption, caption {
		font-style: italic;
		font-size: 90%;
	}
	.caption::before, figcaption::before, figcaption > .marker {
		font-weight: bold;
	}
	.caption, figcaption {
		counter-increment: figure;
	}

	/* DL list is indented 2em, but figure inside it is not */
	dd > .figure, dd > figure { margin-left: -2em; }

/******************************************************************************/
/*                             Colored Boxes                                  */
/******************************************************************************/

	.issue, .note, .example, .assertion, .advisement, blockquote,
	.amendment, .correction, .addition {
		margin: 1em auto;
		padding: .5em;
		border: .5em;
		border-left-style: solid;
		page-break-inside: avoid;
	}
	span.issue, span.note {
		padding: .1em .5em .15em;
		border-right-style: solid;
	}

	blockquote > :first-child,
	.note  > p:first-child,
	.issue > p:first-child,
	.amendment > p:first-child,
	.correction > p:first-child,
	.addition > p:first-child {
		margin-top: 0;
	}
	blockquote > :last-child,
	.note  > p:last-child,
	.issue > p:last-child,
	.amendment > p:last-child,
	.correction > p:last-child,
	.addition > p:last-child {
		margin-bottom: 0;
	}


	.issue::before, .issue > .marker,
	.example::before, .example > .marker,
	.note::before, .note > .marker,
	details.note > summary > .marker,
	.amendment::before, .amendment > .marker,
	details.amendment > summary > .marker,
	.addition::before, .addition > .marker,
	addition.amendment > summary > .marker,
	.correction::before, .correction > .marker,
	correction.amendment > summary > .marker
	{
		text-transform: uppercase;
		padding-right: 1em;
	}

	.example::before, .example > .marker {
		display: block;
		padding-right: 0em;
	}

/** Blockquotes ***************************************************************/

	blockquote {
		border-color: silver;
		border-color: var(--blockquote-border);
		background: transparent;
		background: var(--blockquote-bg);
		color: currentcolor;
		color: var(--blockquote-text);
	}

/** Open issue ****************************************************************/

	.issue {
		border-color: #e05252;
		border-color: var(--issue-border);
		background: #fbe9e9;
		background: var(--issue-bg);
		color: black;
		color: var(--issue-text);
		counter-increment: issue;
		overflow: auto;
	}
	.issue::before, .issue > .marker {
		color: #831616;
		color: var(--issueheading-text);
	}
	/* Add .issue::before { content: "Issue " counter(issue) " "; } for autogen numbers,
	  or use class="marker" to mark up the issue number in source. */

/** Example *******************************************************************/

	.example {
		border-color: #e0cb52;
		border-color: var(--example-border);
		background: #fcfaee;
		background: var(--example-bg);
		color: black;
		color: var(--example-text);
		counter-increment: example;
		overflow: auto;
		clear: both;
	}
	.example::before, .example > .marker {
		color: #574b0f;
		color: var(--exampleheading-text);
	}
	/* Add .example::before { content: "Example " counter(example) " "; } for autogen numbers,
	  or use class="marker" to mark up the example number in source. */

/** Non-normative Note ********************************************************/

	.note {
		border-color: #52e052;
		border-color: var(--note-border);
		background: #e9fbe9;
		background: var(--note-bg);
		color: black;
		color: var(--note-text);
		overflow: auto;
	}

	.note::before, .note > .marker,
	details.note > summary {
		color: hsl(120, 70%, 30%);
		color: var(--noteheading-text);
	}
	/* Add .note::before { content: "Note "; } for autogen label,
	  or use class="marker" to mark up the label in source. */

	details.note[open] > summary {
		border-bottom: 1px silver solid;
		border-bottom: 1px var(--notesummary-underline) solid;
	}

/** Assertion Box *************************************************************/
	/*  for assertions in algorithms */

	.assertion {
		border-color: #AAA;
		border-color: var(--assertion-border);
		background: #EEE;
		background: var(--assertion-bg);
		color: black;
		color: var(--assertion-text);
	}

/** Advisement Box ************************************************************/
	/*  for attention-grabbing normative statements */

	.advisement {
		border-color: orange;
		border-color: var(--advisement-border);
		border-style: none solid;
		background: #fec;
		background: var(--advisement-bg);
		color: black;
		color: var(--advisement-text);
	}
	strong.advisement {
		display: block;
		text-align: center;
	}
	.advisement::before, .advisement > .marker {
		color: #b35f00;
		color: var(--advisementheading-text);
	}

/** Amendment Box *************************************************************/

	.amendment, .correction, .addition {
		border-color: #330099;
		border-color: var(--amendment-border);
		background: #F5F0FF;
		background: var(--amendment-bg);
		color: black;
		color: var(--amendment-text);
	}
	.amendment.proposed, .correction.proposed, .addition.proposed {
		border-style: solid;
		border-block-width: 0.25em;
	}
	.amendment::before, .amendment > .marker,
	details.amendment > summary::before, details.amendment > summary > .marker,
	.correction::before, .correction > .marker,
	details.correction > summary::before, details.correction > summary > .marker,
	.addition::before, .addition > .marker,
	details.addition > summary::before, details.addition > summary > .marker {
		color: #220066;
		color: var(--amendmentheading-text);
	}
	.amendment.proposed::before, .amendment.proposed > .marker,
	details.amendment.proposed > summary::before, details.amendment.proposed > summary > .marker,
	.correction.proposed::before, .correction.proposed > .marker,
	details.correction.proposed > summary::before, details.correction.proposed > summary > .marker,
	.addition.proposed::before, .addition.proposed > .marker,
	details.addition.proposed > summary::before, details.addition.proposed > summary > .marker {
		font-weight: bold;
	}

/** Spec Obsoletion Notice ****************************************************/
	/* obnoxious obsoletion notice for older/abandoned specs. */

	details {
		display: block;
	}
	summary {
		font-weight: bolder;
	}

	.annoying-warning:not(details),
	details.annoying-warning:not([open]) > summary,
	details.annoying-warning[open] {
		background: hsla(40,100%,50%,0.95);
		background: var(--warning-bg);
		color: black;
		color: var(--warning-text);
		padding: .75em 1em;
		border: red;
		border: var(--warning-border);
		border-style: solid none;
		box-shadow: 0 2px 8px black;
		text-align: center;
	}
	.annoying-warning :last-child {
		margin-bottom: 0;
	}

@media not print {
	details.annoying-warning[open] {
		position: fixed;
		left: 0;
		right: 0;
		bottom: 2em;
		z-index: 1000;
	}
}

	details.annoying-warning:not([open]) > summary {
		text-align: center;
	}

/** Entity Definition Boxes ***************************************************/

	.def {
		padding: .5em 1em;
		background: #def;
		background: var(--def-bg);
		margin: 1.2em 0;
		border-left: 0.5em solid #8ccbf2;
		border-left: 0.5em solid var(--def-border);
		color: black;
		color: var(--def-text);
	}

/******************************************************************************/
/*                                    Tables                                  */
/******************************************************************************/

	th, td {
		text-align: left;
		text-align: start;
	}

/** Property/Descriptor Definition Tables *************************************/

	table.def {
		/* inherits .def box styling, see above */
		width: 100%;
		border-spacing: 0;
	}

	table.def td,
	table.def th {
		padding: 0.5em;
		vertical-align: baseline;
		border-bottom: 1px solid #bbd7e9;
		border-bottom: 1px solid var(--defrow-border);
	}

	table.def > tbody > tr:last-child th,
	table.def > tbody > tr:last-child td {
		border-bottom: 0;
	}

	table.def th {
		font-style: italic;
		font-weight: normal;
		padding-left: 1em;
		width: 3em;
	}

	/* For when values are extra-complex and need formatting for readability */
	table td.pre {
		white-space: pre-wrap;
	}

	/* A footnote at the bottom of a def table */
	table.def td.footnote {
		padding-top: 0.6em;
	}
	table.def td.footnote::before {
		content: " ";
		display: block;
		height: 0.6em;
		width: 4em;
		border-top: thin solid;
	}

/** Data tables (and properly marked-up index tables) *************************/
	/*
		<table class="data"> highlights structural relationships in a table
		when correct markup is used (e.g. thead/tbody, th vs. td, scope attribute)

		Use class="complex data" for particularly complicated tables --
		(This will draw more lines: busier, but clearer.)

		Use class="long" on table cells with paragraph-like contents
		(This will adjust text alignment accordingly.)
		Alternately use class="longlastcol" on tables, to have the last column assume "long".
	*/

	table {
		word-wrap: normal;
		overflow-wrap: normal;
		hyphens: manual;
	}

	table.data,
	table.index {
		margin: 1em auto;
		border-collapse: collapse;
		border: hidden;
		width: 100%;
	}
	table.data caption,
	table.index caption {
		max-width: 50em;
		margin: 0 auto 1em;
	}

	table.data td,  table.data th,
	table.index td, table.index th {
		padding: 0.5em 1em;
		border-width: 1px;
		border-color: silver;
		border-color: var(--datacell-border);
		border-top-style: solid;
	}

	table.data thead td:empty {
		padding: 0;
		border: 0;
	}

	table.data  thead,
	table.index thead,
	table.data  tbody,
	table.index tbody {
		border-bottom: 2px solid;
	}

	table.data colgroup,
	table.index colgroup {
		border-left: 2px solid;
	}

	table.data  tbody th:first-child,
	table.index tbody th:first-child  {
		border-right: 2px solid;
		border-top: 1px solid silver;
		border-top: 1px solid var(--datacell-border);
		padding-right: 1em;
	}

	table.data th[colspan],
	table.data td[colspan] {
		text-align: center;
	}

	table.complex.data th,
	table.complex.data td {
		border: 1px solid silver;
		border: 1px solid var(--datacell-border);
		text-align: center;
	}

	table.data.longlastcol td:last-child,
	table.data td.long {
		vertical-align: baseline;
		text-align: left;
	}

	table.data img {
		vertical-align: middle;
	}


/*
Alternate table alignment rules

	table.data,
	table.index {
		text-align: center;
	}

	table.data  thead th[scope="row"],
	table.index thead th[scope="row"] {
		text-align: right;
	}

	table.data  tbody th:first-child,
	table.index tbody th:first-child  {
		text-align: right;
	}

Possible extra rowspan handling

	table.data  tbody th[rowspan]:not([rowspan='1']),
	table.index tbody th[rowspan]:not([rowspan='1']),
	table.data  tbody td[rowspan]:not([rowspan='1']),
	table.index tbody td[rowspan]:not([rowspan='1']) {
		border-left: 1px solid silver;
	}

	table.data  tbody th[rowspan]:first-child,
	table.index tbody th[rowspan]:first-child,
	table.data  tbody td[rowspan]:first-child,
	table.index tbody td[rowspan]:first-child{
		border-left: 0;
		border-right: 1px solid silver;
	}
*/

/******************************************************************************/
/*                                  Indices                                   */
/******************************************************************************/


/** Table of Contents *********************************************************/

	.toc a {
		/* More spacing; use padding to make it part of the click target. */
		padding: 0.1rem 1px 0;
		/* Larger, more consistently-sized click target */
		display: block;
		/* Switch to using border-bottom for underlines */
		text-decoration: none;
		border-bottom: 1px solid;
		/* Reverse color scheme */
		color: black;
		color: var(--toclink-text);
		border-color: #3980b5;
		border-color: var(--toclink-underline);
	}
	.toc a:visited {
		color: black;
		color: var(--toclink-visited-text);
		border-color: #054572;
		border-color: var(--toclink-visited-underline);
	}
	.toc a:focus,
	.toc a:hover {
		background: rgba(75%, 75%, 75%, .25);
		background: var(--a-hover-bg);
		border-bottom-width: 3px;
		margin-bottom: -2px;
	}
	.toc a:not(:focus):not(:hover) {
		/* Allow colors to cascade through from link styling */
		border-bottom-color: transparent;
	}

	.toc, .toc ol, .toc ul, .toc li {
		list-style: none; /* Numbers must be inlined into source */
		/* because generated content isn't search/selectable and markers can't do multilevel yet */
		margin:  0;
		padding: 0;
	}
	.toc {
		line-height: 1.1em;
	}

	/* ToC not indented until third level, but font style & margins show hierarchy */
	.toc > li			{ font-weight: bold;   }
	.toc > li li		 { font-weight: normal; }
	.toc > li li li	  { font-size:   95%;	}
	.toc > li li li li	{ font-size:   90%;	}
	.toc > li li li li li { font-size:   85%;	}

	/* @supports not (display:grid) { */
		.toc > li			{ margin: 1.5rem 0;	}
		.toc > li li		 { margin: 0.3rem 0;	}
		.toc > li li li	  { margin-left: 2rem;   }

		/* Section numbers in a column of their own */
		.toc .secno {
			float: left;
			width: 4rem;
			white-space: nowrap;
		}
		.toc > li li li li .secno { font-size: 85%; }
		.toc > li li li li li .secno { font-size: 100%; }

		.toc li {
			clear: both;
		}

		:not(li) > .toc			 { margin-left:  5rem; }
		.toc .secno				 { margin-left: -5rem; }
		.toc > li li li .secno	  { margin-left: -7rem; }
		.toc > li li li li .secno	{ margin-left: -9rem; }
		.toc > li li li li li .secno { margin-left: -11rem; }

		/* Tighten up indentation in narrow ToCs */
		@media (max-width: 30em) {
			:not(li) > .toc			 { margin-left:  4rem; }
			.toc .secno				 { margin-left: -4rem; }
			.toc > li li li			 { margin-left:  1rem; }
			.toc > li li li .secno	  { margin-left: -5rem; }
			.toc > li li li li .secno	{ margin-left: -6rem; }
			.toc > li li li li li .secno { margin-left: -7rem; }
		}
		/* Loosen it on wide screens */
		@media screen and (min-width: 78em) {
			body:not(.toc-inline) :not(li) > .toc			 { margin-left:  4rem; }
			body:not(.toc-inline) .toc .secno				 { margin-left: -4rem; }
			body:not(.toc-inline) .toc > li li li			 { margin-left:  1rem; }
			body:not(.toc-inline) .toc > li li li .secno	  { margin-left: -5rem; }
			body:not(.toc-inline) .toc > li li li li .secno	{ margin-left: -6rem; }
			body:not(.toc-inline) .toc > li li li li li .secno { margin-left: -7rem; }
	}
	/* } */

	@supports (display:grid) and (display:contents) {
		/* Use #toc over .toc to override non-@supports rules. */
		#toc {
			display: grid;
			align-content: start;
			grid-template-columns: auto 1fr;
			grid-column-gap: 1rem;
			column-gap: 1rem;
			grid-row-gap: .6rem;
			row-gap: .6rem;
		}
		#toc h2 {
			grid-column: 1 / -1;
			margin-bottom: 0;
		}
		#toc ol,
		#toc li,
		#toc a {
			display: contents;
			/* Switch <a> to subgrid when supported */
		}
		#toc span {
			margin: 0;
		}
		#toc > .toc > li > a > span {
			/* The spans of the top-level list,
			  comprising the first items of each top-level section. */
			margin-top: 1.1rem;
		}
		#toc#toc .secno { /* Ugh, need more specificity to override base.css */
			grid-column: 1;
			width: auto;
			margin-left: 0;
		}
		#toc .content {
			grid-column: 2;
			width: auto;
			margin-right: 1rem;
		}
		#toc .content:hover,
		#toc .content:focus {
			background: rgba(75%, 75%, 75%, .25);
			background: var(--a-hover-bg);
			border-bottom: 3px solid #054572;
			border-bottom: 3px solid var(--toclink-underline);
			margin-bottom: -3px;
		}
		#toc li li li .content {
			margin-left: 1rem;
		}
		#toc li li li li .content {
			margin-left: 2rem;
		}
	}


/** Index *********************************************************************/

	/* Index Lists: Layout */
	ul.index	  { margin-left: 0; columns: 15em; text-indent: 1em hanging; }
	ul.index li	{ margin-left: 0; list-style: none; break-inside: avoid; }
	ul.index li li { margin-left: 1em; }
	ul.index dl	{ margin-top: 0; }
	ul.index dt	{ margin: .2em 0 .2em 20px;}
	ul.index dd	{ margin: .2em 0 .2em 40px;}
	/* Index Lists: Typography */
	ul.index ul,
	ul.index dl { font-size: smaller; }
	@media not print {
		ul.index li span:not(.dfn-paneled) {
			white-space: nowrap;
			color: transparent; }
		ul.index li a:hover + span,
		ul.index li a:focus + span {
			color: #707070;
			color: var(--indexinfo-text);
		}
	}

/** Index Tables *****************************************************/
	/* See also the data table styling section, which this effectively subclasses */

	table.index {
		font-size: small;
		border-collapse: collapse;
		border-spacing: 0;
		text-align: left;
		margin: 1em 0;
	}

	table.index td,
	table.index th {
		padding: 0.4em;
	}

	table.index tr:hover td:not([rowspan]),
	table.index tr:hover th:not([rowspan]) {
		color: black;
		color: var(--indextable-hover-text);
		background: #f7f8f9;
		background: var(--indextable-hover-bg);
	}

	/* The link in the first column in the property table (formerly a TD) */
	table.index th:first-child a {
		font-weight: bold;
	}

/** Outdated warning **********************************************************/

.outdated-spec {
	color: black;
	color: var(--outdatedspec-text);
	background-color: rgba(0,0,0,0.5);
	background-color: var(--outdatedspec-bg);
}

.outdated-warning {
	position: fixed;
	bottom: 50%;
	left: 0;
	right: 0;
	margin: 0 auto;
	width: 50%;
	background: maroon;
	background: var(--outdated-bg);
	color: white;
	color: var(--outdated-text);
	border-radius: 1em;
	box-shadow: 0 0 1em red;
	box-shadow: 0 0 1em var(--outdated-shadow);
	padding: 2em;
	text-align: center;
	z-index: 2;
}

.outdated-warning a {
	color: currentcolor;
	background: transparent;
}

.edited-rec-warning {
	background: darkorange;
	background: var(--editedrec-bg);
	box-shadow: 0 0 1em;
}

.outdated-warning button {
	color: var(--outdated-text);
	border-radius: 1em;
	box-shadow: 0 0 1em red;
	box-shadow: 0 0 1em var(--outdated-shadow);
	padding: 2em;
	text-align: center;
	z-index: 2;
}

.outdated-warning a {
	color: currentcolor;
	background: transparent;
}

.edited-rec-warning {
	background: darkorange;
	background: var(--editedrec-bg);
	box-shadow: 0 0 1em;
}

.outdated-warning button {
	position: absolute;
	top: 0;
	right:0;
	margin: 0;
	border: 0;
	padding: 0.25em 0.5em;
	background: transparent;
	color: white;
	color: var(--outdated-text);
	font:1em sans-serif;
	text-align:center;
}

.outdated-warning span {
	display: block;
}

.outdated-collapsed {
	bottom: 0;
	border-radius: 0;
	width: 100%;
	padding: 0;
}

/******************************************************************************/
/*                                    Print                                   */
/******************************************************************************/

	@media print {
		/* Pages have their own margins. */
		html {
			margin: 0;
		}
		/* Serif for print. */
		body {
			font-family: serif;
		}

		.outdated-warning {
			position: absolute;
			border-style: solid;
			border-color: red;
		}

		.outdated-warning input {
			display: none;
		}
	}
	@page {
		margin: 1.5cm 1.1cm;
	}



/******************************************************************************/
/*                             Overflow Control                               */
/******************************************************************************/

	.figure .caption, .sidefigure .caption, figcaption {
		/* in case figure is overlarge, limit caption to 50em */
		max-width: 50rem;
		margin-left: auto;
		margin-right: auto;
	}
	.overlarge {
		/* Magic to create good item positioning:
		  "content column" is 50ems wide at max; less on smaller screens.
		  Extra space (after ToC + content) is empty on the right.

		  1. When item < content column, centers item in column.
		  2. When content < item < available, left-aligns.
		  3. When item > available, fills available + scroll bar.
		*/
		display: grid;
		grid-template-columns: minmax(0, 50em);
	}
	.overlarge > table {
		/* limit preferred width of table */
		max-width: 50em;
		margin-left: auto;
		margin-right: auto;
	}

	@media (min-width: 55em) {
		.overlarge {
			margin-right: calc(13px + 26.5rem - 50vw);
			max-width: none;
		}
	}
	@media screen and (min-width: 78em) {
		body:not(.toc-inline) .overlarge {
			/* 30.5em body padding 50em content area */
			margin-right: calc(40em - 50vw) !important;
		}
	}
	@media screen and (min-width: 90em) {
		body:not(.toc-inline) .overlarge {
			/* 4em html margin 30.5em body padding 50em content area */
			margin-right: calc(84.5em - 100vw) !important;
		}
	}

	@media not print {
		.overlarge {
			overflow-x: auto;
			/* See Lea Verou's explanation background-attachment:
			* http://lea.verou.me/2012/04/background-attachment-local/
			*
			background: top left  / 4em 100% linear-gradient(to right,  #ffffff, rgba(255, 255, 255, 0)) local,
						top right / 4em 100% linear-gradient(to left, #ffffff, rgba(255, 255, 255, 0)) local,
						top left  / 1em 100% linear-gradient(to right,  #c3c3c5, rgba(195, 195, 197, 0)) scroll,
						top right / 1em 100% linear-gradient(to left, #c3c3c5, rgba(195, 195, 197, 0)) scroll,
						white;
			background-repeat: no-repeat;
			*/
		}
	}
</style>
<style type="text/css">
    table, th, td {
      border: 1px solid black;
      border-collapse: collapse;
      vertical-align: top;
    }
    th, td {
      border-left: none;
      border-right: none;
      padding: 0px 10px;
    }
    th {
      text-align: center;
    }

    del { background: #fcc; color: #000; text-decoration: line-through; }
    ins { background: #cfc; color: #000; }
    blockquote .highlight:not(.idl) { background: initial; margin: initial; padding: 0.5em }
    blockquote ul { background: inherit; }
    blockquote code.highlight:not(.idl) { padding: initial; }
    blockquote c-[a] { color: inherit; } /* Keyword.Declaration */
    blockquote c-[b] { color: inherit; } /* Keyword.Type */
    blockquote c-[c] { color: inherit; } /* Comment */
    blockquote c-[d] { color: inherit; } /* Comment.Multiline */
    blockquote c-[e] { color: inherit; } /* Name.Attribute */
    blockquote c-[f] { color: inherit; } /* Name.Tag */
    blockquote c-[g] { color: inherit; } /* Name.Variable */
    blockquote c-[k] { color: inherit; } /* Keyword */
    blockquote c-[l] { color: inherit; } /* Literal */
    blockquote c-[m] { color: inherit; } /* Literal.Number */
    blockquote c-[n] { color: inherit; } /* Name */
    blockquote c-[o] { color: inherit; } /* Operator */
    blockquote c-[p] { color: inherit; } /* Punctuation */
    blockquote c-[s] { color: inherit; } /* Literal.String */
    blockquote c-[t] { color: inherit; } /* Literal.String.Single */
    blockquote c-[u] { color: inherit; } /* Literal.String.Double */
    blockquote c-[cp] { color: inherit; } /* Comment.Preproc */
    blockquote c-[c1] { color: inherit; } /* Comment.Single */
    blockquote c-[cs] { color: inherit; } /* Comment.Special */
    blockquote c-[kc] { color: inherit; } /* Keyword.Constant */
    blockquote c-[kn] { color: inherit; } /* Keyword.Namespace */
    blockquote c-[kp] { color: inherit; } /* Keyword.Pseudo */
    blockquote c-[kr] { color: inherit; } /* Keyword.Reserved */
    blockquote c-[ld] { color: inherit; } /* Literal.Date */
    blockquote c-[nc] { color: inherit; } /* Name.Class */
    blockquote c-[no] { color: inherit; } /* Name.Constant */
    blockquote c-[nd] { color: inherit; } /* Name.Decorator */
    blockquote c-[ni] { color: inherit; } /* Name.Entity */
    blockquote c-[ne] { color: inherit; } /* Name.Exception */
    blockquote c-[nf] { color: inherit; } /* Name.Function */
    blockquote c-[nl] { color: inherit; } /* Name.Label */
    blockquote c-[nn] { color: inherit; } /* Name.Namespace */
    blockquote c-[py] { color: inherit; } /* Name.Property */
    blockquote c-[ow] { color: inherit; } /* Operator.Word */
    blockquote c-[mb] { color: inherit; } /* Literal.Number.Bin */
    blockquote c-[mf] { color: inherit; } /* Literal.Number.Float */
    blockquote c-[mh] { color: inherit; } /* Literal.Number.Hex */
    blockquote c-[mi] { color: inherit; } /* Literal.Number.Integer */
    blockquote c-[mo] { color: inherit; } /* Literal.Number.Oct */
    blockquote c-[sb] { color: inherit; } /* Literal.String.Backtick */
    blockquote c-[sc] { color: inherit; } /* Literal.String.Char */
    blockquote c-[sd] { color: inherit; } /* Literal.String.Doc */
    blockquote c-[se] { color: inherit; } /* Literal.String.Escape */
    blockquote c-[sh] { color: inherit; } /* Literal.String.Heredoc */
    blockquote c-[si] { color: inherit; } /* Literal.String.Interpol */
    blockquote c-[sx] { color: inherit; } /* Literal.String.Other */
    blockquote c-[sr] { color: inherit; } /* Literal.String.Regex */
    blockquote c-[ss] { color: inherit; } /* Literal.String.Symbol */
    blockquote c-[vc] { color: inherit; } /* Name.Variable.Class */
    blockquote c-[vg] { color: inherit; } /* Name.Variable.Global */
    blockquote c-[vi] { color: inherit; } /* Name.Variable.Instance */
    blockquote c-[il] { color: inherit; } /* Literal.Number.Integer.Long */
  </style>
  <meta content="Bikeshed version a210b7d86, updated Thu Sep 16 13:45:19 2021 -0700" name="generator">
  <link href="https://isocpp.org/favicon.ico" rel="icon">
<style>
ins  {background-color: #CCFFCC; text-decoration: underline;}
del  {background-color: #FFCACA; text-decoration: line-through;}
</style>
<style>/* style-autolinks */

.css.css, .property.property, .descriptor.descriptor {
    color: var(--a-normal-text);
    font-size: inherit;
    font-family: inherit;
}
.css::before, .property::before, .descriptor::before {
    content: "‘";
}
.css::after, .property::after, .descriptor::after {
    content: "’";
}
.property, .descriptor {
    /* Don't wrap property and descriptor names */
    white-space: nowrap;
}
.type { /* CSS value <type> */
    font-style: italic;
}
pre .property::before, pre .property::after {
    content: "";
}
[data-link-type="property"]::before,
[data-link-type="propdesc"]::before,
[data-link-type="descriptor"]::before,
[data-link-type="value"]::before,
[data-link-type="function"]::before,
[data-link-type="at-rule"]::before,
[data-link-type="selector"]::before,
[data-link-type="maybe"]::before {
    content: "‘";
}
[data-link-type="property"]::after,
[data-link-type="propdesc"]::after,
[data-link-type="descriptor"]::after,
[data-link-type="value"]::after,
[data-link-type="function"]::after,
[data-link-type="at-rule"]::after,
[data-link-type="selector"]::after,
[data-link-type="maybe"]::after {
    content: "’";
}

[data-link-type].production::before,
[data-link-type].production::after,
.prod [data-link-type]::before,
.prod [data-link-type]::after {
    content: "";
}

[data-link-type=element],
[data-link-type=element-attr] {
    font-family: Menlo, Consolas, "DejaVu Sans Mono", monospace;
    font-size: .9em;
}
[data-link-type=element]::before { content: "<" }
[data-link-type=element]::after  { content: ">" }

[data-link-type=biblio] {
    white-space: pre;
}</style>
<style>/* style-colors */

/* Any --*-text not paired with a --*-bg is assumed to have a transparent bg */
:root {
    color-scheme: light dark;

    --text: black;
    --bg: white;

    --unofficial-watermark: url(https://www.w3.org/StyleSheets/TR/2016/logos/UD-watermark);

    --logo-bg: #1a5e9a;
    --logo-active-bg: #c00;
    --logo-text: white;

    --tocnav-normal-text: #707070;
    --tocnav-normal-bg: var(--bg);
    --tocnav-hover-text: var(--tocnav-normal-text);
    --tocnav-hover-bg: #f8f8f8;
    --tocnav-active-text: #c00;
    --tocnav-active-bg: var(--tocnav-normal-bg);

    --tocsidebar-text: var(--text);
    --tocsidebar-bg: #f7f8f9;
    --tocsidebar-shadow: rgba(0,0,0,.1);
    --tocsidebar-heading-text: hsla(203,20%,40%,.7);

    --toclink-text: var(--text);
    --toclink-underline: #3980b5;
    --toclink-visited-text: var(--toclink-text);
    --toclink-visited-underline: #054572;

    --heading-text: #005a9c;

    --hr-text: var(--text);

    --algo-border: #def;

    --del-text: red;
    --del-bg: transparent;
    --ins-text: #080;
    --ins-bg: transparent;

    --a-normal-text: #034575;
    --a-normal-underline: #bbb;
    --a-visited-text: var(--a-normal-text);
    --a-visited-underline: #707070;
    --a-hover-bg: rgba(75%, 75%, 75%, .25);
    --a-active-text: #c00;
    --a-active-underline: #c00;

    --blockquote-border: silver;
    --blockquote-bg: transparent;
    --blockquote-text: currentcolor;

    --issue-border: #e05252;
    --issue-bg: #fbe9e9;
    --issue-text: var(--text);
    --issueheading-text: #831616;

    --example-border: #e0cb52;
    --example-bg: #fcfaee;
    --example-text: var(--text);
    --exampleheading-text: #574b0f;

    --note-border: #52e052;
    --note-bg: #e9fbe9;
    --note-text: var(--text);
    --noteheading-text: hsl(120, 70%, 30%);
    --notesummary-underline: silver;

    --assertion-border: #aaa;
    --assertion-bg: #eee;
    --assertion-text: black;

    --advisement-border: orange;
    --advisement-bg: #fec;
    --advisement-text: var(--text);
    --advisementheading-text: #b35f00;

    --warning-border: red;
    --warning-bg: hsla(40,100%,50%,0.95);
    --warning-text: var(--text);

    --amendment-border: #330099;
    --amendment-bg: #F5F0FF;
    --amendment-text: var(--text);
    --amendmentheading-text: #220066;

    --def-border: #8ccbf2;
    --def-bg: #def;
    --def-text: var(--text);
    --defrow-border: #bbd7e9;

    --datacell-border: silver;

    --indexinfo-text: #707070;

    --indextable-hover-text: black;
    --indextable-hover-bg: #f7f8f9;

    --outdatedspec-bg: rgba(0, 0, 0, .5);
    --outdatedspec-text: black;
    --outdated-bg: maroon;
    --outdated-text: white;
    --outdated-shadow: red;

    --editedrec-bg: darkorange;
}</style>
<style>/* style-counters */

body {
    counter-reset: example figure issue;
}
.issue {
    counter-increment: issue;
}
.issue:not(.no-marker)::before {
    content: "Issue " counter(issue);
}

.example {
    counter-increment: example;
}
.example:not(.no-marker)::before {
    content: "Example " counter(example);
}
.invalid.example:not(.no-marker)::before,
.illegal.example:not(.no-marker)::before {
    content: "Invalid Example" counter(example);
}

figcaption {
    counter-increment: figure;
}
figcaption:not(.no-marker)::before {
    content: "Figure " counter(figure) " ";
}</style>
<style>/* style-issues */

a[href].issue-return {
    float: right;
    float: inline-end;
    color: var(--issueheading-text);
    font-weight: bold;
    text-decoration: none;
}
</style>
<style>/* style-md-lists */

/* This is a weird hack for me not yet following the commonmark spec
   regarding paragraph and lists. */
[data-md] > :first-child {
    margin-top: 0;
}
[data-md] > :last-child {
    margin-bottom: 0;
}</style>
<style>/* style-selflinks */

:root {
    --selflink-text: white;
    --selflink-bg: gray;
    --selflink-hover-text: black;
}
.heading, .issue, .note, .example, li, dt {
    position: relative;
}
a.self-link {
    position: absolute;
    top: 0;
    left: calc(-1 * (3.5rem - 26px));
    width: calc(3.5rem - 26px);
    height: 2em;
    text-align: center;
    border: none;
    transition: opacity .2s;
    opacity: .5;
}
a.self-link:hover {
    opacity: 1;
}
.heading > a.self-link {
    font-size: 83%;
}
li > a.self-link {
    left: calc(-1 * (3.5rem - 26px) - 2em);
}
dfn > a.self-link {
    top: auto;
    left: auto;
    opacity: 0;
    width: 1.5em;
    height: 1.5em;
    background: var(--selflink-bg);
    color: var(--selflink-text);
    font-style: normal;
    transition: opacity .2s, background-color .2s, color .2s;
}
dfn:hover > a.self-link {
    opacity: 1;
}
dfn > a.self-link:hover {
    color: var(--selflink-hover-text);
}

a.self-link::before            { content: "¶"; }
.heading > a.self-link::before { content: "§"; }
dfn > a.self-link::before      { content: "#"; }
</style>
<style>/* style-syntax-highlighting */

code.highlight { padding: .1em; border-radius: .3em; }
pre.highlight, pre > code.highlight { display: block; padding: 1em; margin: .5em 0; overflow: auto; border-radius: 0; }

.highlight:not(.idl) { background: rgba(0, 0, 0, .03); }
c-[a] { color: #990055 } /* Keyword.Declaration */
c-[b] { color: #990055 } /* Keyword.Type */
c-[c] { color: #708090 } /* Comment */
c-[d] { color: #708090 } /* Comment.Multiline */
c-[e] { color: #0077aa } /* Name.Attribute */
c-[f] { color: #669900 } /* Name.Tag */
c-[g] { color: #222222 } /* Name.Variable */
c-[k] { color: #990055 } /* Keyword */
c-[l] { color: #000000 } /* Literal */
c-[m] { color: #000000 } /* Literal.Number */
c-[n] { color: #0077aa } /* Name */
c-[o] { color: #999999 } /* Operator */
c-[p] { color: #999999 } /* Punctuation */
c-[s] { color: #a67f59 } /* Literal.String */
c-[t] { color: #a67f59 } /* Literal.String.Single */
c-[u] { color: #a67f59 } /* Literal.String.Double */
c-[cp] { color: #708090 } /* Comment.Preproc */
c-[c1] { color: #708090 } /* Comment.Single */
c-[cs] { color: #708090 } /* Comment.Special */
c-[kc] { color: #990055 } /* Keyword.Constant */
c-[kn] { color: #990055 } /* Keyword.Namespace */
c-[kp] { color: #990055 } /* Keyword.Pseudo */
c-[kr] { color: #990055 } /* Keyword.Reserved */
c-[ld] { color: #000000 } /* Literal.Date */
c-[nc] { color: #0077aa } /* Name.Class */
c-[no] { color: #0077aa } /* Name.Constant */
c-[nd] { color: #0077aa } /* Name.Decorator */
c-[ni] { color: #0077aa } /* Name.Entity */
c-[ne] { color: #0077aa } /* Name.Exception */
c-[nf] { color: #0077aa } /* Name.Function */
c-[nl] { color: #0077aa } /* Name.Label */
c-[nn] { color: #0077aa } /* Name.Namespace */
c-[py] { color: #0077aa } /* Name.Property */
c-[ow] { color: #999999 } /* Operator.Word */
c-[mb] { color: #000000 } /* Literal.Number.Bin */
c-[mf] { color: #000000 } /* Literal.Number.Float */
c-[mh] { color: #000000 } /* Literal.Number.Hex */
c-[mi] { color: #000000 } /* Literal.Number.Integer */
c-[mo] { color: #000000 } /* Literal.Number.Oct */
c-[sb] { color: #a67f59 } /* Literal.String.Backtick */
c-[sc] { color: #a67f59 } /* Literal.String.Char */
c-[sd] { color: #a67f59 } /* Literal.String.Doc */
c-[se] { color: #a67f59 } /* Literal.String.Escape */
c-[sh] { color: #a67f59 } /* Literal.String.Heredoc */
c-[si] { color: #a67f59 } /* Literal.String.Interpol */
c-[sx] { color: #a67f59 } /* Literal.String.Other */
c-[sr] { color: #a67f59 } /* Literal.String.Regex */
c-[ss] { color: #a67f59 } /* Literal.String.Symbol */
c-[vc] { color: #0077aa } /* Name.Variable.Class */
c-[vg] { color: #0077aa } /* Name.Variable.Global */
c-[vi] { color: #0077aa } /* Name.Variable.Instance */
c-[il] { color: #000000 } /* Literal.Number.Integer.Long */
</style>
<style>/* style-darkmode */

@media (prefers-color-scheme: dark) {
    :root {
        --text: #ddd;
        --bg: black;

        --unofficial-watermark: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='400' height='400'%3E%3Cg fill='%23100808' transform='translate(200 200) rotate(-45) translate(-200 -200)' stroke='%23100808' stroke-width='3'%3E%3Ctext x='50%25' y='220' style='font: bold 70px sans-serif; text-anchor: middle; letter-spacing: 6px;'%3EUNOFFICIAL%3C/text%3E%3Ctext x='50%25' y='305' style='font: bold 70px sans-serif; text-anchor: middle; letter-spacing: 6px;'%3EDRAFT%3C/text%3E%3C/g%3E%3C/svg%3E");

        --logo-bg: #1a5e9a;
        --logo-active-bg: #c00;
        --logo-text: white;

        --tocnav-normal-text: #999;
        --tocnav-normal-bg: var(--bg);
        --tocnav-hover-text: var(--tocnav-normal-text);
        --tocnav-hover-bg: #080808;
        --tocnav-active-text: #f44;
        --tocnav-active-bg: var(--tocnav-normal-bg);

        --tocsidebar-text: var(--text);
        --tocsidebar-bg: #080808;
        --tocsidebar-shadow: rgba(255,255,255,.1);
        --tocsidebar-heading-text: hsla(203,20%,40%,.7);

        --toclink-text: var(--text);
        --toclink-underline: #6af;
        --toclink-visited-text: var(--toclink-text);
        --toclink-visited-underline: #054572;

        --heading-text: #8af;

        --hr-text: var(--text);

        --algo-border: #456;

        --del-text: #f44;
        --del-bg: transparent;
        --ins-text: #4a4;
        --ins-bg: transparent;

        --a-normal-text: #6af;
        --a-normal-underline: #555;
        --a-visited-text: var(--a-normal-text);
        --a-visited-underline: var(--a-normal-underline);
        --a-hover-bg: rgba(25%, 25%, 25%, .2);
        --a-active-text: #f44;
        --a-active-underline: var(--a-active-text);

        --borderedblock-bg: rgba(255, 255, 255, .05);

        --blockquote-border: silver;
        --blockquote-bg: var(--borderedblock-bg);
        --blockquote-text: currentcolor;

        --issue-border: #e05252;
        --issue-bg: var(--borderedblock-bg);
        --issue-text: var(--text);
        --issueheading-text: hsl(0deg, 70%, 70%);

        --example-border: hsl(50deg, 90%, 60%);
        --example-bg: var(--borderedblock-bg);
        --example-text: var(--text);
        --exampleheading-text: hsl(50deg, 70%, 70%);

        --note-border: hsl(120deg, 100%, 35%);
        --note-bg: var(--borderedblock-bg);
        --note-text: var(--text);
        --noteheading-text: hsl(120, 70%, 70%);
        --notesummary-underline: silver;

        --assertion-border: #444;
        --assertion-bg: var(--borderedblock-bg);
        --assertion-text: var(--text);

        --advisement-border: orange;
        --advisement-bg: #222218;
        --advisement-text: var(--text);
        --advisementheading-text: #f84;

        --warning-border: red;
        --warning-bg: hsla(40,100%,20%,0.95);
        --warning-text: var(--text);

        --amendment-border: #330099;
        --amendment-bg: #080010;
        --amendment-text: var(--text);
        --amendmentheading-text: #cc00ff;

        --def-border: #8ccbf2;
        --def-bg: #080818;
        --def-text: var(--text);
        --defrow-border: #136;

        --datacell-border: silver;

        --indexinfo-text: #aaa;

        --indextable-hover-text: var(--text);
        --indextable-hover-bg: #181818;

        --outdatedspec-bg: rgba(255, 255, 255, .5);
        --outdatedspec-text: black;
        --outdated-bg: maroon;
        --outdated-text: white;
        --outdated-shadow: red;

        --editedrec-bg: darkorange;
    }
    /* In case a transparent-bg image doesn't expect to be on a dark bg,
       which is quite common in practice... */
    img { background: white; }
}
@media (prefers-color-scheme: dark) {
    :root {
        --selflink-text: black;
        --selflink-bg: silver;
        --selflink-hover-text: white;
    }
}

@media (prefers-color-scheme: dark) {
    .highlight:not(.idl) { background: rgba(255, 255, 255, .05); }

    c-[a] { color: #d33682 } /* Keyword.Declaration */
    c-[b] { color: #d33682 } /* Keyword.Type */
    c-[c] { color: #2aa198 } /* Comment */
    c-[d] { color: #2aa198 } /* Comment.Multiline */
    c-[e] { color: #268bd2 } /* Name.Attribute */
    c-[f] { color: #b58900 } /* Name.Tag */
    c-[g] { color: #cb4b16 } /* Name.Variable */
    c-[k] { color: #d33682 } /* Keyword */
    c-[l] { color: #657b83 } /* Literal */
    c-[m] { color: #657b83 } /* Literal.Number */
    c-[n] { color: #268bd2 } /* Name */
    c-[o] { color: #657b83 } /* Operator */
    c-[p] { color: #657b83 } /* Punctuation */
    c-[s] { color: #6c71c4 } /* Literal.String */
    c-[t] { color: #6c71c4 } /* Literal.String.Single */
    c-[u] { color: #6c71c4 } /* Literal.String.Double */
    c-[ch] { color: #2aa198 } /* Comment.Hashbang */
    c-[cp] { color: #2aa198 } /* Comment.Preproc */
    c-[cpf] { color: #2aa198 } /* Comment.PreprocFile */
    c-[c1] { color: #2aa198 } /* Comment.Single */
    c-[cs] { color: #2aa198 } /* Comment.Special */
    c-[kc] { color: #d33682 } /* Keyword.Constant */
    c-[kn] { color: #d33682 } /* Keyword.Namespace */
    c-[kp] { color: #d33682 } /* Keyword.Pseudo */
    c-[kr] { color: #d33682 } /* Keyword.Reserved */
    c-[ld] { color: #657b83 } /* Literal.Date */
    c-[nc] { color: #268bd2 } /* Name.Class */
    c-[no] { color: #268bd2 } /* Name.Constant */
    c-[nd] { color: #268bd2 } /* Name.Decorator */
    c-[ni] { color: #268bd2 } /* Name.Entity */
    c-[ne] { color: #268bd2 } /* Name.Exception */
    c-[nf] { color: #268bd2 } /* Name.Function */
    c-[nl] { color: #268bd2 } /* Name.Label */
    c-[nn] { color: #268bd2 } /* Name.Namespace */
    c-[py] { color: #268bd2 } /* Name.Property */
    c-[ow] { color: #657b83 } /* Operator.Word */
    c-[mb] { color: #657b83 } /* Literal.Number.Bin */
    c-[mf] { color: #657b83 } /* Literal.Number.Float */
    c-[mh] { color: #657b83 } /* Literal.Number.Hex */
    c-[mi] { color: #657b83 } /* Literal.Number.Integer */
    c-[mo] { color: #657b83 } /* Literal.Number.Oct */
    c-[sa] { color: #6c71c4 } /* Literal.String.Affix */
    c-[sb] { color: #6c71c4 } /* Literal.String.Backtick */
    c-[sc] { color: #6c71c4 } /* Literal.String.Char */
    c-[dl] { color: #6c71c4 } /* Literal.String.Delimiter */
    c-[sd] { color: #6c71c4 } /* Literal.String.Doc */
    c-[se] { color: #6c71c4 } /* Literal.String.Escape */
    c-[sh] { color: #6c71c4 } /* Literal.String.Heredoc */
    c-[si] { color: #6c71c4 } /* Literal.String.Interpol */
    c-[sx] { color: #6c71c4 } /* Literal.String.Other */
    c-[sr] { color: #6c71c4 } /* Literal.String.Regex */
    c-[ss] { color: #6c71c4 } /* Literal.String.Symbol */
    c-[fm] { color: #268bd2 } /* Name.Function.Magic */
    c-[vc] { color: #cb4b16 } /* Name.Variable.Class */
    c-[vg] { color: #cb4b16 } /* Name.Variable.Global */
    c-[vi] { color: #cb4b16 } /* Name.Variable.Instance */
    c-[vm] { color: #cb4b16 } /* Name.Variable.Magic */
    c-[il] { color: #657b83 } /* Literal.Number.Integer.Long */
}
</style>
 <body class="h-entry">
  <div class="head">
   <p data-fill-with="logo"></p>
   <h1 class="p-name no-ref" id="title">P2249R2<br>Mixed comparisons for smart pointers</h1>
   <h2 class="no-num no-toc no-ref heading settled" id="profile-and-date"><span class="content">Published Proposal, <time class="dt-updated" datetime="2021-10-03">2021-10-03</time></span></h2>
   <div data-fill-with="spec-metadata">
    <dl>
     <dt>Issue Tracking:
     <dd><a href="#issues-index">Inline In Spec</a>
     <dt class="editor">Author:
     <dd class="editor p-author h-card vcard"><a class="p-name fn u-email email" href="mailto:giuseppe.dangelo@kdab.com">Giuseppe D'Angelo</a>
     <dt>Audience:
     <dd>LEWG
     <dt>Project:
     <dd>ISO/IEC JTC1/SC22/WG21 14882: Programming Language — C++
    </dl>
   </div>
   <div data-fill-with="warning"></div>
   <hr title="Separator for header">
  </div>
  <div class="p-summary" data-fill-with="abstract">
   <h2 class="no-num no-toc no-ref heading settled" id="abstract"><span class="content">Abstract</span></h2>
   <p>We propose to enable mixed comparisons for the Standard Library smart

    pointer class templates <code class="highlight"><c- n>unique_ptr</c-></code> and <code class="highlight"><c- n>shared_ptr</c-></code>, so that one can compare them against raw pointers.</p>
  </div>
  <nav data-fill-with="table-of-contents" id="toc">
   <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
   <ol class="toc" role="directory">
    <li><a href="#changelog"><span class="secno">1</span> <span class="content">Changelog</span></a>
    <li><a href="#tonytables"><span class="secno">2</span> <span class="content">Tony Tables</span></a>
    <li>
     <a href="#motivation"><span class="secno">3</span> <span class="content">Motivation and Scope</span></a>
     <ol class="toc">
      <li><a href="#associative"><span class="secno">3.1</span> <span class="content">Associative containers</span></a>
     </ol>
    <li><a href="#impact"><span class="secno">4</span> <span class="content">Impact On The Standard</span></a>
    <li>
     <a href="#designdecisions"><span class="secno">5</span> <span class="content">Design Decisions</span></a>
     <ol class="toc">
      <li><a href="#should-unique_ptr-have-the-full-set-of-ordering-operators-----or-just"><span class="secno">5.1</span> <span class="content">Should <code class="highlight"><c- n>unique_ptr</c-></code> have the full set of ordering operators (<code class="highlight"><c- o>&lt;</c-></code>, <code class="highlight"><c- o>&lt;=</c-></code>, <code class="highlight"><c- o>></c-></code>, <code class="highlight"><c- o>>=</c-></code>), or just <code class="highlight"><c- o>&lt;=></c-></code>?</span></a>
      <li><a href="#should-operators-for-a-smart_pointert-accept-only-t-or-anything-convertible-to-t"><span class="secno">5.2</span> <span class="content">Should operators for a <code class="highlight"><c- n>smart_pointer</c-><c- o>&lt;</c-><c- n>T</c-><c- o>></c-></code> accept only <code class="highlight"><c- n>T</c-><c- o>*</c-></code> or anything convertible to <code class="highlight"><c- n>T</c-><c- o>*</c-></code>?</span></a>
      <li><a href="#concepts"><span class="secno">5.3</span> <span class="content">Would these operations make the <code class="highlight"><c- n>equality_comparable_with</c-></code> or <code class="highlight"><c- n>three_way_comparable_with</c-></code> concepts satisfied between a smart pointer and a raw pointer?</span></a>
      <li><a href="#should-mixed-comparisons-between-different-smart-pointer-classes-be-allowed"><span class="secno">5.4</span> <span class="content">Should mixed comparisons between <em>different</em> smart pointer classes be allowed?</span></a>
     </ol>
    <li>
     <a href="#technicalspecifications"><span class="secno">6</span> <span class="content">Technical Specifications</span></a>
     <ol class="toc">
      <li><a href="#feature-testing-macro"><span class="secno">6.1</span> <span class="content">Feature testing macro</span></a>
      <li>
       <a href="#proposedwording"><span class="secno">6.2</span> <span class="content">Proposed wording</span></a>
       <ol class="toc">
        <li><a href="#unique_ptr"><span class="secno">6.2.1</span> <span class="content"><code class="highlight"><c- n>unique_ptr</c-></code></span></a>
        <li><a href="#shared_ptr"><span class="secno">6.2.2</span> <span class="content"><code class="highlight"><c- n>shared_ptr</c-></code></span></a>
       </ol>
     </ol>
    <li><a href="#implementation"><span class="secno">7</span> <span class="content">Implementation experience</span></a>
    <li><a href="#acknowledgements"><span class="secno">8</span> <span class="content">Acknowledgements</span></a>
    <li>
     <a href="#references"><span class="secno"></span> <span class="content">References</span></a>
     <ol class="toc">
      <li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
     </ol>
    <li><a href="#issues-index"><span class="secno"></span> <span class="content">Issues Index</span></a>
   </ol>
  </nav>
  <main>
   <h2 class="heading settled" data-level="1" id="changelog"><span class="secno">1. </span><span class="content">Changelog</span><a class="self-link" href="#changelog"></a></h2>
   <ul>
    <li data-md>
     <p>R2</p>
     <ul>
      <li data-md>
       <p>Fixes to the proposed wording.</p>
     </ul>
    <li data-md>
     <p>R1</p>
     <ul>
      <li data-md>
       <p>Added some clarifications to the design decisions, following a review on the LEWG mailing list.</p>
      <li data-md>
       <p>Made the proposed operators hidden friends.</p>
      <li data-md>
       <p>Rebased on top of the latest draft of the Standard.</p>
      <li data-md>
       <p>Minor fixes.</p>
     </ul>
    <li data-md>
     <p>R0</p>
     <ul>
      <li data-md>
       <p>First submission.</p>
     </ul>
   </ul>
   <h2 class="heading settled" data-level="2" id="tonytables"><span class="secno">2. </span><span class="content">Tony Tables</span><a class="self-link" href="#tonytables"></a></h2>
   <table>
    <thead>
     <tr>
      <th>Before
      <th>After
    <tbody>
     <tr>
      <td>
<pre class="highlight"><c- k>class</c-> <c- nc>Manager</c->
<c- p>{</c->
    <c- c1>// The Manager owns the Objects, therefore it uses smart pointers.</c->
    <c- c1>// The Manager gives out non-owning raw pointers to clients.</c->
    <c- c1>// A client gives the raw pointer back to the Manager, to tell it</c->
    <c- c1>// to act on that Object; the Manager has then to look up the Object</c->
    <c- c1>// in its storage.</c->

    <c- n>std</c-><c- o>::</c-><c- n>vector</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>></c-> <c- n>objects</c-><c- p>;</c->

<c- k>public</c-><c- o>:</c->
    <c- n>Object</c-><c- o>*</c-> <c- n>get_object</c-><c- p>(</c-><c- o>~~~</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c->
        <c- k>return</c-> <c- n>objects</c-><c- p>[</c-><c- o>~~~</c-><c- p>].</c-><c- n>get</c-><c- p>();</c->
    <c- p>}</c->

    <c- b>void</c-> <c- n>drop_object</c-><c- p>(</c-><c- n>Object</c-><c- o>*</c-> <c- n>input</c-><c- p>)</c->
    <c- p>{</c->
        <c- c1>// Must use erase_if and a custom comparison (e.g. a lambda).</c->
        <c- k>auto</c-> <c- n>isEqual</c-> <c- o>=</c-> <c- p>[</c-><c- n>input</c-><c- p>](</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>&amp;</c-> <c- n>o</c-><c- p>)</c-> <c- p>{</c->
            <c- k>return</c-> <c- n>o</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>input</c-><c- p>;</c->
        <c- p>};</c->
        <c- n>erase_if</c-><c- p>(</c-><c- n>objects</c-><c- p>,</c-> <c- n>input</c-><c- p>);</c->
    <c- p>}</c->

    <c- b>ssize_t</c-> <c- n>index_for_object</c-><c- p>(</c-><c- n>Object</c-><c- o>*</c-> <c- n>input</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c->
        <c- c1>// Same story.</c->
        <c- c1>// Code like this (predicates, etc.) may get duplicated all over the place</c->
        <c- c1>// where smart pointers are used in containers/algorithms. Surely,</c->
        <c- c1>// centralizing it is good practice, but there’s always the temptation of</c->
        <c- c1>// just writing the one-liner lambda and "moving on" rather than refactoring...</c->
        <c- k>auto</c-> <c- n>isEqual</c-> <c- o>=</c-> <c- p>[</c-><c- n>input</c-><c- p>](</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>&amp;</c-> <c- n>o</c-><c- p>)</c-> <c- p>{</c->
            <c- k>return</c-> <c- n>o</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>input</c-><c- p>;</c->
        <c- p>};</c->
        <c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>std</c-><c- o>::</c-><c- n>ranges</c-><c- o>::</c-><c- n>find_if</c-><c- p>(</c-><c- n>objects</c-><c- p>,</c-> <c- n>isEqual</c-><c- p>);</c->
        <c- c1>// etc.</c->
    <c- p>}</c->
<c- p>};</c->
</pre>
      <td>
<pre class="highlight"><c- k>class</c-> <c- nc>Manager</c->
<c- p>{</c->





    <c- n>std</c-><c- o>::</c-><c- n>vector</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>></c-> <c- n>objects</c-><c- p>;</c->

<c- k>public</c-><c- o>:</c->
    <c- n>Object</c-><c- o>*</c-> <c- n>get_object</c-><c- p>(</c-><c- o>~~~</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c->
        <c- k>return</c-> <c- n>objects</c-><c- p>[</c-><c- o>~~~</c-><c- p>].</c-><c- n>get</c-><c- p>();</c->
    <c- p>}</c->

    <c- b>void</c-> <c- n>drop_object</c-><c- p>(</c-><c- n>Object</c-><c- o>*</c-> <c- n>input</c-><c- p>)</c->
    <c- p>{</c->




        <c- c1>// Just use a value-based algorithm, no need for a predicate!</c->
        <ins><c- n>erase</c-><c- p>(</c-><c- n>objects</c-><c- p>,</c-> <c- n>input</c-><c- p>);</c-></ins>
    <c- p>}</c->

    <c- b>ssize_t</c-> <c- n>index_for_object</c-><c- p>(</c-><c- n>Object</c-><c- o>*</c-> <c- n>input</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c->




        <c- c1>// Same, just use a value-based algorithm.</c->
        <c- c1>// Unfortunately, the range version does not work as-is because</c->
        <c- c1>// std::equality_comparable_with&lt;std::unique_ptr&lt;Object>, Object*></c->
        <c- c1>// is not satisfied. See the discussion </c-><a href="#concepts"><c- c1>here</c-></a><c- c1>.</c->
        <ins><c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>std</c-><c- o>::</c-><del><c- n>ranges</c-><c- o>::</c-></del><c- n>find</c-><c- p>(</c-><c- n>objects</c-><c- p>,</c-> <c- n>input</c-><c- p>);</c-></ins>
        <c- c1>// etc.</c->
    <c- p>}</c->
<c- p>};</c->
</pre>
     <tr>
      <td>
<pre class="highlight"><c- c1>// Suppose insteat that the Manager needs to use an associative container rather than</c->
<c- c1>// a sequential container (e.g. mapping some data to each object).</c->
<c- c1>// Then, an heterogeneous comparator becomes a necessity -- we can’t possibly</c->
<c- c1>// look up a unique_ptr using another unique_ptr to the same object, especially</c->
<c- c1>// if clients give us non-owning raw pointers to act upon.</c->

<c- c1>// Heterogeneous comparator</c->
<c- k>template</c-> <c- o>&lt;</c-><c- k>class</c-> <c- nc>T</c-><c- o>></c-> <c- k>struct</c-> <c- nc>smart_pointer_comparator</c-> <c- p>{</c->
    <c- k>struct</c-> <c- nc>is_transparent</c-> <c- p>{};</c->

    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>lhs</c-> <c- o>&lt;</c-> <c- n>rhs</c-><c- p>;</c-> <c- p>}</c->
    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>T</c-><c- o>*</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>less</c-><c- p>()(</c-><c- n>lhs</c-><c- p>.</c-><c- n>get</c-><c- p>(),</c-> <c- n>rhs</c-><c- p>);</c-> <c- p>}</c->
    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>T</c-><c- o>*</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>less</c-><c- p>()(</c-><c- n>lhs</c-><c- p>,</c-> <c- n>rhs</c-><c- p>.</c-><c- n>get</c-><c- p>());</c-> <c- p>}</c->
<c- p>};</c->

<c- c1>// A sorted associative container with some data</c->
<c- n>std</c-><c- o>::</c-><c- n>map</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c-> <c- n>Data</c-><c- p>,</c->
    <c- n>smart_pointer_comparator</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>></c-> <c- n>objects</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- c1>// Heterogeneous lookup using a raw pointer</c->
<c- n>object</c-><c- o>*</c-> <c- n>ptr</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>objects</c-><c- p>.</c-><c- n>find</c-><c- p>(</c-><c- n>ptr</c-><c- p>);</c->
<c- k>if</c-> <c- p>(</c-><c- n>it</c-> <c- o>!=</c-> <c- n>objects</c-><c- p>.</c-><c- n>end</c-><c- p>())</c-> <c- p>{</c-> <c- n>use</c-><c- p>(</c-><c- n>it</c-><c- o>-></c-><c- n>second</c-><c- p>);</c-> <c- p>}</c->
</pre>
      <td>
<pre class="highlight"><c- c1>// No need for a custom comparator...</c->

















<c- c1>// ... just use the idiomatic std::less&lt;void></c->
<c- n>std</c-><c- o>::</c-><c- n>map</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c-> <c- n>Data</c-><c- p>,</c->
    <ins><c- nl>std</c-><c- p>:</c-><c- n>less</c-><c- o>&lt;></c-></ins><c- o>></c-> <c- n>objects</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- c1>// Heterogeneous lookup</c->
<c- n>Object</c-><c- o>*</c-> <c- n>ptr</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>objects</c-><c- p>.</c-><c- n>find</c-><c- p>(</c-><c- n>ptr</c-><c- p>);</c->
<c- k>if</c-> <c- p>(</c-><c- n>it</c-> <c- o>!=</c-> <c- n>objects</c-><c- p>.</c-><c- n>end</c-><c- p>())</c-> <c- p>{</c-> <c- n>use</c-><c- p>(</c-><c- n>it</c-><c- o>-></c-><c- n>second</c-><c- p>);</c-> <c- p>}</c->
</pre>
     <tr>
      <td>
<pre class="highlight"><c- c1>// Same, with an unordered associative container.</c->

<c- c1>// Heterogeneous hasher; [util.smartptr.hash] guarantees that both the</c->
<c- c1>// specializations below return the very same value for the same pointer.</c->
<c- k>template</c-> <c- o>&lt;</c-><c- k>class</c-> <c- nc>T</c-><c- o>></c-> <c- k>struct</c-> <c- nc>smart_pointer_hasher</c->
<c- p>{</c->
    <c- k>struct</c-> <c- nc>is_transparent</c-> <c- p>{};</c->
    <c- b>size_t</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>ptr</c-><c- p>)</c-> <c- k>const</c-> <c- p>{</c->
        <c- c1>// equal by definition to std::hash&lt;T*>(ptr.get()), that is, (*this)(ptr.get())</c->
        <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>hash</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>></c-><c- p>()(</c-><c- n>ptr</c-><c- p>);</c->
    <c- p>}</c->
    <c- b>size_t</c-> <c- nf>operator</c-><c- p>()(</c-><c- n>T</c-><c- o>*</c-> <c- n>ptr</c-><c- p>)</c-> <c- k>const</c-> <c- p>{</c->
        <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>hash</c-><c- o>&lt;</c-><c- n>T</c-><c- o>*></c-><c- p>()(</c-><c- n>ptr</c-><c- p>);</c->
    <c- p>}</c->
<c- p>};</c->

<c- c1>// Heterogeneous equality comparator</c->
<c- k>template</c-> <c- o>&lt;</c-><c- k>class</c-> <c- nc>T</c-><c- o>></c-> <c- k>struct</c-> <c- nc>smart_pointer_equal</c->
<c- p>{</c->
    <c- k>struct</c-> <c- nc>is_transparent</c-> <c- p>{};</c->
    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>lhs</c-> <c- o>==</c-> <c- n>rhs</c-><c- p>;</c-> <c- p>}</c->
    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>T</c-><c- o>*</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>lhs</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>rhs</c-><c- p>;</c-> <c- p>}</c->
    <c- b>bool</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>T</c-><c- o>*</c-> <c- n>lhs</c-><c- p>,</c-> <c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>rhs</c-><c- p>)</c-> <c- k>const</c->
    <c- p>{</c-> <c- k>return</c-> <c- n>lhs</c-> <c- o>==</c-> <c- n>rhs</c-><c- p>.</c-><c- n>get</c-><c- p>();</c-> <c- p>}</c->
<c- p>};</c->

<c- n>std</c-><c- o>::</c-><c- n>unordered_map</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c-> <c- n>Data</c-><c- p>,</c->
    <c- n>smart_pointer_hasher</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c->
    <c- n>smart_pointer_equal</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>>></c-> <c- n>objects</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- c1>// Heterogeneous lookup</c->
<c- n>Object</c-><c- o>*</c-> <c- n>ptr</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>objects</c-><c- p>.</c-><c- n>find</c-><c- p>(</c-><c- n>ptr</c-><c- p>);</c->
<c- k>if</c-> <c- p>(</c-><c- n>it</c-> <c- o>!=</c-> <c- n>objects</c-><c- p>.</c-><c- n>end</c-><c- p>())</c-> <c- p>{</c-> <c- n>use</c-><c- p>(</c-><c- n>it</c-><c- o>-></c-><c- n>second</c-><c- p>);</c-> <c- p>}</c->
</pre>
      <td>
<pre class="highlight"><c- c1>// </c-><a data-link-type="biblio" href="#biblio-p0919r3"><c- c1>[P0919R3]</c-></a><c- c1> does not provide a heterogeneous hasher for smart pointers,</c->
<c- c1>// so a custom one is still needed</c->


<c- k>template</c-> <c- o>&lt;</c-><c- k>class</c-> <c- nc>T</c-><c- o>></c-> <c- k>struct</c-> <c- nc>smart_pointer_hasher</c->
<c- p>{</c->
    <c- k>struct</c-> <c- nc>is_transparent</c-> <c- p>{};</c->
    <c- b>size_t</c-> <c- nf>operator</c-><c- p>()(</c-><c- k>const</c-> <c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>&amp;</c-> <c- n>ptr</c-><c- p>)</c-> <c- k>const</c-> <c- p>{</c->
        <c- c1>// equal by definition to std::hash&lt;T*>(ptr.get()), that is, (*this)(ptr.get())</c->
        <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>hash</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>>></c-><c- p>()(</c-><c- n>ptr</c-><c- p>);</c->
    <c- p>}</c->
    <c- b>size_t</c-> <c- nf>operator</c-><c- p>()(</c-><c- n>T</c-><c- o>*</c-> <c- n>ptr</c-><c- p>)</c-> <c- k>const</c-> <c- p>{</c->
        <c- k>return</c-> <c- n>std</c-><c- o>::</c-><c- n>hash</c-><c- o>&lt;</c-><c- n>T</c-><c- o>*></c-><c- p>()(</c-><c- n>ptr</c-><c- p>);</c->
    <c- p>}</c->
<c- p>};</c->

<c- c1>// Custom heterogeneous equality comparator not needed any more</c->











<c- n>std</c-><c- o>::</c-><c- n>unordered_map</c-><c- o>&lt;</c-><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c-> <c- n>Data</c-><c- p>,</c->
    <c- n>smart_pointer_hasher</c-><c- o>&lt;</c-><c- n>Object</c-><c- o>></c-><c- p>,</c->
    <ins><c- n>std</c-><c- o>::</c-><c- n>equal_to</c-><c- o>&lt;></c-></ins><c- o>></c-> <c- n>objects</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- c1>// Heterogeneous lookup</c->
<c- n>Object</c-><c- o>*</c-> <c- n>ptr</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- k>auto</c-> <c- n>it</c-> <c- o>=</c-> <c- n>objects</c-><c- p>.</c-><c- n>find</c-><c- p>(</c-><c- n>ptr</c-><c- p>);</c->
<c- k>if</c-> <c- p>(</c-><c- n>it</c-> <c- o>!=</c-> <c- n>objects</c-><c- p>.</c-><c- n>end</c-><c- p>())</c-> <c- p>{</c-> <c- n>use</c-><c- p>(</c-><c- n>it</c-><c- o>-></c-><c- n>second</c-><c- p>);</c-> <c- p>}</c->
</pre>
   </table>
   <h2 class="heading settled" data-level="3" id="motivation"><span class="secno">3. </span><span class="content">Motivation and Scope</span><a class="self-link" href="#motivation"></a></h2>
   <p>Smart pointer classes are universally recognized as the idiomatic way to
express ownership of a resource (very incomplete list: <a data-link-type="biblio" href="#biblio-sutter">[Sutter]</a>, <a data-link-type="biblio" href="#biblio-meyers">[Meyers]</a>, <a data-link-type="biblio" href="#biblio-r20">[R.20]</a>). On the other hand, raw pointers (and references) are supposed to be
used as non-owning types to access a resource.</p>
   <p>Both smart pointers and raw pointers, as their name says, share a common
semantic: <b>representing the address of an object</b>.</p>
   <p>This semantic comes with a set of meaningful operations; for instance, asking
if two (smart) pointers represent the address of the same object. <code class="highlight"><c- k>operator</c-><c- o>==</c-></code> is used to express this intent.</p>
   <p>Indeed, with the owning smart pointer class templates available in the Standard
Library (<code class="highlight"><c- n>unique_ptr</c-></code> and <code class="highlight"><c- n>shared_ptr</c-></code>), one can already use <code class="highlight"><c- k>operator</c-><c- o>==</c-></code> between two smart pointer objects (of the same class). However one <em>cannot</em> use
it between a smart pointer and a raw pointer, because the Standard Library is
lacking that set of overloads; instead, one has to manually extract the raw
pointer out of the smart pointer class:</p>
<pre class="highlight"><c- n>std</c-><c- o>::</c-><c- n>shared_ptr</c-><c- o>&lt;</c-><c- n>object</c-><c- o>></c-> <c- n>sptr1</c-><c- p>,</c-> <c- n>sptr2</c-><c- p>;</c->
<c- n>object</c-><c- o>*</c-> <c- n>rawptr</c-><c- p>;</c->

<c- c1>// Do both pointers refer to the same object?</c->
<c- k>if</c-> <c- p>(</c-><c- n>sptr1</c-> <c- o>==</c-> <c- n>sptr2</c-><c- p>)</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c->        <c- c1>// WORKS</c->
<c- k>if</c-> <c- p>(</c-><c- n>sptr1</c-> <c- o>==</c-> <c- n>rawptr</c-><c- p>)</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c->       <c- c1>// ERROR, no such operator</c->
<c- k>if</c-> <c- p>(</c-><c- n>sptr1</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>rawptr</c-><c- p>)</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c-> <c- c1>// WORKS; but why the extra syntax?</c->
</pre>
   <p>This discussion can be easily generalized to the full set of the six relational
operations; these operations have already well-established semantics, and are
indeed already defined between smart pointers objects (of the same class) or
between raw pointers, but they are not supported in mixed scenarios.</p>
   <div class="note" role="note"> We propose to remove this inconsistency by defining the relational operators
between the Standard Library owning smart pointer classes and raw pointers. </div>
   <p>Allowing mixed comparisons isn’t merely a "semantic fixup"; the situation where
one has to compare smart pointers and raw pointers commonly occurs in practice
(the typical use case is outlined in the first example in the <a href="#tonytables">§ 2 Tony Tables</a> above, where a "manager" object gives non-owning raw pointers to clients,
and the clients pass these raw pointers back to the manager, and now the manager
needs to do mixed comparisons).</p>
   <h3 class="heading settled" data-level="3.1" id="associative"><span class="secno">3.1. </span><span class="content">Associative containers</span><a class="self-link" href="#associative"></a></h3>
   <p>Moreover, we believe that allowing mixed comparisons is useful in order to
streamline heterogeneous comparison in associative containers for smart pointer
classes.</p>
   <p>The case of an associative container using a <code class="highlight"><c- n>unique_ptr</c-></code> as its key
type is particularly annoying; one cannot practically <em>ever</em> look up in such a
container using another <code class="highlight"><c- n>unique_ptr</c-></code>, as that would imply having two <code class="highlight"><c- n>unique_ptr</c-></code> objects owning the same object. Instead, the typical lookup is
heterogeneous (by raw pointer); this proposal is one step towards making it
more convenient to use, because it enables the usage of the standard <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>less</c-></code> or <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>equal_to</c-></code>.</p>
   <p>We however are not addresssing at all the issue of heterogeneous hashing for
smart pointers. While likely very useful in general, heterogeneous hashing can
be tackled separately by another proposal that builds on top of this one (for
instance, by making the <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>hash</c-></code> specializations for Standard smart pointers
1) <em>transparent</em>, and 2) able to hash the smart pointer’s <code class="highlight"><c- n>pointer_type</c-></code> / <code class="highlight"><c- n>element_type</c-><c- o>*</c-></code> as well as the smart pointer object itself. But more research
and field experience is certainly needed.)</p>
   <h2 class="heading settled" data-level="4" id="impact"><span class="secno">4. </span><span class="content">Impact On The Standard</span><a class="self-link" href="#impact"></a></h2>
   <p>This proposal is a pure library extension. It proposes changes to an existing
header, <code class="highlight"><c- o>&lt;</c-><c- n>memory</c-><c- o>></c-></code>, but it does not require changes to any standard classes or
functions and it does not require changes to any of the standard requirement
tables. The impact is positive: code that was ill-formed before becomes
well-formed.</p>
   <p>This proposal does not depend on any other library extensions.</p>
   <p>This proposal does not require any changes in the core language.</p>
   <p><a data-link-type="biblio" href="#biblio-p0805r2">[P0805R2]</a> is vaguely related to this proposal. It proposes to add mixed
comparisons between containers of the same type (for instance, to be able to
compare a <code class="highlight"><c- n>vector</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-></code> with a <code class="highlight"><c- n>vector</c-><c- o>&lt;</c-><c- b>long</c-><c- o>></c-></code>), without resorting to manual
calls to algorithms; instead, one can use a comparison operator. A quite
verbose call to <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>equal</c-><c- p>(</c-><c- n>v1</c-><c- p>.</c-><c- n>cbegin</c-><c- p>(),</c-> <c- n>v1</c-><c- p>.</c-><c- n>cend</c-><c- p>(),</c-> <c- n>v2</c-><c- p>.</c-><c- n>cbegin</c-><c- p>(),</c-> <c- n>v2</c-><c- p>.</c-><c- n>cend</c-><c- p>())</c-></code> can therefore be replaced by a much simpler <code class="highlight"><c- n>v1</c-> <c- o>==</c-> <c- n>v2</c-></code>. In this sense, <a data-link-type="biblio" href="#biblio-p0805r2">[P0805R2]</a> matches the spirit of the current proposal, although comparing
smart pointers and raw pointer does not require any algorithm, and does not
have such a verbose syntax.</p>
   <h2 class="heading settled" data-level="5" id="designdecisions"><span class="secno">5. </span><span class="content">Design Decisions</span><a class="self-link" href="#designdecisions"></a></h2>
   <h3 class="heading settled" data-level="5.1" id="should-unique_ptr-have-the-full-set-of-ordering-operators-----or-just"><span class="secno">5.1. </span><span class="content">Should <code class="highlight"><c- n>unique_ptr</c-></code> have the full set of ordering operators (<code class="highlight"><c- o>&lt;</c-></code>, <code class="highlight"><c- o>&lt;=</c-></code>, <code class="highlight"><c- o>></c-></code>, <code class="highlight"><c- o>>=</c-></code>), or just <code class="highlight"><c- o>&lt;=></c-></code>?</span><a class="self-link" href="#should-unique_ptr-have-the-full-set-of-ordering-operators-----or-just"></a></h3>
   <p><a data-link-type="biblio" href="#biblio-p1614r2">[P1614R2]</a> added support for <code class="highlight"><c- k>operator</c-><c- o>&lt;=></c-></code> across the Standard Library.
Notably, it <em>added</em> <code class="highlight"><c- k>operator</c-><c- o>&lt;=></c-></code> for <code class="highlight"><c- n>unique_ptr</c-></code>, leaving the other
four ordering operators (<code class="highlight"><c- o>&lt;</c-></code>, <code class="highlight"><c- o>&lt;=</c-></code>, <code class="highlight"><c- o>></c-></code>, <code class="highlight"><c- o>>=</c-></code>) untouched. On the
other hand, when looking at <code class="highlight"><c- n>shared_ptr</c-></code>, the same paper <em>replaced</em> these four
operators with <code class="highlight"><c- k>operator</c-><c- o>&lt;=></c-></code>.</p>
   <p>We believe that this was done in order to preserve the semantics for the
existing operators, which are defined in terms of customization points
(notably, <code class="highlight"><c- n>common_type</c-></code>; <code class="highlight"><c- n>unique_ptr</c-></code> can work in terms of a custom "fancy"
pointer type). We are not bound by any pre-existing semantics, so we are just
proposing <code class="highlight"><c- k>operator</c-><c- o>&lt;=></c-></code> for <code class="highlight"><c- n>unique_ptr</c-></code>.</p>
   <p class="issue" id="issue-0af64f40"><a class="self-link" href="#issue-0af64f40"></a> What does LEWG(I) think about this?</p>
   <h3 class="heading settled" data-level="5.2" id="should-operators-for-a-smart_pointert-accept-only-t-or-anything-convertible-to-t"><span class="secno">5.2. </span><span class="content">Should operators for a <code class="highlight"><c- n>smart_pointer</c-><c- o>&lt;</c-><c- n>T</c-><c- o>></c-></code> accept only <code class="highlight"><c- n>T</c-><c- o>*</c-></code> or anything convertible to <code class="highlight"><c- n>T</c-><c- o>*</c-></code>?</span><a class="self-link" href="#should-operators-for-a-smart_pointert-accept-only-t-or-anything-convertible-to-t"></a></h3>
   <p>The latter: anything convertible to it.</p>
   <p>The rationale of this proposal is that smart pointers should act like raw
pointers when it comes to comparison operators. For instance, raw pointers
allow for mixed comparisons if both pointers are convertible to their composite
pointer type ([expr.type]):</p>
<pre class="highlight"><c- n>Base</c-><c- o>*</c-> <c- n>b</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- n>Derived</c-><c- o>*</c-> <c- n>d</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- k>if</c-> <c- p>(</c-><c- n>b</c-> <c- o>==</c-> <c- n>d</c-><c- p>)</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c-> <c- c1>// OK</c->
</pre>
   <p>Therefore, we want the following to also work:</p>
<pre class="highlight"><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>Base</c-><c- o>></c-> <c- n>b</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->
<c- n>Derived</c-><c- o>*</c-> <c- n>d</c-> <c- o>=</c-> <c- o>~~~</c-><c- p>;</c->

<c- k>if</c-> <c- p>(</c-><c- n>b</c-> <c- o>==</c-> <c- n>d</c-><c- p>)</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c-> <c- c1>// OK, with this proposal</c->
</pre>
   <p>Please note that the existing comparison operators for smart pointers already
allow for mixed comparisons (between different specializations of the same
smart pointer class template). This proposal is therefore not introducing any
inconsistency.</p>
   <h3 class="heading settled" data-level="5.3" id="concepts"><span class="secno">5.3. </span><span class="content">Would these operations make the <code class="highlight"><c- n>equality_comparable_with</c-></code> or <code class="highlight"><c- n>three_way_comparable_with</c-></code> concepts satisfied between a smart pointer and a raw pointer?</span><a class="self-link" href="#concepts"></a></h3>
   <p>No. Adding the operations would indeed bring the Standard Library’s smart
pointer classes "one step closer" to satisfy those concepts, but they would still
be unsatisfied because there is no <code class="highlight"><c- n>common_reference_t</c-></code> between a smart pointer
and a raw pointer.</p>
   <p>Changing that is out of scope for the present proposal (and orthogonal to it).</p>
   <div class="note" role="note">
     In general, the current situation of comparison concepts and Standard Library
smart pointers is "suboptimal". For instance: 
<pre class="highlight"><c- k>static_assert</c-><c- p>(</c-><c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-><c- p>,</c-> <c- n>nullptr_t</c-><c- o>></c-><c- p>);</c->  <c- c1>// ERROR (1)</c->
<c- k>static_assert</c-><c- p>(</c-><c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>shared_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-><c- p>,</c-> <c- n>nullptr_t</c-><c- o>></c-><c- p>);</c->  <c- c1>// OK    (2)</c->

<c- k>static_assert</c-><c- p>(</c-><c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-><c- p>,</c-> <c- n>nullptr_t</c-><c- o>></c-><c- p>);</c-> <c- c1>// ERROR (3)</c->
<c- k>static_assert</c-><c- p>(</c-><c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>shared_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-><c- p>,</c-> <c- n>nullptr_t</c-><c- o>></c-><c- p>);</c-> <c- c1>// ERROR (4)</c->
</pre>
    <p>... despite the existence of the related operators between smart pointers and <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>nullptr_t</c-></code>. (1) and (3) fail because eventually the concepts are going to
require <code class="highlight"><c- n>unique_ptr</c-></code> to be copiable. (3) and (4) fail because they require <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>nullptr_t</c-></code> to be three-way comparable, which it isn’t (<code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>nullptr_t</c-></code> lacks relational operations).</p>
    <p>An analysis and discussion is available in <a data-link-type="biblio" href="#biblio-so_unique_ptr_comparable_thread">this thread on StackOverflow</a>. <a data-link-type="biblio" href="#biblio-p2403">[P2403]</a> and <a data-link-type="biblio" href="#biblio-p2404">[P2404]</a> are aiming at closing these semantics gaps (for <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>nullptr_t</c-></code>,
not for raw pointers in general).</p>
   </div>
   <h3 class="heading settled" data-level="5.4" id="should-mixed-comparisons-between-different-smart-pointer-classes-be-allowed"><span class="secno">5.4. </span><span class="content">Should mixed comparisons between <em>different</em> smart pointer classes be allowed?</span><a class="self-link" href="#should-mixed-comparisons-between-different-smart-pointer-classes-be-allowed"></a></h3>
   <p>There are some considerations that in our opinion apply to this case.</p>
   <p>The first is whether such an operation makes sense. From the abstract point of
view of "comparing the addresses of two objects", the operation is meaningful,
even if the addresses are represented by instances of different smart pointer
classes. As mentioned before, the currently existing comparison operators
of the smart pointer classes implement these semantics.</p>
   <div class="note" role="note">
    <p>Technically speaking, they implement a <em>superset</em> of these semantics, as they
use <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>less</c-></code> or <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>compare_three_way</c-></code> and therefore always yield a strict
weak ordering, even when the built-in comparison operator for pointers
would not guarantee any ordering.</p>
    <p>For instance:</p>
<pre class="highlight"><c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-> <c- n>a</c-><c- p>(</c-><c- k>new</c-> <c- b>int</c-><c- p>(</c-><c- mi>123</c-><c- p>));</c->
<c- n>std</c-><c- o>::</c-><c- n>unique_ptr</c-><c- o>&lt;</c-><c- b>int</c-><c- o>></c-> <c- n>b</c-><c- p>(</c-><c- k>new</c-> <c- b>int</c-><c- p>(</c-><c- mi>456</c-><c- p>));</c->

<c- k>if</c-> <c- p>(</c-><c- n>a</c-> <c- o>&lt;</c-> <c- n>b</c-><c- p>)</c->             <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c-> <c- c1>// well-defined behavior</c->
<c- k>if</c-> <c- p>(</c-><c- n>a</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>&lt;</c-> <c- n>b</c-><c- p>.</c-><c- n>get</c-><c- p>())</c-> <c- p>{</c-> <c- o>~~~</c-> <c- p>}</c-> <c- c1>// unspecified behavior [expr.rel/4.3]</c->
</pre>
    <p>The operations that we are proposing would also similarly work via <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>compare_three_way</c-></code>.</p>
   </div>
   <p>On the other hand: the Standard Library smart pointer classes that this
proposal deals with are all <em>owning</em> classes. One could therefore reason that
there is little utility at allowing a mixed comparison, because it’s likely to
be a mistake by the user. In a "ordinary" program, such comparisons would
inevitably yield false, because the same object cannot be owned by two smart
pointers of different classes (if it is, there is a bug in the program).</p>
   <p>There is some semantic leeway here, represented by the fact that the smart
pointer classes can hold custom deleters (incl. empty/no-op deleters), aliased
pointers (in the case of <code class="highlight"><c- n>shared_ptr</c-></code>), as well as as fancy pointer types (in
the case of <code class="highlight"><c- n>unique_ptr</c-></code>). In principle, one can write a perfectly legal
example where the same object is owned by smart pointers of different classes,
using custom deleters and/or custom fancy pointer types, and then wants to
compare the smart pointers (compare the addresses of the objects owned by
them).</p>
   <p>In some ways, this is hardly a realistic use case for allowing comparisons
between different smart pointer classes. The danger of misuse of such
comparisons, again in "ordinary" code, seems be stricly greater than their
usefulness, given the unlikelihood of valid use cases -- in the majority of
ordinary usages, the comparisons would be meaningless.</p>
   <p>We have therefore a tension between the abstract/ideal domain of the
operations, and the practical usage. The problem is that <strong>trying to solve it
via the type system alone isn’t possible</strong>. For instance, type-erased deleters
(in <code class="highlight"><c- n>shared_ptr</c-></code>) make it impossible to know if, given a <code class="highlight"><c- n>unique_ptr</c-><c- o>&lt;</c-><c- n>X</c-><c- p>,</c-> <c- n>D</c-><c- o>></c-></code> and
a <code class="highlight"><c- n>shared_ptr</c-><c- o>&lt;</c-><c- n>X</c-><c- o>></c-></code> object, a comparison between them is meaningless or instead
they have somehow been designed to "work together".</p>
   <p>A possible conservative solution could be to ban the mixed comparison via an
explicit constraint/requirement on the proposed operators. That would however
be nothing but a band-aid measure, as it wouldn’t extend to other owning and
non-owning smart pointer classes not from the Standard Library (like Boost’s,
Qt’s, and so on).</p>
   <p>In conclusion: given that</p>
   <ol>
    <li data-md>
     <p>although admittely rarely used in practice, the operation is still meaningful;</p>
    <li data-md>
     <p>a proper solution is not implementable in the type system; and</p>
    <li data-md>
     <p>simply disallowing two smart pointer classes (from the Standard
Library) while allowing third-party ones creates a major inconsistency,</p>
   </ol>
   <p>in the present proposal <strong>we are not going to explicitly ban the comparisons
between different smart pointer classes</strong>.</p>
   <p>Despite this fact, the <strong>current version of the proposal still forbids them</strong>,
although through indirect means: the <a href="#proposedwording">§ 6.2 Proposed wording</a> disallows them due
to the requirement clauses, which are currently unsatisfied (see <a href="#concepts">§ 5.3 Would these operations make the equality_comparable_with or three_way_comparable_with concepts satisfied between a smart pointer and a raw pointer?</a>)
when using the Standard Library smart pointer classes.</p>
   <p>Other owning and non-owning smart pointer classes, not from the Standard
Library, may or may not end up being comparable to the ones in the Standard
Library using the operators that we are proposing, depending on whether they
satisfy or not the requirements.</p>
   <div class="note" role="note">
    <p>A noteworthy case is <code class="highlight"><c- n>boost</c-><c- o>::</c-><c- n>intrusive_ptr</c-><c- o>&lt;</c-><c- n>T</c-><c- o>></c-></code>, which satisfies them -- also
because, notably, it features an implicit conversion from <code class="highlight"><c- n>T</c-><c- o>*</c-></code>. Thanks to Peter
Dimov for pointing it out.</p>
   </div>
   <h2 class="heading settled" data-level="6" id="technicalspecifications"><span class="secno">6. </span><span class="content">Technical Specifications</span><a class="self-link" href="#technicalspecifications"></a></h2>
   <p>All the proposed changes are relative to <a data-link-type="biblio" href="#biblio-n4892">[N4892]</a>.</p>
   <h3 class="heading settled" data-level="6.1" id="feature-testing-macro"><span class="secno">6.1. </span><span class="content">Feature testing macro</span><a class="self-link" href="#feature-testing-macro"></a></h3>
   <p>Add to the list in [version.syn]:</p>
<pre class="highlight"><c- cp>#define __cpp_lib_mixed_smart_pointer_comparisons YYYYMML  </c-><c- c1>// also in &lt;memory></c->
</pre>
   <p>with the value specified as usual (year and month of adoption).</p>
   <h3 class="heading settled" data-level="6.2" id="proposedwording"><span class="secno">6.2. </span><span class="content">Proposed wording</span><a class="self-link" href="#proposedwording"></a></h3>
   <h4 class="heading settled" data-level="6.2.1" id="unique_ptr"><span class="secno">6.2.1. </span><span class="content"><code class="highlight"><c- n>unique_ptr</c-></code></span><a class="self-link" href="#unique_ptr"></a></h4>
   <p>Modify [unique.ptr.single.general] as shown:</p>
   <blockquote>
<pre class="highlight"><ins>    <c- c1>// [unique.ptr.single.mixed.cmp], mixed comparisons</c->
    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>friend</c-> <c- b>bool</c-> <c- k>operator</c-><c- o>==</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->
    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
      <c- k>friend</c-> <c- n>compare_three_way_result_t</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>operator</c-><c- o>&lt;=></c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->

</ins>
    <c- c1>// disable copy from lvalue</c->
    <c- n>unique_ptr</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-><c- p>)</c-> <c- o>=</c-> <c- k>delete</c-><c- p>;</c->
    <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- k>operator</c-><c- o>=</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-><c- p>)</c-> <c- o>=</c-> <c- k>delete</c-><c- p>;</c->
<c- p>};</c->
</pre>
   </blockquote>
   <p>Add a new section at the end of the [unique.ptr.single] chapter:</p>
   <blockquote>
    <ins><strong>?.?.?.?.? Mixed comparison operators</strong> [unique.ptr.single.mixed.cmp]</ins>
<pre class="highlight"><ins><c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
  <c- k>requires</c-> <c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
    <c- k>friend</c-> <c- b>bool</c-> <c- k>operator</c-><c- o>==</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->
</ins></pre>
    <ins>1 <em>Constraints</em>: <code class="highlight"><c- n>U</c-></code> is not a specialization of <code class="highlight"><c- n>unique_ptr</c-></code>, and <code class="highlight"><c- n>is_null_pointer_v</c-><c- o>&lt;</c-><c- n>U</c-><c- o>></c-></code> is <code class="highlight">false</code>.</ins>
    <br> 
    <ins>2 <em>Returns</em>: <code class="highlight"><c- n>x</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>y</c-></code>.</ins>
    <br> 
<pre class="highlight"><ins><c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
  <c- k>requires</c-> <c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
  <c- k>friend</c-> <c- n>compare_three_way_result_t</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
    <c- k>operator</c-><c- o>&lt;=></c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->
</ins></pre>
    <ins>3 <em>Constraints</em>: <code class="highlight"><c- n>U</c-></code> is not a specialization of <code class="highlight"><c- n>unique_ptr</c-></code>, and <code class="highlight"><c- n>is_null_pointer_v</c-><c- o>&lt;</c-><c- n>U</c-><c- o>></c-></code> is <code class="highlight">false</code>.</ins>
    <br> 
    <ins>4 <em>Returns</em>: <code class="highlight"><c- n>compare_three_way</c-><c- p>()(</c-><c- n>x</c-><c- p>.</c-><c- n>get</c-><c- p>(),</c-> <c- n>y</c-><c- p>)</c-></code>.</ins>
   </blockquote>
   <p>Modify [unique.ptr.runtime.general] as shown:</p>
   <blockquote>
<pre class="highlight"><ins>    <c- c1>// mixed comparisons</c->
    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>friend</c-> <c- b>bool</c-> <c- k>operator</c-><c- o>==</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->
    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
      <c- k>friend</c-> <c- n>compare_three_way_result_t</c-><c- o>&lt;</c-><c- n>pointer</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>operator</c-><c- o>&lt;=></c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- n>x</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>y</c-><c- p>);</c->

</ins>
    <c- c1>// disable copy from lvalue</c->
    <c- n>unique_ptr</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-><c- p>)</c-> <c- o>=</c-> <c- k>delete</c-><c- p>;</c->
    <c- n>unique_ptr</c-><c- o>&amp;</c-> <c- k>operator</c-><c- o>=</c-><c- p>(</c-><c- k>const</c-> <c- n>unique_ptr</c-><c- o>&amp;</c-><c- p>)</c-> <c- o>=</c-> <c- k>delete</c-><c- p>;</c->
<c- p>};</c->
</pre>
   </blockquote>
   <h4 class="heading settled" data-level="6.2.2" id="shared_ptr"><span class="secno">6.2.2. </span><span class="content"><code class="highlight"><c- n>shared_ptr</c-></code></span><a class="self-link" href="#shared_ptr"></a></h4>
   <p>Modify [util.smartptr.shared.general] as shown:</p>
   <blockquote>
<pre class="highlight">    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- b>bool</c-> <c- n>owner_before</c-><c- p>(</c-><c- k>const</c-> <c- n>weak_ptr</c-><c- o>&lt;</c-><c- n>U</c-><c- o>>&amp;</c-> <c- n>b</c-><c- p>)</c-> <c- k>const</c-> <c- k>noexcept</c-><c- p>;</c->

<ins>
    <c- c1>// [util.smartptr.shared.mixed.cmp], mixed comparisons</c->
    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>friend</c-> <c- b>bool</c-> <c- k>operator</c-><c- o>==</c-><c- p>(</c-><c- k>const</c-> <c- n>shared_ptr</c-><c- o>&amp;</c-> <c- n>a</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>b</c-><c- p>);</c->

    <c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
      <c- k>requires</c-> <c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
      <c- k>friend</c-> <c- n>compare_three_way_result_t</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
        <c- k>operator</c-><c- o>&lt;=></c-><c- p>(</c-><c- k>const</c-> <c- n>shared_ptr</c-><c- o>&amp;</c-> <c- n>a</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>b</c-><c- p>);</c->
</ins>
<c- p>};</c->
</pre>
   </blockquote>
   <p>Insert a new section after [util.smartptr.shared.cmp]:</p>
   <blockquote>
    <ins><strong>?.?.?.? Mixed comparison operators</strong> [util.smartptr.shared.mixed.cmp]</ins>
<pre class="highlight"><ins><c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
  <c- k>requires</c-> <c- n>equality_comparable_with</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
    <c- k>friend</c-> <c- b>bool</c-> <c- k>operator</c-><c- o>==</c-><c- p>(</c-><c- k>const</c-> <c- n>shared_ptr</c-><c- o>&amp;</c-> <c- n>a</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>b</c-><c- p>);</c->
</ins></pre>
    <ins>1 <em>Constraints</em>: <code class="highlight"><c- n>U</c-></code> is not a specialization of <code class="highlight"><c- n>shared_ptr</c-></code>, and <code class="highlight"><c- n>is_null_pointer_v</c-><c- o>&lt;</c-><c- n>U</c-><c- o>></c-></code> is <code class="highlight">false</code>.</ins>
    <br> 
    <ins>2 <em>Returns</em>: <code class="highlight"><c- n>a</c-><c- p>.</c-><c- n>get</c-><c- p>()</c-> <c- o>==</c-> <c- n>b</c-></code>.</ins>
<pre class="highlight"><ins><c- k>template</c-><c- o>&lt;</c-><c- k>class</c-> <c- nc>U</c-><c- o>></c->
  <c- k>requires</c-> <c- n>three_way_comparable_with</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
  <c- k>friend</c-> <c- n>compare_three_way_result_t</c-><c- o>&lt;</c-><c- n>element_type</c-><c- o>*</c-><c- p>,</c-> <c- n>U</c-><c- o>></c->
    <c- k>operator</c-><c- o>&lt;=></c-><c- p>(</c-><c- k>const</c-> <c- n>shared_ptr</c-><c- o>&amp;</c-> <c- n>a</c-><c- p>,</c-> <c- k>const</c-> <c- n>U</c-><c- o>&amp;</c-> <c- n>b</c-><c- p>);</c->
</ins></pre>
    <ins>3 <em>Constraints</em>: <code class="highlight"><c- n>U</c-></code> is not a specialization of <code class="highlight"><c- n>shared_ptr</c-></code>, and <code class="highlight"><c- n>is_null_pointer_v</c-><c- o>&lt;</c-><c- n>U</c-><c- o>></c-></code> is <code class="highlight">false</code>.</ins>
    <br> 
    <ins>4 <em>Returns</em>: <code class="highlight"><c- n>compare_three_way</c-><c- p>()(</c-><c- n>a</c-><c- p>.</c-><c- n>get</c-><c- p>(),</c-> <c- n>b</c-><c- p>)</c-></code>.</ins>
   </blockquote>
   <h2 class="heading settled" data-level="7" id="implementation"><span class="secno">7. </span><span class="content">Implementation experience</span><a class="self-link" href="#implementation"></a></h2>
   <p>A working prototype of the changes proposed by this paper,
done on top of GCC 11, is available in this <a data-link-type="biblio" href="#biblio-p2249-gcc">GCC branch</a> on
GitHub.</p>
   <h2 class="heading settled" data-level="8" id="acknowledgements"><span class="secno">8. </span><span class="content">Acknowledgements</span><a class="self-link" href="#acknowledgements"></a></h2>
   <p>Credits for this idea go to Marc Mutz, who raised the question on the <a data-link-type="biblio" href="#biblio-marcmutzreflector">LEWG reflector</a>, receiving a positive feedback.</p>
   <p>Thanks to the reviewers of early drafts of this paper on the <a data-link-type="biblio" href="#biblio-std-proposals">std-proposals</a> mailing list.</p>
   <p>Thanks to KDAB for supporting this work.</p>
   <p>All remaining errors are ours and ours only.</p>
  </main>
<script>
(function() {
  "use strict";
  var collapseSidebarText = '<span aria-hidden="true">←</span> '
                          + '<span>Collapse Sidebar</span>';
  var expandSidebarText   = '<span aria-hidden="true">→</span> '
                          + '<span>Pop Out Sidebar</span>';
  var tocJumpText         = '<span aria-hidden="true">↑</span> '
                          + '<span>Jump to Table of Contents</span>';

  var sidebarMedia = window.matchMedia('screen and (min-width: 78em)');
  var autoToggle   = function(e){ toggleSidebar(e.matches) };
  if(sidebarMedia.addListener) {
    sidebarMedia.addListener(autoToggle);
  }

  function toggleSidebar(on) {
    if (on == undefined) {
      on = !document.body.classList.contains('toc-sidebar');
    }

    /* Don’t scroll to compensate for the ToC if we’re above it already. */
    var headY = 0;
    var head = document.querySelector('.head');
    if (head) {
      // terrible approx of "top of ToC"
      headY += head.offsetTop + head.offsetHeight;
    }
    var skipScroll = window.scrollY < headY;

    var toggle = document.getElementById('toc-toggle');
    var tocNav = document.getElementById('toc');
    if (on) {
      var tocHeight = tocNav.offsetHeight;
      document.body.classList.add('toc-sidebar');
      document.body.classList.remove('toc-inline');
      toggle.innerHTML = collapseSidebarText;
      if (!skipScroll) {
        window.scrollBy(0, 0 - tocHeight);
      }
      tocNav.focus();
      sidebarMedia.addListener(autoToggle); // auto-collapse when out of room
    }
    else {
      document.body.classList.add('toc-inline');
      document.body.classList.remove('toc-sidebar');
      toggle.innerHTML = expandSidebarText;
      if (!skipScroll) {
        window.scrollBy(0, tocNav.offsetHeight);
      }
      if (toggle.matches(':hover')) {
        /* Unfocus button when not using keyboard navigation,
           because I don’t know where else to send the focus. */
        toggle.blur();
      }
    }
  }

  function createSidebarToggle() {
    /* Create the sidebar toggle in JS; it shouldn’t exist when JS is off. */
    var toggle = document.createElement('a');
      /* This should probably be a button, but appearance isn’t standards-track.*/
    toggle.id = 'toc-toggle';
    toggle.class = 'toc-toggle';
    toggle.href = '#toc';
    toggle.innerHTML = collapseSidebarText;

    sidebarMedia.addListener(autoToggle);
    var toggler = function(e) {
      e.preventDefault();
      sidebarMedia.removeListener(autoToggle); // persist explicit off states
      toggleSidebar();
      return false;
    }
    toggle.addEventListener('click', toggler, false);


    /* Get <nav id=toc-nav>, or make it if we don’t have one. */
    var tocNav = document.getElementById('toc-nav');
    if (!tocNav) {
      tocNav = document.createElement('p');
      tocNav.id = 'toc-nav';
      /* Prepend for better keyboard navigation */
      document.body.insertBefore(tocNav, document.body.firstChild);
    }
    /* While we’re at it, make sure we have a Jump to Toc link. */
    var tocJump = document.getElementById('toc-jump');
    if (!tocJump) {
      tocJump = document.createElement('a');
      tocJump.id = 'toc-jump';
      tocJump.href = '#toc';
      tocJump.innerHTML = tocJumpText;
      tocNav.appendChild(tocJump);
    }

    tocNav.appendChild(toggle);
  }

  var toc = document.getElementById('toc');
  if (toc) {
    createSidebarToggle();
    toggleSidebar(sidebarMedia.matches);

    /* If the sidebar has been manually opened and is currently overlaying the text
       (window too small for the MQ to add the margin to body),
       then auto-close the sidebar once you click on something in there. */
    toc.addEventListener('click', function(e) {
      if(e.target.tagName.toLowerCase() == "a" && document.body.classList.contains('toc-sidebar') && !sidebarMedia.matches) {
        toggleSidebar(false);
      }
    }, false);
  }
  else {
    console.warn("Can’t find Table of Contents. Please use <nav id='toc'> around the ToC.");
  }

  /* Wrap tables in case they overflow */
  var tables = document.querySelectorAll(':not(.overlarge) > table.data, :not(.overlarge) > table.index');
  var numTables = tables.length;
  for (var i = 0; i < numTables; i++) {
    var table = tables[i];
    var wrapper = document.createElement('div');
    wrapper.className = 'overlarge';
    table.parentNode.insertBefore(wrapper, table);
    wrapper.appendChild(table);
  }

})();
</script>
  <h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
  <h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
  <dl>
   <dt id="biblio-marcmutzreflector">[MarcMutzReflector]
   <dd>Marc Mutz. <a href="https://lists.isocpp.org/lib-ext/2020/07/15873.php"><cite>unique_ptr&lt;T> @ T* relational operators / comparison</cite></a>. URL: <a href="https://lists.isocpp.org/lib-ext/2020/07/15873.php">https://lists.isocpp.org/lib-ext/2020/07/15873.php</a>
   <dt id="biblio-meyers">[Meyers]
   <dd>Scott Meyers. <a href="https://www.oreilly.com/library/view/effective-modern-c/9781491908419/ch04.html"><cite>Effective Modern C++, Chapter 4. Smart Pointers</cite></a>. URL: <a href="https://www.oreilly.com/library/view/effective-modern-c/9781491908419/ch04.html">https://www.oreilly.com/library/view/effective-modern-c/9781491908419/ch04.html</a>
   <dt id="biblio-n4892">[N4892]
   <dd>Thomas Köppe. <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/n4892.pdf"><cite>Working Draft, Standard for Programming Language C++</cite></a>. URL: <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/n4892.pdf">http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/n4892.pdf</a>
   <dt id="biblio-p0805r2">[P0805R2]
   <dd>Marshall Clow. <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0805r2.html"><cite>Comparing Containers</cite></a>. URL: <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0805r2.html">http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0805r2.html</a>
   <dt id="biblio-p0919r3">[P0919R3]
   <dd>Mateusz Pusz. <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0919r3.html"><cite>Heterogeneous lookup for unordered containers</cite></a>. URL: <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0919r3.html">http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0919r3.html</a>
   <dt id="biblio-p1614r2">[P1614R2]
   <dd>Barry Revzin. <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p1614r2.html"><cite>The Mothership has Landed</cite></a>. URL: <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p1614r2.html">http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p1614r2.html</a>
   <dt id="biblio-p2249-gcc">[P2249-GCC]
   <dd>Giuseppe D'Angelo. <a href="https://github.com/dangelog/gcc/tree/std-proposals"><cite>P2249 prototype implementation</cite></a>. URL: <a href="https://github.com/dangelog/gcc/tree/std-proposals">https://github.com/dangelog/gcc/tree/std-proposals</a>
   <dt id="biblio-p2403">[P2403]
   <dd>Justin Bassett. <a href="https://wg21.link/P2403"><cite>nullopt_t and nullptr_t should both have operator&lt;=> and operator==</cite></a>. URL: <a href="https://wg21.link/P2403">https://wg21.link/P2403</a>
   <dt id="biblio-p2404">[P2404]
   <dd>Justin Bassett. <a href="https://wg21.link/P2404"><cite>Relaxing comparison_relation_with's common reference requirements to support move-only types</cite></a>. URL: <a href="https://wg21.link/P2404">https://wg21.link/P2404</a>
   <dt id="biblio-r20">[R.20]
   <dd>Bjarne Stroustrup; Herb Sutter. <a href="https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r20-use-unique_ptr-or-shared_ptr-to-represent-ownership"><cite>C++ Core Guidelines, R.20: Use `unique_ptr` or `shared_ptr` to represent ownership</cite></a>. URL: <a href="https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r20-use-unique_ptr-or-shared_ptr-to-represent-ownership">https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r20-use-unique_ptr-or-shared_ptr-to-represent-ownership</a>
   <dt id="biblio-so_unique_ptr_comparable_thread">[SO_unique_ptr_comparable_thread]
   <dd><a href="https://stackoverflow.com/questions/66937947/why-is-unique-ptr-not-equality-comparable-with-nullptr-t-in-c20"><cite>Why is unique_ptr not equality_comparable_with nullptr_t in C++20?</cite></a>. URL: <a href="https://stackoverflow.com/questions/66937947/why-is-unique-ptr-not-equality-comparable-with-nullptr-t-in-c20">https://stackoverflow.com/questions/66937947/why-is-unique-ptr-not-equality-comparable-with-nullptr-t-in-c20</a>
   <dt id="biblio-std-proposals">[Std-proposals]
   <dd><a href="https://lists.isocpp.org/std-proposals/2021/01/2308.php"><cite>P2249 discussion on the std-proposals mailing list</cite></a>. URL: <a href="https://lists.isocpp.org/std-proposals/2021/01/2308.php">https://lists.isocpp.org/std-proposals/2021/01/2308.php</a>
   <dt id="biblio-sutter">[Sutter]
   <dd>Herb Sutter. <a href="https://herbsutter.com/elements-of-modern-c-style/"><cite>Elements of Modern C++ Style</cite></a>. URL: <a href="https://herbsutter.com/elements-of-modern-c-style/">https://herbsutter.com/elements-of-modern-c-style/</a>
  </dl>
  <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content">Issues Index</span><a class="self-link" href="#issues-index"></a></h2>
  <div style="counter-reset:issue">
   <div class="issue"> What does LEWG(I) think about this? <a class="issue-return" href="#issue-0af64f40" title="Jump to section">↵</a></div>
  </div>