libs/mp11/doc/html/mp11.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4 <meta charset="UTF-8">
   5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
   7 <meta name="generator" content="Asciidoctor 1.5.8">
   8 <meta name="author" content="Peter Dimov">
   9 <title>Boost.Mp11: A C++11 metaprogramming library</title>
  10 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
  11 <style>
  12 /* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
  13 /* Uncomment @import statement below to use as custom stylesheet */
  14 /*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
  15 article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
  16 audio,canvas,video{display:inline-block}
  17 audio:not([controls]){display:none;height:0}
  18 script{display:none!important}
  19 html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
  20 a{background:transparent}
  21 a:focus{outline:thin dotted}
  22 a:active,a:hover{outline:0}
  23 h1{font-size:2em;margin:.67em 0}
  24 abbr[title]{border-bottom:1px dotted}
  25 b,strong{font-weight:bold}
  26 dfn{font-style:italic}
  27 hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
  28 mark{background:#ff0;color:#000}
  29 code,kbd,pre,samp{font-family:monospace;font-size:1em}
  30 pre{white-space:pre-wrap}
  31 q{quotes:"\201C" "\201D" "\2018" "\2019"}
  32 small{font-size:80%}
  33 sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
  34 sup{top:-.5em}
  35 sub{bottom:-.25em}
  36 img{border:0}
  37 svg:not(:root){overflow:hidden}
  38 figure{margin:0}
  39 fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
  40 legend{border:0;padding:0}
  41 button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
  42 button,input{line-height:normal}
  43 button,select{text-transform:none}
  44 button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
  45 button[disabled],html input[disabled]{cursor:default}
  46 input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
  47 button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
  48 textarea{overflow:auto;vertical-align:top}
  49 table{border-collapse:collapse;border-spacing:0}
  50 *,*::before,*::after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
  51 html,body{font-size:100%}
  52 body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto;tab-size:4;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
  53 a:hover{cursor:pointer}
  54 img,object,embed{max-width:100%;height:auto}
  55 object,embed{height:100%}
  56 img{-ms-interpolation-mode:bicubic}
  57 .left{float:left!important}
  58 .right{float:right!important}
  59 .text-left{text-align:left!important}
  60 .text-right{text-align:right!important}
  61 .text-center{text-align:center!important}
  62 .text-justify{text-align:justify!important}
  63 .hide{display:none}
  64 img,object,svg{display:inline-block;vertical-align:middle}
  65 textarea{height:auto;min-height:50px}
  66 select{width:100%}
  67 .center{margin-left:auto;margin-right:auto}
  68 .stretch{width:100%}
  69 .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
  70 div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
  71 a{color:#2156a5;text-decoration:underline;line-height:inherit}
  72 a:hover,a:focus{color:#1d4b8f}
  73 a img{border:none}
  74 p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
  75 p aside{font-size:.875em;line-height:1.35;font-style:italic}
  76 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
  77 h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
  78 h1{font-size:2.125em}
  79 h2{font-size:1.6875em}
  80 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
  81 h4,h5{font-size:1.125em}
  82 h6{font-size:1em}
  83 hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
  84 em,i{font-style:italic;line-height:inherit}
  85 strong,b{font-weight:bold;line-height:inherit}
  86 small{font-size:60%;line-height:inherit}
  87 code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
  88 ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
  89 ul,ol{margin-left:1.5em}
  90 ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
  91 ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
  92 ul.square{list-style-type:square}
  93 ul.circle{list-style-type:circle}
  94 ul.disc{list-style-type:disc}
  95 ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
  96 dl dt{margin-bottom:.3125em;font-weight:bold}
  97 dl dd{margin-bottom:1.25em}
  98 abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
  99 abbr{text-transform:none}
 100 blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
 101 blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
 102 blockquote cite::before{content:"\2014 \0020"}
 103 blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
 104 blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
 105 @media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
 106 h1{font-size:2.75em}
 107 h2{font-size:2.3125em}
 108 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
 109 h4{font-size:1.4375em}}
 110 table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
 111 table thead,table tfoot{background:#f7f8f7}
 112 table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
 113 table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
 114 table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
 115 table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
 116 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
 117 h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
 118 .clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
 119 .clearfix::after,.float-group::after{clear:both}
 120 *:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed;word-wrap:break-word}
 121 *:not(pre)>code.nobreak{word-wrap:normal}
 122 *:not(pre)>code.nowrap{white-space:nowrap}
 123 pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
 124 em em{font-style:normal}
 125 strong strong{font-weight:400}
 126 .keyseq{color:rgba(51,51,51,.8)}
 127 kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
 128 .keyseq kbd:first-child{margin-left:0}
 129 .keyseq kbd:last-child{margin-right:0}
 130 .menuseq,.menuref{color:#000}
 131 .menuseq b:not(.caret),.menuref{font-weight:inherit}
 132 .menuseq{word-spacing:-.02em}
 133 .menuseq b.caret{font-size:1.25em;line-height:.8}
 134 .menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
 135 b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
 136 b.button::before{content:"[";padding:0 3px 0 2px}
 137 b.button::after{content:"]";padding:0 2px 0 3px}
 138 p a>code:hover{color:rgba(0,0,0,.9)}
 139 #header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
 140 #header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
 141 #header::after,#content::after,#footnotes::after,#footer::after{clear:both}
 142 #content{margin-top:1.25em}
 143 #content::before{content:none}
 144 #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
 145 #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
 146 #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
 147 #header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
 148 #header .details span:first-child{margin-left:-.125em}
 149 #header .details span.email a{color:rgba(0,0,0,.85)}
 150 #header .details br{display:none}
 151 #header .details br+span::before{content:"\00a0\2013\00a0"}
 152 #header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
 153 #header .details br+span#revremark::before{content:"\00a0|\00a0"}
 154 #header #revnumber{text-transform:capitalize}
 155 #header #revnumber::after{content:"\00a0"}
 156 #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
 157 #toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
 158 #toc>ul{margin-left:.125em}
 159 #toc ul.sectlevel0>li>a{font-style:italic}
 160 #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
 161 #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
 162 #toc li{line-height:1.3334;margin-top:.3334em}
 163 #toc a{text-decoration:none}
 164 #toc a:active{text-decoration:underline}
 165 #toctitle{color:#7a2518;font-size:1.2em}
 166 @media screen and (min-width:768px){#toctitle{font-size:1.375em}
 167 body.toc2{padding-left:15em;padding-right:0}
 168 #toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
 169 #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
 170 #toc.toc2>ul{font-size:.9em;margin-bottom:0}
 171 #toc.toc2 ul ul{margin-left:0;padding-left:1em}
 172 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
 173 body.toc2.toc-right{padding-left:0;padding-right:15em}
 174 body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
 175 @media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
 176 #toc.toc2{width:20em}
 177 #toc.toc2 #toctitle{font-size:1.375em}
 178 #toc.toc2>ul{font-size:.95em}
 179 #toc.toc2 ul ul{padding-left:1.25em}
 180 body.toc2.toc-right{padding-left:0;padding-right:20em}}
 181 #content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
 182 #content #toc>:first-child{margin-top:0}
 183 #content #toc>:last-child{margin-bottom:0}
 184 #footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
 185 #footer-text{color:rgba(255,255,255,.8);line-height:1.44}
 186 #content{margin-bottom:.625em}
 187 .sect1{padding-bottom:.625em}
 188 @media screen and (min-width:768px){#content{margin-bottom:1.25em}
 189 .sect1{padding-bottom:1.25em}}
 190 .sect1:last-child{padding-bottom:0}
 191 .sect1+.sect1{border-top:1px solid #e7e7e9}
 192 #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
 193 #content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
 194 #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
 195 #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
 196 #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
 197 .audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
 198 .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
 199 table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
 200 .paragraph.lead>p,#preamble>.sectionbody>[class="paragraph"]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
 201 table.tableblock #preamble>.sectionbody>[class="paragraph"]:first-of-type p{font-size:inherit}
 202 .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
 203 .admonitionblock>table td.icon{text-align:center;width:80px}
 204 .admonitionblock>table td.icon img{max-width:none}
 205 .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
 206 .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6)}
 207 .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
 208 .exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
 209 .exampleblock>.content>:first-child{margin-top:0}
 210 .exampleblock>.content>:last-child{margin-bottom:0}
 211 .sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
 212 .sidebarblock>:first-child{margin-top:0}
 213 .sidebarblock>:last-child{margin-bottom:0}
 214 .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
 215 .exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
 216 .literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
 217 .sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
 218 .literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;overflow-x:auto;padding:1em;font-size:.8125em}
 219 @media screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}
 220 @media screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}
 221 .literalblock pre.nowrap,.literalblock pre.nowrap pre,.listingblock pre.nowrap,.listingblock pre.nowrap pre{white-space:pre;word-wrap:normal}
 222 .literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
 223 .listingblock pre.highlightjs{padding:0}
 224 .listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
 225 .listingblock pre.prettyprint{border-width:0}
 226 .listingblock>.content{position:relative}
 227 .listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
 228 .listingblock:hover code[data-lang]::before{display:block}
 229 .listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:#999}
 230 .listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
 231 table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
 232 table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}
 233 table.pyhltable td.code{padding-left:.75em;padding-right:0}
 234 pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #dddddf}
 235 pre.pygments .lineno{display:inline-block;margin-right:.25em}
 236 table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
 237 .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
 238 .quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
 239 .quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
 240 .quoteblock blockquote{margin:0;padding:0;border:0}
 241 .quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
 242 .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
 243 .quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
 244 .verseblock{margin:0 1em 1.25em}
 245 .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
 246 .verseblock pre strong{font-weight:400}
 247 .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
 248 .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
 249 .quoteblock .attribution br,.verseblock .attribution br{display:none}
 250 .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
 251 .quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
 252 .quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
 253 .quoteblock.abstract{margin:0 1em 1.25em;display:block}
 254 .quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
 255 .quoteblock.excerpt,.quoteblock .quoteblock{margin:0 0 1.25em;padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
 256 .quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
 257 .quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;text-align:left;margin-right:0}
 258 table.tableblock{max-width:100%;border-collapse:separate}
 259 p.tableblock:last-child{margin-bottom:0}
 260 td.tableblock>.content{margin-bottom:-1.25em}
 261 table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
 262 table.grid-all>thead>tr>.tableblock,table.grid-all>tbody>tr>.tableblock{border-width:0 1px 1px 0}
 263 table.grid-all>tfoot>tr>.tableblock{border-width:1px 1px 0 0}
 264 table.grid-cols>*>tr>.tableblock{border-width:0 1px 0 0}
 265 table.grid-rows>thead>tr>.tableblock,table.grid-rows>tbody>tr>.tableblock{border-width:0 0 1px}
 266 table.grid-rows>tfoot>tr>.tableblock{border-width:1px 0 0}
 267 table.grid-all>*>tr>.tableblock:last-child,table.grid-cols>*>tr>.tableblock:last-child{border-right-width:0}
 268 table.grid-all>tbody>tr:last-child>.tableblock,table.grid-all>thead:last-child>tr>.tableblock,table.grid-rows>tbody>tr:last-child>.tableblock,table.grid-rows>thead:last-child>tr>.tableblock{border-bottom-width:0}
 269 table.frame-all{border-width:1px}
 270 table.frame-sides{border-width:0 1px}
 271 table.frame-topbot,table.frame-ends{border-width:1px 0}
 272 table.stripes-all tr,table.stripes-odd tr:nth-of-type(odd){background:#f8f8f7}
 273 table.stripes-none tr,table.stripes-odd tr:nth-of-type(even){background:none}
 274 th.halign-left,td.halign-left{text-align:left}
 275 th.halign-right,td.halign-right{text-align:right}
 276 th.halign-center,td.halign-center{text-align:center}
 277 th.valign-top,td.valign-top{vertical-align:top}
 278 th.valign-bottom,td.valign-bottom{vertical-align:bottom}
 279 th.valign-middle,td.valign-middle{vertical-align:middle}
 280 table thead th,table tfoot th{font-weight:bold}
 281 tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
 282 tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
 283 p.tableblock>code:only-child{background:none;padding:0}
 284 p.tableblock{font-size:1em}
 285 td>div.verse{white-space:pre}
 286 ol{margin-left:1.75em}
 287 ul li ol{margin-left:1.5em}
 288 dl dd{margin-left:1.125em}
 289 dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
 290 ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
 291 ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
 292 ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
 293 ul.unstyled,ol.unstyled{margin-left:0}
 294 ul.checklist{margin-left:.625em}
 295 ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
 296 ul.checklist li>p:first-child>input[type="checkbox"]:first-child{margin-right:.25em}
 297 ul.inline{display:-ms-flexbox;display:-webkit-box;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
 298 ul.inline>li{margin-left:1.25em}
 299 .unstyled dl dt{font-weight:400;font-style:normal}
 300 ol.arabic{list-style-type:decimal}
 301 ol.decimal{list-style-type:decimal-leading-zero}
 302 ol.loweralpha{list-style-type:lower-alpha}
 303 ol.upperalpha{list-style-type:upper-alpha}
 304 ol.lowerroman{list-style-type:lower-roman}
 305 ol.upperroman{list-style-type:upper-roman}
 306 ol.lowergreek{list-style-type:lower-greek}
 307 .hdlist>table,.colist>table{border:0;background:none}
 308 .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
 309 td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
 310 td.hdlist1{font-weight:bold;padding-bottom:1.25em}
 311 .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
 312 .colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
 313 .colist td:not([class]):first-child img{max-width:none}
 314 .colist td:not([class]):last-child{padding:.25em 0}
 315 .thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
 316 .imageblock.left{margin:.25em .625em 1.25em 0}
 317 .imageblock.right{margin:.25em 0 1.25em .625em}
 318 .imageblock>.title{margin-bottom:0}
 319 .imageblock.thumb,.imageblock.th{border-width:6px}
 320 .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
 321 .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
 322 .image.left{margin-right:.625em}
 323 .image.right{margin-left:.625em}
 324 a.image{text-decoration:none;display:inline-block}
 325 a.image object{pointer-events:none}
 326 sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
 327 sup.footnote a,sup.footnoteref a{text-decoration:none}
 328 sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
 329 #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
 330 #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
 331 #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
 332 #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
 333 #footnotes .footnote:last-of-type{margin-bottom:0}
 334 #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
 335 .gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
 336 .gist .file-data>table td.line-data{width:99%}
 337 div.unbreakable{page-break-inside:avoid}
 338 .big{font-size:larger}
 339 .small{font-size:smaller}
 340 .underline{text-decoration:underline}
 341 .overline{text-decoration:overline}
 342 .line-through{text-decoration:line-through}
 343 .aqua{color:#00bfbf}
 344 .aqua-background{background-color:#00fafa}
 345 .black{color:#000}
 346 .black-background{background-color:#000}
 347 .blue{color:#0000bf}
 348 .blue-background{background-color:#0000fa}
 349 .fuchsia{color:#bf00bf}
 350 .fuchsia-background{background-color:#fa00fa}
 351 .gray{color:#606060}
 352 .gray-background{background-color:#7d7d7d}
 353 .green{color:#006000}
 354 .green-background{background-color:#007d00}
 355 .lime{color:#00bf00}
 356 .lime-background{background-color:#00fa00}
 357 .maroon{color:#600000}
 358 .maroon-background{background-color:#7d0000}
 359 .navy{color:#000060}
 360 .navy-background{background-color:#00007d}
 361 .olive{color:#606000}
 362 .olive-background{background-color:#7d7d00}
 363 .purple{color:#600060}
 364 .purple-background{background-color:#7d007d}
 365 .red{color:#bf0000}
 366 .red-background{background-color:#fa0000}
 367 .silver{color:#909090}
 368 .silver-background{background-color:#bcbcbc}
 369 .teal{color:#006060}
 370 .teal-background{background-color:#007d7d}
 371 .white{color:#bfbfbf}
 372 .white-background{background-color:#fafafa}
 373 .yellow{color:#bfbf00}
 374 .yellow-background{background-color:#fafa00}
 375 span.icon>.fa{cursor:default}
 376 a span.icon>.fa{cursor:inherit}
 377 .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
 378 .admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
 379 .admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
 380 .admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
 381 .admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
 382 .admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
 383 .conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
 384 .conum[data-value] *{color:#fff!important}
 385 .conum[data-value]+b{display:none}
 386 .conum[data-value]::after{content:attr(data-value)}
 387 pre .conum[data-value]{position:relative;top:-.125em}
 388 b.conum *{color:inherit!important}
 389 .conum:not([data-value]):empty{display:none}
 390 dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
 391 h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
 392 p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
 393 p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
 394 p{margin-bottom:1.25rem}
 395 .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
 396 .exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
 397 .print-only{display:none!important}
 398 @page{margin:1.25cm .75cm}
 399 @media print{*{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
 400 html{font-size:80%}
 401 a{color:inherit!important;text-decoration:underline!important}
 402 a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
 403 a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
 404 abbr[title]::after{content:" (" attr(title) ")"}
 405 pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
 406 thead{display:table-header-group}
 407 svg{max-width:100%}
 408 p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
 409 h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
 410 #toc,.sidebarblock,.exampleblock>.content{background:none!important}
 411 #toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
 412 body.book #header{text-align:center}
 413 body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
 414 body.book #header .details{border:0!important;display:block;padding:0!important}
 415 body.book #header .details span:first-child{margin-left:0!important}
 416 body.book #header .details br{display:block}
 417 body.book #header .details br+span::before{content:none!important}
 418 body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
 419 body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
 420 .listingblock code[data-lang]::before{display:block}
 421 #footer{padding:0 .9375em}
 422 .hide-on-print{display:none!important}
 423 .print-only{display:block!important}
 424 .hide-for-print{display:none!important}
 425 .show-for-print{display:inherit!important}}
 426 @media print,amzn-kf8{#header>h1:first-child{margin-top:1.25rem}
 427 .sect1{padding:0!important}
 428 .sect1+.sect1{border:0}
 429 #footer{background:none}
 430 #footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
 431 @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
 432 </style>
 433 </head>
 434 <body class="article toc2 toc-left">
 435 <div id="header">
 436 <h1>Boost.Mp11: A C++11 metaprogramming library</h1>
 437 <div class="details">
 438 <span id="author" class="author">Peter Dimov</span><br>
 439 </div>
 440 <div id="toc" class="toc2">
 441 <div id="toctitle">Table of Contents</div>
 442 <ul class="sectlevel1">
 443 <li><a href="#overview">Overview</a></li>
 444 <li><a href="#definitions">Definitions</a></li>
 445 <li><a href="#examples">Examples</a>
 446 <ul class="sectlevel2">
 447 <li><a href="#generating_test_cases">Generating Test Cases</a></li>
 448 <li><a href="#writing_common_type_specializations">Writing common_type Specializations</a></li>
 449 <li><a href="#fixing_tuple_cat">Fixing tuple_cat</a></li>
 450 <li><a href="#computing_return_types">Computing Return Types</a></li>
 451 </ul>
 452 </li>
 453 <li><a href="#changelog">Revision History</a>
 454 <ul class="sectlevel2">
 455 <li><a href="#changes_in_1_70_0">Changes in 1.70.0</a></li>
 456 <li><a href="#changes_in_1_69_0">Changes in 1.69.0</a></li>
 457 </ul>
 458 </li>
 459 <li><a href="#reference">Reference</a>
 460 <ul class="sectlevel2">
 461 <li><a href="#integral">Integral Constants, &lt;boost/mp11/integral.hpp&gt;</a>
 462 <ul class="sectlevel3">
 463 <li><a href="#mp_boolb">mp_bool&lt;B&gt;</a></li>
 464 <li><a href="#mp_true">mp_true</a></li>
 465 <li><a href="#mp_false">mp_false</a></li>
 466 <li><a href="#mp_to_boolt">mp_to_bool&lt;T&gt;</a></li>
 467 <li><a href="#mp_nott">mp_not&lt;T&gt;</a></li>
 468 <li><a href="#mp_inti">mp_int&lt;I&gt;</a></li>
 469 <li><a href="#mp_size_tn">mp_size_t&lt;N&gt;</a></li>
 470 </ul>
 471 </li>
 472 <li><a href="#list">List Operations, &lt;boost/mp11/list.hpp&gt;</a>
 473 <ul class="sectlevel3">
 474 <li><a href="#mp_listt">mp_list&lt;T&#8230;&#8203;&gt;</a></li>
 475 <li><a href="#mp_list_ct_i">mp_list_c&lt;T, I&#8230;&#8203;&gt;</a></li>
 476 <li><a href="#mp_is_listl">mp_is_list&lt;L&gt;</a></li>
 477 <li><a href="#mp_sizel">mp_size&lt;L&gt;</a></li>
 478 <li><a href="#mp_emptyl">mp_empty&lt;L&gt;</a></li>
 479 <li><a href="#mp_assignl1_l2">mp_assign&lt;L1, L2&gt;</a></li>
 480 <li><a href="#mp_clearl">mp_clear&lt;L&gt;</a></li>
 481 <li><a href="#mp_frontl">mp_front&lt;L&gt;</a></li>
 482 <li><a href="#mp_pop_frontl">mp_pop_front&lt;L&gt;</a></li>
 483 <li><a href="#mp_firstl">mp_first&lt;L&gt;</a></li>
 484 <li><a href="#mp_restl">mp_rest&lt;L&gt;</a></li>
 485 <li><a href="#mp_secondl">mp_second&lt;L&gt;</a></li>
 486 <li><a href="#mp_thirdl">mp_third&lt;L&gt;</a></li>
 487 <li><a href="#mp_push_frontl_t">mp_push_front&lt;L, T&#8230;&#8203;&gt;</a></li>
 488 <li><a href="#mp_push_backl_t">mp_push_back&lt;L, T&#8230;&#8203;&gt;</a></li>
 489 <li><a href="#mp_renamel_y">mp_rename&lt;L, Y&gt;</a></li>
 490 <li><a href="#mp_applyf_l">mp_apply&lt;F, L&gt;</a></li>
 491 <li><a href="#mp_apply_qq_l">mp_apply_q&lt;Q, L&gt;</a></li>
 492 <li><a href="#mp_appendl">mp_append&lt;L&#8230;&#8203;&gt;</a></li>
 493 <li><a href="#mp_replace_frontl_t">mp_replace_front&lt;L, T&gt;</a></li>
 494 <li><a href="#mp_replace_firstl_t">mp_replace_first&lt;L, T&gt;</a></li>
 495 <li><a href="#mp_replace_secondl_t">mp_replace_second&lt;L, T&gt;</a></li>
 496 <li><a href="#mp_replace_thirdl_t">mp_replace_third&lt;L, T&gt;</a></li>
 497 <li><a href="#mp_transform_frontl_f">mp_transform_front&lt;L, F&gt;</a></li>
 498 <li><a href="#mp_transform_front_ql_q">mp_transform_front_q&lt;L, Q&gt;</a></li>
 499 <li><a href="#mp_transform_firstl_f">mp_transform_first&lt;L, F&gt;</a></li>
 500 <li><a href="#mp_transform_first_ql_q">mp_transform_first_q&lt;L, Q&gt;</a></li>
 501 <li><a href="#mp_transform_secondl_f">mp_transform_second&lt;L, F&gt;</a></li>
 502 <li><a href="#mp_transform_second_ql_q">mp_transform_second_q&lt;L, Q&gt;</a></li>
 503 <li><a href="#mp_transform_thirdl_f">mp_transform_third&lt;L, F&gt;</a></li>
 504 <li><a href="#mp_transform_third_ql_q">mp_transform_third_q&lt;L, Q&gt;</a></li>
 505 </ul>
 506 </li>
 507 <li><a href="#utility">Utility Components, &lt;boost/mp11/utility.hpp&gt;</a>
 508 <ul class="sectlevel3">
 509 <li><a href="#mp_identityt">mp_identity&lt;T&gt;</a></li>
 510 <li><a href="#mp_identity_tt">mp_identity_t&lt;T&gt;</a></li>
 511 <li><a href="#mp_inheritt">mp_inherit&lt;T&#8230;&#8203;&gt;</a></li>
 512 <li><a href="#mp_if_cc_t_e">mp_if_c&lt;C, T, E&#8230;&#8203;&gt;</a></li>
 513 <li><a href="#mp_ifc_t_e">mp_if&lt;C, T, E&#8230;&#8203;&gt;</a></li>
 514 <li><a href="#mp_eval_if_cc_t_f_u">mp_eval_if_c&lt;C, T, F, U&#8230;&#8203;&gt;</a></li>
 515 <li><a href="#mp_eval_ifc_t_f_u">mp_eval_if&lt;C, T, F, U&#8230;&#8203;&gt;</a></li>
 516 <li><a href="#mp_eval_if_qc_t_q_u">mp_eval_if_q&lt;C, T, Q, U&#8230;&#8203;&gt;</a></li>
 517 <li><a href="#mp_eval_if_notc_t_f_u">mp_eval_if_not&lt;C, T, F, U&#8230;&#8203;&gt;</a></li>
 518 <li><a href="#mp_eval_if_not_qc_t_q_u">mp_eval_if_not_q&lt;C, T, Q, U&#8230;&#8203;&gt;</a></li>
 519 <li><a href="#mp_validf_t">mp_valid&lt;F, T&#8230;&#8203;&gt;</a></li>
 520 <li><a href="#mp_valid_qq_t">mp_valid_q&lt;Q, T&#8230;&#8203;&gt;</a></li>
 521 <li><a href="#mp_eval_ort_f_u">mp_eval_or&lt;T, F, U&#8230;&#8203;&gt;</a></li>
 522 <li><a href="#mp_eval_or_qt_q_u">mp_eval_or_q&lt;T, Q, U&#8230;&#8203;&gt;</a></li>
 523 <li><a href="#mp_condc_t_r">mp_cond&lt;C, T, R&#8230;&#8203;&gt;</a></li>
 524 <li><a href="#mp_deferf_t">mp_defer&lt;F, T&#8230;&#8203;&gt;</a></li>
 525 <li><a href="#mp_quotef">mp_quote&lt;F&gt;</a></li>
 526 <li><a href="#mp_quote_traitf">mp_quote_trait&lt;F&gt;</a></li>
 527 <li><a href="#mp_invoke_qq_t">mp_invoke_q&lt;Q, T&#8230;&#8203;&gt;</a></li>
 528 <li><a href="#mp_not_fnp">mp_not_fn&lt;P&gt;</a></li>
 529 <li><a href="#mp_not_fn_qq">mp_not_fn_q&lt;Q&gt;</a></li>
 530 </ul>
 531 </li>
 532 <li><a href="#algorithm">Algorithms, &lt;boost/mp11/algorithm.hpp&gt;</a>
 533 <ul class="sectlevel3">
 534 <li><a href="#mp_transformf_l">mp_transform&lt;F, L&#8230;&#8203;&gt;</a></li>
 535 <li><a href="#mp_transform_qq_l">mp_transform_q&lt;Q, L&#8230;&#8203;&gt;</a></li>
 536 <li><a href="#mp_transform_ifp_f_l">mp_transform_if&lt;P, F, L&#8230;&#8203;&gt;</a></li>
 537 <li><a href="#mp_transform_if_qqp_qf_l">mp_transform_if_q&lt;Qp, Qf, L&#8230;&#8203;&gt;</a></li>
 538 <li><a href="#mp_filterp_l">mp_filter&lt;P, L&#8230;&#8203;&gt;</a></li>
 539 <li><a href="#mp_filter_qqp_l">mp_filter_q&lt;Qp, L&#8230;&#8203;&gt;</a></li>
 540 <li><a href="#mp_filll_v">mp_fill&lt;L, V&gt;</a></li>
 541 <li><a href="#mp_countl_v">mp_count&lt;L, V&gt;</a></li>
 542 <li><a href="#mp_count_ifl_p">mp_count_if&lt;L, P&gt;</a></li>
 543 <li><a href="#mp_count_if_ql_q">mp_count_if_q&lt;L, Q&gt;</a></li>
 544 <li><a href="#mp_containsl_v">mp_contains&lt;L, V&gt;</a></li>
 545 <li><a href="#mp_starts_withl1_l2">mp_starts_with&lt;L1, L2&gt;</a></li>
 546 <li><a href="#mp_repeat_cl_n">mp_repeat_c&lt;L, N&gt;</a></li>
 547 <li><a href="#mp_repeatl_n">mp_repeat&lt;L, N&gt;</a></li>
 548 <li><a href="#mp_productf_l">mp_product&lt;F, L&#8230;&#8203;&gt;</a></li>
 549 <li><a href="#mp_product_qq_l">mp_product_q&lt;Q, L&#8230;&#8203;&gt;</a></li>
 550 <li><a href="#mp_drop_cl_n">mp_drop_c&lt;L, N&gt;</a></li>
 551 <li><a href="#mp_dropl_n">mp_drop&lt;L, N&gt;</a></li>
 552 <li><a href="#mp_from_sequences">mp_from_sequence&lt;S&gt;</a></li>
 553 <li><a href="#mp_iota_cn">mp_iota_c&lt;N&gt;</a></li>
 554 <li><a href="#mp_iotan">mp_iota&lt;N&gt;</a></li>
 555 <li><a href="#mp_at_cl_i">mp_at_c&lt;L, I&gt;</a></li>
 556 <li><a href="#mp_atl_i">mp_at&lt;L, I&gt;</a></li>
 557 <li><a href="#mp_take_cl_n">mp_take_c&lt;L, N&gt;</a></li>
 558 <li><a href="#mp_takel_n">mp_take&lt;L, N&gt;</a></li>
 559 <li><a href="#mp_backl">mp_back&lt;L&gt;</a></li>
 560 <li><a href="#mp_pop_backl">mp_pop_back&lt;L&gt;</a></li>
 561 <li><a href="#mp_insert_cl_i_t">mp_insert_c&lt;L, I, T&#8230;&#8203;&gt;</a></li>
 562 <li><a href="#mp_insertl_i_t">mp_insert&lt;L, I, T&#8230;&#8203;&gt;</a></li>
 563 <li><a href="#mp_erase_cl_i_j">mp_erase_c&lt;L, I, J&gt;</a></li>
 564 <li><a href="#mp_erasel_i_j">mp_erase&lt;L, I, J&gt;</a></li>
 565 <li><a href="#mp_replacel_v_w">mp_replace&lt;L, V, W&gt;</a></li>
 566 <li><a href="#mp_replace_ifl_p_w">mp_replace_if&lt;L, P, W&gt;</a></li>
 567 <li><a href="#mp_replace_if_ql_q_w">mp_replace_if_q&lt;L, Q, W&gt;</a></li>
 568 <li><a href="#mp_replace_at_cl_i_w">mp_replace_at_c&lt;L, I, W&gt;</a></li>
 569 <li><a href="#mp_replace_atl_i_w">mp_replace_at&lt;L, I, W&gt;</a></li>
 570 <li><a href="#mp_copy_ifl_p">mp_copy_if&lt;L, P&gt;</a></li>
 571 <li><a href="#mp_copy_if_ql_q">mp_copy_if_q&lt;L, Q&gt;</a></li>
 572 <li><a href="#mp_removel_v">mp_remove&lt;L, V&gt;</a></li>
 573 <li><a href="#mp_remove_ifl_p">mp_remove_if&lt;L, P&gt;</a></li>
 574 <li><a href="#mp_remove_if_ql_q">mp_remove_if_q&lt;L, Q&gt;</a></li>
 575 <li><a href="#mp_partitionl_p">mp_partition&lt;L, P&gt;</a></li>
 576 <li><a href="#mp_partition_ql_q">mp_partition_q&lt;L, Q&gt;</a></li>
 577 <li><a href="#mp_sortl_p">mp_sort&lt;L, P&gt;</a></li>
 578 <li><a href="#mp_sort_ql_q">mp_sort_q&lt;L, Q&gt;</a></li>
 579 <li><a href="#mp_nth_element_cl_i_p">mp_nth_element_c&lt;L, I, P&gt;</a></li>
 580 <li><a href="#mp_nth_elementl_i_p">mp_nth_element&lt;L, I, P&gt;</a></li>
 581 <li><a href="#mp_nth_element_ql_i_q">mp_nth_element_q&lt;L, I, Q&gt;</a></li>
 582 <li><a href="#mp_min_elementl_p">mp_min_element&lt;L, P&gt;</a></li>
 583 <li><a href="#mp_min_element_ql_q">mp_min_element_q&lt;L, Q&gt;</a></li>
 584 <li><a href="#mp_max_elementl_p">mp_max_element&lt;L, P&gt;</a></li>
 585 <li><a href="#mp_max_element_ql_q">mp_max_element_q&lt;L, Q&gt;</a></li>
 586 <li><a href="#mp_findl_v">mp_find&lt;L, V&gt;</a></li>
 587 <li><a href="#mp_find_ifl_p">mp_find_if&lt;L, P&gt;</a></li>
 588 <li><a href="#mp_find_if_ql_q">mp_find_if_q&lt;L, Q&gt;</a></li>
 589 <li><a href="#mp_reversel">mp_reverse&lt;L&gt;</a></li>
 590 <li><a href="#mp_foldl_v_f">mp_fold&lt;L, V, F&gt;</a></li>
 591 <li><a href="#mp_fold_ql_v_q">mp_fold_q&lt;L, V, Q&gt;</a></li>
 592 <li><a href="#mp_reverse_foldl_v_f">mp_reverse_fold&lt;L, V, F&gt;</a></li>
 593 <li><a href="#mp_reverse_fold_ql_v_q">mp_reverse_fold_q&lt;L, V, Q&gt;</a></li>
 594 <li><a href="#mp_uniquel">mp_unique&lt;L&gt;</a></li>
 595 <li><a href="#mp_all_ofl_p">mp_all_of&lt;L, P&gt;</a></li>
 596 <li><a href="#mp_all_of_ql_q">mp_all_of_q&lt;L, Q&gt;</a></li>
 597 <li><a href="#mp_none_ofl_p">mp_none_of&lt;L, P&gt;</a></li>
 598 <li><a href="#mp_none_of_ql_q">mp_none_of_q&lt;L, Q&gt;</a></li>
 599 <li><a href="#mp_any_ofl_p">mp_any_of&lt;L, P&gt;</a></li>
 600 <li><a href="#mp_any_of_ql_q">mp_any_of_q&lt;L, Q&gt;</a></li>
 601 <li><a href="#mp_for_eachlf">mp_for_each&lt;L&gt;(f)</a></li>
 602 <li><a href="#mp_with_indexni_f">mp_with_index&lt;N&gt;(i, f)</a></li>
 603 </ul>
 604 </li>
 605 <li><a href="#set">Set Operations, &lt;boost/mp11/set.hpp&gt;</a>
 606 <ul class="sectlevel3">
 607 <li><a href="#mp_is_sets">mp_is_set&lt;S&gt;</a></li>
 608 <li><a href="#mp_set_containss_v">mp_set_contains&lt;S, V&gt;</a></li>
 609 <li><a href="#mp_set_push_backs_t">mp_set_push_back&lt;S, T&#8230;&#8203;&gt;</a></li>
 610 <li><a href="#mp_set_push_fronts_t">mp_set_push_front&lt;S, T&#8230;&#8203;&gt;</a></li>
 611 <li><a href="#mp_set_unionl">mp_set_union&lt;L&#8230;&#8203;&gt;</a></li>
 612 <li><a href="#mp_set_intersections">mp_set_intersection&lt;S&#8230;&#8203;&gt;</a></li>
 613 <li><a href="#mp_set_differencel_s">mp_set_difference&lt;L, S&#8230;&#8203;&gt;</a></li>
 614 </ul>
 615 </li>
 616 <li><a href="#map">Map Operations, &lt;boost/mp11/map.hpp&gt;</a>
 617 <ul class="sectlevel3">
 618 <li><a href="#mp_is_mapm">mp_is_map&lt;M&gt;</a></li>
 619 <li><a href="#mp_map_findm_k">mp_map_find&lt;M, K&gt;</a></li>
 620 <li><a href="#mp_map_containsm_k">mp_map_contains&lt;M, K&gt;</a></li>
 621 <li><a href="#mp_map_insertm_t">mp_map_insert&lt;M, T&gt;</a></li>
 622 <li><a href="#mp_map_replacem_t">mp_map_replace&lt;M, T&gt;</a></li>
 623 <li><a href="#mp_map_updatem_t_f">mp_map_update&lt;M, T, F&gt;</a></li>
 624 <li><a href="#mp_map_update_qm_t_q">mp_map_update_q&lt;M, T, Q&gt;</a></li>
 625 <li><a href="#mp_map_erasem_k">mp_map_erase&lt;M, K&gt;</a></li>
 626 <li><a href="#mp_map_keysm">mp_map_keys&lt;M&gt;</a></li>
 627 </ul>
 628 </li>
 629 <li><a href="#function">Helper Metafunctions, &lt;boost/mp11/function.hpp&gt;</a>
 630 <ul class="sectlevel3">
 631 <li><a href="#mp_voidt">mp_void&lt;T&#8230;&#8203;&gt;</a></li>
 632 <li><a href="#mp_andt">mp_and&lt;T&#8230;&#8203;&gt;</a></li>
 633 <li><a href="#mp_allt">mp_all&lt;T&#8230;&#8203;&gt;</a></li>
 634 <li><a href="#mp_ort">mp_or&lt;T&#8230;&#8203;&gt;</a></li>
 635 <li><a href="#mp_anyt">mp_any&lt;T&#8230;&#8203;&gt;</a></li>
 636 <li><a href="#mp_samet">mp_same&lt;T&#8230;&#8203;&gt;</a></li>
 637 <li><a href="#mp_similart">mp_similar&lt;T&#8230;&#8203;&gt;</a></li>
 638 <li><a href="#mp_plust">mp_plus&lt;T&#8230;&#8203;&gt;</a></li>
 639 <li><a href="#mp_lesst1_t2">mp_less&lt;T1, T2&gt;</a></li>
 640 <li><a href="#mp_mint1_t">mp_min&lt;T1, T&#8230;&#8203;&gt;</a></li>
 641 <li><a href="#mp_maxt1_t">mp_max&lt;T1, T&#8230;&#8203;&gt;</a></li>
 642 </ul>
 643 </li>
 644 <li><a href="#bind">Bind, &lt;boost/mp11/bind.hpp&gt;</a>
 645 <ul class="sectlevel3">
 646 <li><a href="#mp_argi">mp_arg&lt;I&gt;</a></li>
 647 <li><a href="#1_9">_1, &#8230;&#8203;, _9</a></li>
 648 <li><a href="#mp_bindf_t">mp_bind&lt;F, T&#8230;&#8203;&gt;</a></li>
 649 <li><a href="#mp_bind_qq_t">mp_bind_q&lt;Q, T&#8230;&#8203;&gt;</a></li>
 650 <li><a href="#mp_bind_frontf_t">mp_bind_front&lt;F, T&#8230;&#8203;&gt;</a></li>
 651 <li><a href="#mp_bind_front_qq_t">mp_bind_front_q&lt;Q, T&#8230;&#8203;&gt;</a></li>
 652 <li><a href="#mp_bind_backf_t">mp_bind_back&lt;F, T&#8230;&#8203;&gt;</a></li>
 653 <li><a href="#mp_bind_back_qq_t">mp_bind_back_q&lt;Q, T&#8230;&#8203;&gt;</a></li>
 654 </ul>
 655 </li>
 656 <li><a href="#integer_sequence">Integer Sequences, &lt;boost/mp11/integer_sequence.hpp&gt;</a>
 657 <ul class="sectlevel3">
 658 <li><a href="#integer_sequencet_i">integer_sequence&lt;T, I&#8230;&#8203;&gt;</a></li>
 659 <li><a href="#make_integer_sequencet_n">make_integer_sequence&lt;T, N&gt;</a></li>
 660 <li><a href="#index_sequencei">index_sequence&lt;I&#8230;&#8203;&gt;</a></li>
 661 <li><a href="#make_index_sequencen">make_index_sequence&lt;N&gt;</a></li>
 662 <li><a href="#index_sequence_fort">index_sequence_for&lt;T&#8230;&#8203;&gt;</a></li>
 663 </ul>
 664 </li>
 665 <li><a href="#tuple">Tuple Operations, &lt;boost/mp11/tuple.hpp&gt;</a>
 666 <ul class="sectlevel3">
 667 <li><a href="#tuple_applyf_tp">tuple_apply(f, tp)</a></li>
 668 <li><a href="#construct_from_tuplettp">construct_from_tuple&lt;T&gt;(tp)</a></li>
 669 <li><a href="#tuple_for_eachtp_f">tuple_for_each(tp, f)</a></li>
 670 </ul>
 671 </li>
 672 <li><a href="#mp11">Convenience Header, &lt;boost/mp11.hpp&gt;</a></li>
 673 <li><a href="#mpl">MPL Support, &lt;boost/mp11/mpl.hpp&gt;</a></li>
 674 </ul>
 675 </li>
 676 <li><a href="#copyright_license_and_acknowledgments">Appendix A: Copyright, License, and Acknowledgments</a></li>
 677 </ul>
 678 </div>
 679 </div>
 680 <div id="content">
 681 <div class="sect1">
 682 <h2 id="overview">Overview</h2>
 683 <div class="sectionbody">
 684 <div class="paragraph">
 685 <p>Mp11 is a C++11 metaprogramming library for compile-time manipulation of data structures
 686 that contain types. It&#8217;s based on template aliases and variadic templates and implements the
 687 approach outlined in the article
 688 <a href="simple_cxx11_metaprogramming.html">"Simple C&#43;&#43; metaprogramming"</a>
 689 and <a href="simple_cxx11_metaprogramming_2.html">its sequel</a>. Reading these
 690 articles before proceeding with this documentation is <em>highly</em> recommended.</p>
 691 </div>
 692 <div class="paragraph">
 693 <p>The general principles upon which Mp11 is built are that algorithms and metafunctions are
 694 template aliases of the form <code>F&lt;T&#8230;&#8203;&gt;</code> and data structures are lists of the form <code>L&lt;T&#8230;&#8203;&gt;</code>,
 695 with the library placing no requirements on <code>L</code>. <code>mp_list&lt;T&#8230;&#8203;&gt;</code> is the built-in list type,
 696 but <code>std::tuple&lt;T&#8230;&#8203;&gt;</code>, <code>std::pair&lt;T1, T2&gt;</code> and <code>std::variant&lt;T&#8230;&#8203;&gt;</code> are also perfectly
 697 legitimate list types, although of course <code>std::pair&lt;T1, T2&gt;</code>, due to having exactly two elements,
 698 is not resizeable and will consequently not work with algorithms that need to add or remove
 699 elements.</p>
 700 </div>
 701 <div class="paragraph">
 702 <p>Another distinguishing feature of this approach is that lists (<code>L&lt;T&#8230;&#8203;&gt;</code>) have the same form as
 703 metafunctions (<code>F&lt;T&#8230;&#8203;&gt;</code>) and can therefore be used as such. For example, applying <code>std::add_pointer_t</code>
 704 to the list <code>std::tuple&lt;int, float&gt;</code> by way of <code>mp_transform&lt;std::add_pointer_t, std::tuple&lt;int, float&gt;&gt;</code>
 705 gives us <code>std::tuple&lt;int*, float*&gt;</code>, but we can also apply <code>mp_list</code> to the same tuple:</p>
 706 </div>
 707 <div class="literalblock">
 708 <div class="content">
 709 <pre>using R = mp_transform&lt;mp_list, std::tuple&lt;int, float&gt;&gt;;</pre>
 710 </div>
 711 </div>
 712 <div class="paragraph">
 713 <p>and get <code>std::tuple&lt;mp_list&lt;int&gt;, mp_list&lt;float&gt;&gt;</code>.</p>
 714 </div>
 715 </div>
 716 </div>
 717 <div class="sect1">
 718 <h2 id="definitions">Definitions</h2>
 719 <div class="sectionbody">
 720 <div class="paragraph">
 721 <p>A <em>list</em> is a&#8201;&#8212;&#8201;usually but not necessarily variadic&#8201;&#8212;&#8201;template class whose parameters are all types,
 722 for example <code>mp_list&lt;char[], void&gt;</code>, <code>mp_list&lt;&gt;</code>, <code>std::tuple&lt;int, float, char&gt;</code>, <code>std::pair&lt;int, float&gt;</code>, <code>std::shared_ptr&lt;X&gt;</code>.</p>
 723 </div>
 724 <div class="paragraph">
 725 <p>A <em>metafunction</em> is a class template or a template alias whose parameters are all types, for example <code>std::add_pointer_t</code>,
 726 <code>std::is_const</code>, <code>mp_second</code>, <code>mp_push_front</code>, <code>mp_list</code>, <code>std::tuple</code>, <code>std::pair</code>, <code>std::shared_ptr</code>, or</p>
 727 </div>
 728 <div class="listingblock">
 729 <div class="content">
 730 <pre class="highlight"><code>template&lt;class...&gt; using F1 = void;
 731
 732 template&lt;class T&gt; using F2 = T*;
 733
 734 template&lt;class... T&gt; using F3 = std::integral_constant&lt;std::size_t, sizeof...(T)&gt;;</code></pre>
 735 </div>
 736 </div>
 737 <div class="paragraph">
 738 <p>A <em>quoted metafunction</em> is a class with a public metafunction member called <code>fn</code>, for example</p>
 739 </div>
 740 <div class="listingblock">
 741 <div class="content">
 742 <pre class="highlight"><code>struct Q1 { template&lt;class...&gt; using fn = void; };
 743
 744 struct Q2 { template&lt;class T&gt; using fn = T*; };
 745
 746 struct Q3 { template&lt;class... T&gt; using fn =
 747   std::integral_constant&lt;std::size_t, sizeof...(T)&gt;; };</code></pre>
 748 </div>
 749 </div>
 750 <div class="paragraph">
 751 <p>An <em>integral constant type</em> is a class with a public member <code>value</code> that is an integral constant in the C++ sense. For example,
 752 <code>std::integral_constant&lt;int, 7&gt;</code>, or</p>
 753 </div>
 754 <div class="literalblock">
 755 <div class="content">
 756 <pre>struct N { static int constexpr value = 2; };</pre>
 757 </div>
 758 </div>
 759 <div class="paragraph">
 760 <p>A <em>set</em> is a list whose elements are unique.</p>
 761 </div>
 762 <div class="paragraph">
 763 <p>A <em>map</em> is a list of lists, the inner lists having at least one element (the key.) The keys of the map must be unique. For example,</p>
 764 </div>
 765 <div class="listingblock">
 766 <div class="content">
 767 <pre class="highlight"><code>using M1 = std::tuple&lt;std::pair&lt;int, int*&gt;, std::pair&lt;float, float*&gt;,
 768     std::pair&lt;void, void*&gt;&gt;;
 769
 770 using M2 = mp_list&lt;mp_list&lt;int, int*&gt;, mp_list&lt;float&gt;,
 771     mp_list&lt;char, char[1], char[2]&gt;&gt;;</code></pre>
 772 </div>
 773 </div>
 774 </div>
 775 </div>
 776 <div class="sect1">
 777 <h2 id="examples">Examples</h2>
 778 <div class="sectionbody">
 779 <div class="sect2">
 780 <h3 id="generating_test_cases">Generating Test Cases</h3>
 781 <div class="paragraph">
 782 <p>Let&#8217;s suppose that we have written a metafunction <code>result&lt;T, U&gt;</code>:</p>
 783 </div>
 784 <div class="listingblock">
 785 <div class="content">
 786 <pre class="highlight"><code>template&lt;class T&gt; using promote = typename std::common_type&lt;T, int&gt;::type;
 787
 788 template&lt;class T, class U&gt; using result =
 789     typename std::common_type&lt;promote&lt;T&gt;, promote&lt;U&gt;&gt;::type;</code></pre>
 790 </div>
 791 </div>
 792 <div class="paragraph">
 793 <p>that ought to represent the result of an arithmetic operation on the integer types <code>T</code> and <code>U</code>,
 794 for example <code>t + u</code>. We want to test whether <code>result&lt;T, U&gt;</code> gives correct results for various combinations
 795 of <code>T</code> and <code>U</code>, so we write the function</p>
 796 </div>
 797 <div class="listingblock">
 798 <div class="content">
 799 <pre class="highlight"><code>template&lt;class T1, class T2&gt; void test_result()
 800 {
 801     using T3 = decltype( T1() + T2() );
 802     using T4 = result&lt;T1, T2&gt;;
 803
 804     std::cout &lt;&lt; ( std::is_same&lt;T3, T4&gt;::value? "[PASS]": "[FAIL]" ) &lt;&lt; std::endl;
 805 }</code></pre>
 806 </div>
 807 </div>
 808 <div class="paragraph">
 809 <p>and then need to call it a substantial number of times:</p>
 810 </div>
 811 <div class="literalblock">
 812 <div class="content">
 813 <pre>int main()
 814 {
 815     test_result&lt;char, char&gt;();
 816     test_result&lt;char, short&gt;();
 817     test_result&lt;char, int&gt;();
 818     test_result&lt;char, unsigned&gt;();
 819     // ...
 820 }</pre>
 821 </div>
 822 </div>
 823 <div class="paragraph">
 824 <p>Writing all those type combinations by hand is unwieldy, error prone, and worst of all, boring. This is
 825 how we can leverage Mp11 to automate the task:</p>
 826 </div>
 827 <div class="listingblock">
 828 <div class="content">
 829 <pre class="highlight"><code>#include &lt;boost/mp11.hpp&gt;
 830 #include &lt;boost/core/demangle.hpp&gt;
 831 #include &lt;type_traits&gt;
 832 #include &lt;iostream&gt;
 833 #include &lt;typeinfo&gt;
 834
 835 using namespace boost::mp11;
 836
 837 template&lt;class T&gt; std::string name()
 838 {
 839     return boost::core::demangle( typeid(T).name() );
 840 }
 841
 842 template&lt;class T&gt; using promote = typename std::common_type&lt;T, int&gt;::type;
 843
 844 template&lt;class T, class U&gt; using result =
 845     typename std::common_type&lt;promote&lt;T&gt;, promote&lt;U&gt;&gt;::type;
 846
 847 template&lt;class T1, class T2&gt; void test_result( mp_list&lt;T1, T2&gt; const&amp; )
 848 {
 849     using T3 = decltype( T1() + T2() );
 850     using T4 = result&lt;T1, T2&gt;;
 851
 852     std::cout &lt;&lt; ( std::is_same&lt;T3, T4&gt;::value? "[PASS] ": "[FAIL] " )
 853         &lt;&lt; name&lt;T1&gt;() &lt;&lt; " + " &lt;&lt; name&lt;T2&gt;() &lt;&lt; " -&gt; " &lt;&lt; name&lt;T3&gt;()
 854         &lt;&lt; ", result: " &lt;&lt; name&lt;T4&gt;() &lt;&lt; std::endl;
 855 }
 856
 857 int main()
 858 {
 859     using L = std::tuple&lt;char, short, int, unsigned, long, unsigned long&gt;;
 860     tuple_for_each( mp_product&lt;mp_list, L, L&gt;(), [](auto&amp;&amp; x){ test_result(x); } );
 861 }</code></pre>
 862 </div>
 863 </div>
 864 <div class="paragraph">
 865 <p>How does it work?</p>
 866 </div>
 867 <div class="paragraph">
 868 <p><code>mp_product&lt;F, L1, L2&gt;</code> calls <code>F&lt;T1, T2&gt;</code> where <code>T1</code> varies over the elements of <code>L1</code> and <code>T2</code> varies over
 869 the elements of <code>L2</code>, as if by executing two nested loops. It then returns a list of these results, of the same
 870 type as <code>L1</code>.</p>
 871 </div>
 872 <div class="paragraph">
 873 <p>In our case, both lists are the same <code>std::tuple</code>, and <code>F</code> is <code>mp_list</code>, so <code>mp_product&lt;mp_list, L, L&gt;</code> will get us
 874 <code>std::tuple&lt;mp_list&lt;char, char&gt;, mp_list&lt;char, short&gt;, mp_list&lt;char, int&gt;, &#8230;&#8203;, mp_list&lt;unsigned long, long&gt;, mp_list&lt;unsigned long, unsigned long&gt;&gt;</code>.</p>
 875 </div>
 876 <div class="paragraph">
 877 <p>We then default-construct this tuple and pass it to <code>tuple_for_each</code>. <code>tuple_for_each(tp, f)</code> calls <code>f</code> for every
 878 tuple element; we use a (C++14) lambda that calls <code>test_result</code>.</p>
 879 </div>
 880 <div class="paragraph">
 881 <p>In pure C++11, we can&#8217;t use a lambda with an <code>auto&amp;&amp;</code> parameter, so we&#8217;ll have to make <code>test_result</code> a function object with
 882 a templated <code>operator()</code> and pass that to <code>tuple_for_each</code> directly:</p>
 883 </div>
 884 <div class="listingblock">
 885 <div class="content">
 886 <pre class="highlight"><code>struct test_result
 887 {
 888     template&lt;class T1, class T2&gt; void operator()( mp_list&lt;T1, T2&gt; const&amp; ) const
 889     {
 890         using T3 = decltype( T1() + T2() );
 891         using T4 = result&lt;T1, T2&gt;;
 892
 893         std::cout &lt;&lt; ( std::is_same&lt;T3, T4&gt;::value? "[PASS] ": "[FAIL] " )
 894             &lt;&lt; name&lt;T1&gt;() &lt;&lt; " + " &lt;&lt; name&lt;T2&gt;() &lt;&lt; " -&gt; " &lt;&lt; name&lt;T3&gt;()
 895             &lt;&lt; ", result: " &lt;&lt; name&lt;T4&gt;() &lt;&lt; std::endl;
 896     }
 897 };
 898
 899 int main()
 900 {
 901     using L = std::tuple&lt;char, short, int, unsigned, long, unsigned long&gt;;
 902     tuple_for_each( mp_product&lt;mp_list, L, L&gt;(), test_result() );
 903 }</code></pre>
 904 </div>
 905 </div>
 906 </div>
 907 <div class="sect2">
 908 <h3 id="writing_common_type_specializations">Writing common_type Specializations</h3>
 909 <div class="paragraph">
 910 <p>The standard trait <code>std::common_type</code>, used to obtain a type to which all of its arguments can convert without
 911 unnecessary loss of precision, can be user-specialized when its default implementation (based on the ternary <code>?:</code>
 912 operator) is unsuitable.</p>
 913 </div>
 914 <div class="paragraph">
 915 <p>Let&#8217;s write a <code>common_type</code> specialization for two <code>std::tuple</code> arguments. For that, we need a metafunction that
 916 applies <code>std::common_type</code> to each pair of elements and gathers the results into a tuple:</p>
 917 </div>
 918 <div class="listingblock">
 919 <div class="content">
 920 <pre class="highlight"><code>template&lt;class... T&gt; using common_type_t =
 921     typename std::common_type&lt;T...&gt;::type; // standard in C++14
 922
 923 template&lt;class Tp1, class Tp2&gt; using common_tuple =
 924     mp_transform&lt;common_type_t, Tp1, Tp2&gt;;</code></pre>
 925 </div>
 926 </div>
 927 <div class="paragraph">
 928 <p>then specialize <code>common_type</code> to use it:</p>
 929 </div>
 930 <div class="listingblock">
 931 <div class="content">
 932 <pre class="highlight"><code>namespace std
 933 {
 934
 935     template&lt;class... T1, class... T2&gt;
 936     struct common_type&lt;std::tuple&lt;T1...&gt;, std::tuple&lt;T2...&gt;&gt;:
 937         mp_defer&lt;common_tuple, std::tuple&lt;T1...&gt;, std::tuple&lt;T2...&gt;&gt;
 938     {
 939     };
 940
 941 } // std</code></pre>
 942 </div>
 943 </div>
 944 <div class="paragraph">
 945 <p>(There is no need to specialize <code>std::common_type</code> for more than two arguments - it takes care of synthesizing the appropriate semantics from
 946 the binary case.)</p>
 947 </div>
 948 <div class="paragraph">
 949 <p>The subtlety here is the use of <code>mp_defer</code>. We could have defined a nested <code>type</code> to <code>common_tuple&lt;std::tuple&lt;T1&#8230;&#8203;&gt;, std::tuple&lt;T2&#8230;&#8203;&gt;&gt;</code>,
 950 and it would still have worked in all valid cases. By letting <code>mp_defer</code> define <code>type</code>, though, we make our specialization <em>SFINAE-friendly</em>.</p>
 951 </div>
 952 <div class="paragraph">
 953 <p>That is, when our <code>common_tuple</code> causes a substitution failure instead of a hard error, <code>mp_defer</code> will not define a nested <code>type</code>,
 954 and <code>common_type_t</code>, which is defined as <code>typename common_type&lt;&#8230;&#8203;&gt;::type</code>, will also cause a substitution failure.</p>
 955 </div>
 956 <div class="paragraph">
 957 <p>As another example, consider the hypothetical type <code>expected&lt;T, E&#8230;&#8203;&gt;</code> that represents either a successful return with a value of <code>T</code>,
 958 or an unsuccessful return with an error code of some type in the list <code>E&#8230;&#8203;</code>. The common type of <code>expected&lt;T1, E1, E2, E3&gt;</code> and
 959 <code>expected&lt;T2, E1, E4, E5&gt;</code> is <code>expected&lt;common_type_t&lt;T1, T2&gt;, E1, E2, E3, E4, E5&gt;</code>. That is, the possible return values are
 960 combined into their common type, and we take the union of the set of error types.</p>
 961 </div>
 962 <div class="paragraph">
 963 <p>Therefore,</p>
 964 </div>
 965 <div class="listingblock">
 966 <div class="content">
 967 <pre class="highlight"><code>template&lt;class T1, class E1, class T2, class E2&gt; using common_expected =
 968     mp_rename&lt;mp_push_front&lt;mp_unique&lt;mp_append&lt;E1, E2&gt;&gt;, common_type_t&lt;T1, T2&gt;&gt;,
 969         expected&gt;;
 970
 971 namespace std
 972 {
 973
 974     template&lt;class T1, class... E1, class T2, class... E2&gt;
 975     struct common_type&lt;expected&lt;T1, E1...&gt;, expected&lt;T2, E2...&gt;&gt;:
 976         mp_defer&lt;common_expected, T1, mp_list&lt;E1...&gt;, T2, mp_list&lt;E2...&gt;&gt;
 977     {
 978     };
 979
 980 } // std</code></pre>
 981 </div>
 982 </div>
 983 <div class="paragraph">
 984 <p>Here we&#8217;ve taken a different tack; instead of passing the <code>expected</code> types to <code>common_expected</code>, we&#8217;re passing the <code>T</code> types and lists of
 985 the <code>E</code> types. This makes our job easier. <code>mp_unique&lt;mp_append&lt;E1, E2&gt;&gt;</code> gives us the concatenation of <code>E1</code> and <code>E2</code> with the duplicates
 986 removed; we then add <code>common_type_t&lt;T1, T2&gt;</code> to the front via <code>mp_push_front</code>; and finally, we <code>mp_rename</code> the resultant <code>mp_list</code>
 987 to <code>expected</code>.</p>
 988 </div>
 989 </div>
 990 <div class="sect2">
 991 <h3 id="fixing_tuple_cat">Fixing tuple_cat</h3>
 992 <div class="paragraph">
 993 <p>The article <a href="http://pdimov.com/cpp2/simple_cxx11_metaprogramming.html#">Simple C++11 metaprogramming</a> builds an
 994 implementation of the standard function <code>tuple_cat</code>, with the end result given below:</p>
 995 </div>
 996 <div class="listingblock">
 997 <div class="content">
 998 <pre class="highlight"><code>template&lt;class L&gt; using F = mp_iota&lt;mp_size&lt;L&gt;&gt;;
 999
1000 template&lt;class R, class...Is, class... Ks, class Tp&gt;
1001 R tuple_cat_( mp_list&lt;Is...&gt;, mp_list&lt;Ks...&gt;, Tp tp )
1002 {
1003     return R{ std::get&lt;Ks::value&gt;(std::get&lt;Is::value&gt;(tp))... };
1004 }
1005
1006 template&lt;class... Tp,
1007     class R = mp_append&lt;std::tuple&lt;&gt;, typename std::remove_reference&lt;Tp&gt;::type...&gt;&gt;
1008     R tuple_cat( Tp &amp;&amp;... tp )
1009 {
1010     std::size_t const N = sizeof...(Tp);
1011
1012     // inner
1013
1014     using list1 = mp_list&lt;
1015         mp_rename&lt;typename std::remove_reference&lt;Tp&gt;::type, mp_list&gt;...&gt;;
1016
1017     using list2 = mp_iota_c&lt;N&gt;;
1018
1019     using list3 = mp_transform&lt;mp_fill, list1, list2&gt;;
1020
1021     using inner = mp_apply&lt;mp_append, list3&gt;;
1022
1023     // outer
1024
1025     using list4 = mp_transform&lt;F, list1&gt;;
1026
1027     using outer = mp_apply&lt;mp_append, list4&gt;;
1028
1029     //
1030
1031     return tuple_cat_&lt;R&gt;( inner(), outer(),
1032         std::forward_as_tuple( std::forward&lt;Tp&gt;(tp)... ) );
1033 }</code></pre>
1034 </div>
1035 </div>
1036 <div class="paragraph">
1037 <p>This function, however, is not entirely correct, in that it doesn&#8217;t handle some cases properly. For example,
1038 trying to concatenate tuples containing move-only elements such as <code>unique_ptr</code> fails:</p>
1039 </div>
1040 <div class="listingblock">
1041 <div class="content">
1042 <pre class="highlight"><code>std::tuple&lt;std::unique_ptr&lt;int&gt;&gt; t1;
1043 std::tuple&lt;std::unique_ptr&lt;float&gt;&gt; t2;
1044
1045 auto result = ::tuple_cat( std::move( t1 ), std::move( t2 ) );</code></pre>
1046 </div>
1047 </div>
1048 <div class="paragraph">
1049 <p>Trying to concatenate <code>const</code> tuples fails:</p>
1050 </div>
1051 <div class="listingblock">
1052 <div class="content">
1053 <pre class="highlight"><code>std::tuple&lt;int&gt; const t1;
1054 std::tuple&lt;float&gt; const t2;
1055
1056 auto result = ::tuple_cat( t1, t2 );</code></pre>
1057 </div>
1058 </div>
1059 <div class="paragraph">
1060 <p>And finally, the standard <code>tuple_cat</code> is specified to work on arbitrary tuple-like types (that is, all types
1061 that support <code>tuple_size</code>, <code>tuple_element</code>, and <code>get</code>), while our implementation only works with <code>tuple</code> and
1062 <code>pair</code>. <code>std::array</code>, for example, fails:</p>
1063 </div>
1064 <div class="listingblock">
1065 <div class="content">
1066 <pre class="highlight"><code>std::array&lt;int, 2&gt; t1{ 1, 2 };
1067 std::array&lt;float, 3&gt; t2{ 3.0f, 4.0f, 5.0f };
1068
1069 auto result = ::tuple_cat( t1, t2 );</code></pre>
1070 </div>
1071 </div>
1072 <div class="paragraph">
1073 <p>Let&#8217;s fix these one by one. Support for move-only types is easy, if one knows where to look. The problem is
1074 that <code>Tp</code> that we&#8217;re passing to the helper <code>tuple_cat_</code> is (correctly) <code>tuple&lt;unique_ptr&lt;int&gt;&amp;&amp;, unique_ptr&lt;float&gt;&amp;&amp;&gt;</code>,
1075 but <code>std::get&lt;0&gt;(tp)</code> still returns <code>unique_ptr&lt;int&gt;&amp;</code>, because <code>tp</code> is an lvalue. This behavior is a bit
1076 surprising, but is intended to prevent inadvertent double moves.</p>
1077 </div>
1078 <div class="paragraph">
1079 <p>Long story short, we need <code>std::move(tp)</code> in <code>tuple_cat_</code> to make <code>tp</code> an rvalue:</p>
1080 </div>
1081 <div class="literalblock">
1082 <div class="content">
1083 <pre>template&lt;class R, class...Is, class... Ks, class Tp&gt;
1084 R tuple_cat_( mp_list&lt;Is...&gt;, mp_list&lt;Ks...&gt;, Tp tp )
1085 {
1086     return R{ std::get&lt;Ks::value&gt;(std::get&lt;Is::value&gt;(std::move(tp)))... };
1087 }</pre>
1088 </div>
1089 </div>
1090 <div class="paragraph">
1091 <p>Next, <code>const</code>-qualified tuples. The issue here is that we&#8217;re stripping references from the input tuples, but not
1092 <code>const</code>. As a result, we&#8217;re trying to manipulate types such as <code>tuple&lt;int&gt; const</code> with Mp11 algorithms, and these
1093 types do not fit the list concept. We just need to strip qualifiers as well, by defining the useful <code>remove_cv_ref</code>
1094 primitive that is inexplicably missing from the standard library:</p>
1095 </div>
1096 <div class="literalblock">
1097 <div class="content">
1098 <pre>template&lt;class T&gt; using remove_cv_ref = typename std::remove_cv&lt;
1099     typename std::remove_reference&lt;T&gt;::type&gt;::type;</pre>
1100 </div>
1101 </div>
1102 <div class="paragraph">
1103 <p>and then by using <code>remove_cv_ref&lt;Tp&gt;</code> in place of <code>typename std::remove_reference&lt;Tp&gt;::type</code>:</p>
1104 </div>
1105 <div class="listingblock">
1106 <div class="content">
1107 <pre class="highlight"><code>template&lt;class... Tp,
1108     class R = mp_append&lt;std::tuple&lt;&gt;, remove_cv_ref&lt;Tp&gt;...&gt;&gt;
1109     R tuple_cat( Tp &amp;&amp;... tp )
1110 {
1111     std::size_t const N = sizeof...(Tp);
1112
1113     // inner
1114
1115     using list1 = mp_list&lt;mp_rename&lt;remove_cv_ref&lt;Tp&gt;, mp_list&gt;...&gt;;
1116
1117     // ...</code></pre>
1118 </div>
1119 </div>
1120 <div class="paragraph">
1121 <p>Finally, tuple-like types. We&#8217;ve so far exploited the fact that <code>std::pair</code> and <code>std::tuple</code> are valid Mp11 lists,
1122 but in general, arbitrary tuple-like types aren&#8217;t, so we need to convert them into such. For that, we&#8217;ll need to
1123 define a metafunction <code>from_tuple_like</code> that will take an arbitrary tuple-like type and will return, in our case,
1124 the corresponding <code>mp_list</code>.</p>
1125 </div>
1126 <div class="paragraph">
1127 <p>Technically, a more principled approach would&#8217;ve been to return <code>std::tuple</code>, but here <code>mp_list</code> will prove more
1128 convenient.</p>
1129 </div>
1130 <div class="paragraph">
1131 <p>What we need is, given a tuple-like type <code>Tp</code>, to obtain <code>mp_list&lt;std::tuple_element&lt;0, Tp&gt;::type, std::tuple_element&lt;1, Tp&gt;::type,
1132 &#8230;&#8203;, std::tuple_element&lt;N-1, Tp&gt;::type&gt;</code>, where <code>N</code> is <code>tuple_size&lt;Tp&gt;::value</code>. Here&#8217;s one way to do it:</p>
1133 </div>
1134 <div class="listingblock">
1135 <div class="content">
1136 <pre class="highlight"><code>template&lt;class T, class I&gt; using tuple_element =
1137     typename std::tuple_element&lt;I::value, T&gt;::type;
1138
1139 template&lt;class T&gt; using from_tuple_like =
1140     mp_product&lt;tuple_element, mp_list&lt;T&gt;, mp_iota&lt;std::tuple_size&lt;T&gt;&gt;&gt;;</code></pre>
1141 </div>
1142 </div>
1143 <div class="paragraph">
1144 <p>(<code>mp_iota&lt;N&gt;</code> is an algorithm that returns an <code>mp_list</code> with elements <code>mp_size_t&lt;0&gt;</code>, <code>mp_size_t&lt;1&gt;</code>, &#8230;&#8203;, <code>mp_size_t&lt;N-1&gt;</code>.)</p>
1145 </div>
1146 <div class="paragraph">
1147 <p>Remember that <code>mp_product&lt;F, L1, L2&gt;</code> performs the equivalent of two nested loops over the elements of <code>L1</code> and <code>L2</code>,
1148 applying <code>F</code> to the two variables and gathering the result. In our case <code>L1</code> consists of the single element <code>T</code>, so
1149 only the second loop (over <code>mp_iota&lt;N&gt;</code>, where <code>N</code> is <code>tuple_size&lt;T&gt;</code>), remains, and we get a list of the same type
1150 as <code>L1</code> (an <code>mp_list</code>) with contents <code>tuple_element&lt;T, mp_size_t&lt;0&gt;&gt;</code>, <code>tuple_element&lt;T, mp_size_t&lt;1&gt;&gt;</code>, &#8230;&#8203;,
1151 <code>tuple_element&lt;T, mp_size_t&lt;N-1&gt;&gt;</code>.</p>
1152 </div>
1153 <div class="paragraph">
1154 <p>For completeness&#8217;s sake, here&#8217;s another, more traditional way to achieve the same result:</p>
1155 </div>
1156 <div class="literalblock">
1157 <div class="content">
1158 <pre>template&lt;class T&gt; using from_tuple_like =
1159     mp_transform_q&lt;mp_bind_front&lt;tuple_element, T&gt;, mp_iota&lt;std::tuple_size&lt;T&gt;&gt;&gt;;</pre>
1160 </div>
1161 </div>
1162 <div class="paragraph">
1163 <p>With all these fixes applied, our fully operational <code>tuple_cat</code> now looks like this:</p>
1164 </div>
1165 <div class="listingblock">
1166 <div class="content">
1167 <pre class="highlight"><code>template&lt;class L&gt; using F = mp_iota&lt;mp_size&lt;L&gt;&gt;;
1168
1169 template&lt;class R, class...Is, class... Ks, class Tp&gt;
1170 R tuple_cat_( mp_list&lt;Is...&gt;, mp_list&lt;Ks...&gt;, Tp tp )
1171 {
1172     return R{ std::get&lt;Ks::value&gt;(std::get&lt;Is::value&gt;(std::move(tp)))... };
1173 }
1174
1175 template&lt;class T&gt; using remove_cv_ref = typename std::remove_cv&lt;
1176     typename std::remove_reference&lt;T&gt;::type&gt;::type;
1177
1178 template&lt;class T, class I&gt; using tuple_element =
1179     typename std::tuple_element&lt;I::value, T&gt;::type;
1180
1181 template&lt;class T&gt; using from_tuple_like =
1182     mp_product&lt;tuple_element, mp_list&lt;T&gt;, mp_iota&lt;std::tuple_size&lt;T&gt;&gt;&gt;;
1183
1184 template&lt;class... Tp,
1185     class R = mp_append&lt;std::tuple&lt;&gt;, from_tuple_like&lt;remove_cv_ref&lt;Tp&gt;&gt;...&gt;&gt;
1186     R tuple_cat( Tp &amp;&amp;... tp )
1187 {
1188     std::size_t const N = sizeof...(Tp);
1189
1190     // inner
1191
1192     using list1 = mp_list&lt;from_tuple_like&lt;remove_cv_ref&lt;Tp&gt;&gt;...&gt;;
1193     using list2 = mp_iota_c&lt;N&gt;;
1194
1195     using list3 = mp_transform&lt;mp_fill, list1, list2&gt;;
1196
1197     using inner = mp_apply&lt;mp_append, list3&gt;;
1198
1199     // outer
1200
1201     using list4 = mp_transform&lt;F, list1&gt;;
1202
1203     using outer = mp_apply&lt;mp_append, list4&gt;;
1204
1205     //
1206
1207     return tuple_cat_&lt;R&gt;( inner(), outer(),
1208         std::forward_as_tuple( std::forward&lt;Tp&gt;(tp)... ) );
1209 }</code></pre>
1210 </div>
1211 </div>
1212 </div>
1213 <div class="sect2">
1214 <h3 id="computing_return_types">Computing Return Types</h3>
1215 <div class="paragraph">
1216 <p>C++17 has a standard variant type, called <code>std::variant</code>. It also defines a function template
1217 <code>std::visit</code> that can be used to apply a function to the contained value of one or more variants.
1218 So for instance, if the variant <code>v1</code> contains <code>1</code>, and the variant <code>v2</code> contains <code>2.0f</code>,
1219 <code>std::visit(f, v1, v2)</code> will call <code>f(1, 2.0f)</code>.</p>
1220 </div>
1221 <div class="paragraph">
1222 <p>However, <code>std::visit</code> has one limitation: it cannot return a result unless all
1223 possible applications of the function have the same return type. If, for instance, <code>v1</code> and <code>v2</code>
1224 are both of type <code>std::variant&lt;short, int, float&gt;</code>,</p>
1225 </div>
1226 <div class="literalblock">
1227 <div class="content">
1228 <pre>std::visit( []( auto const&amp; x, auto const&amp; y ){ return x + y; }, v1, v2 );</pre>
1229 </div>
1230 </div>
1231 <div class="paragraph">
1232 <p>will fail to compile because the result of <code>x + y</code> can be either <code>int</code> or <code>float</code> depending on
1233 what <code>v1</code> and <code>v2</code> hold.</p>
1234 </div>
1235 <div class="paragraph">
1236 <p>A type that can hold either <code>int</code> or <code>float</code> already exists, called, surprisingly enough, <code>std::variant&lt;int, float&gt;</code>.
1237 Let&#8217;s write our own function template <code>rvisit</code> that is the same as <code>visit</code> but returns a <code>variant</code>:</p>
1238 </div>
1239 <div class="listingblock">
1240 <div class="content">
1241 <pre class="highlight"><code>template&lt;class F, class... V&gt; auto rvisit( F&amp;&amp; f, V&amp;&amp;... v )
1242 {
1243     using R = /*...*/;
1244
1245     return std::visit( [&amp;]( auto&amp;&amp;... x )
1246         { return R( std::forward&lt;F&gt;(f)( std::forward&lt;decltype(x)&gt;(x)... ) ); },
1247         std::forward&lt;V&gt;( v )... );
1248 }</code></pre>
1249 </div>
1250 </div>
1251 <div class="paragraph">
1252 <p>What this does is basically calls <code>std::visit</code> to do the work, but instead of passing it <code>f</code>, we pass a lambda that does the same as <code>f</code> except
1253 it converts the result to a common type <code>R</code>. <code>R</code> is supposed to be <code>std::variant&lt;&#8230;&#8203;&gt;</code> where the ellipsis denotes the return types of
1254 calling <code>f</code> with all possible combinations of variant values.</p>
1255 </div>
1256 <div class="paragraph">
1257 <p>We&#8217;ll first define a helper quoted metafunction <code>Qret&lt;F&gt;</code> that returns the result of the application of <code>F</code> to arguments of type <code>T&#8230;&#8203;</code>:</p>
1258 </div>
1259 <div class="literalblock">
1260 <div class="content">
1261 <pre>template&lt;class F&gt; struct Qret
1262 {
1263     template&lt;class... T&gt; using fn =
1264         decltype( std::declval&lt;F&gt;()( std::declval&lt;T&gt;()... ) );
1265 };</pre>
1266 </div>
1267 </div>
1268 <div class="paragraph">
1269 <p>(Unfortunately, we can&#8217;t just define this metafunction inside <code>rvisit</code>; the language prohibits defining template aliases inside functions.)</p>
1270 </div>
1271 <div class="paragraph">
1272 <p>With <code>Qret</code> in hand, a <code>variant</code> of the possible return types is just a matter of applying it over the possible combinations of the variant values:</p>
1273 </div>
1274 <div class="literalblock">
1275 <div class="content">
1276 <pre>using R = mp_product_q&lt;Qret&lt;F&gt;, std::remove_reference_t&lt;V&gt;...&gt;;</pre>
1277 </div>
1278 </div>
1279 <div class="paragraph">
1280 <p>Why does this work? <code>mp_product&lt;F, L1&lt;T1&#8230;&#8203;&gt;, L2&lt;T2&#8230;&#8203;&gt;, &#8230;&#8203;, Ln&lt;Tn&#8230;&#8203;&gt;&gt;</code> returns <code>L1&lt;F&lt;U1, U2, &#8230;&#8203;, Un&gt;, &#8230;&#8203;&gt;</code>, where <code>Ui</code> traverse all
1281 possible combinations of list values. Since in our case all <code>Li</code> are <code>std::variant</code>, the result will also be <code>std::variant</code>. (<code>mp_product_q</code> is
1282 the same as <code>mp_product</code>, but for quoted metafunctions such as our <code>Qret&lt;F&gt;</code>.)</p>
1283 </div>
1284 <div class="paragraph">
1285 <p>One more step remains. Suppose that, as above, we&#8217;re passing two variants of type <code>std::variant&lt;short, int, float&gt;</code> and <code>F</code> is
1286 <code>[]( auto const&amp; x, auto const&amp; y ){ return x + y; }</code>. This will generate <code>R</code> of length 9, one per each combination, but many of those
1287 elements will be the same, either <code>int</code> or <code>float</code>, and we need to filter out the duplicates. So, we pass the result to <code>mp_unique</code>:</p>
1288 </div>
1289 <div class="literalblock">
1290 <div class="content">
1291 <pre>using R = mp_unique&lt;mp_product_q&lt;Qret&lt;F&gt;, std::remove_reference_t&lt;V&gt;...&gt;&gt;;</pre>
1292 </div>
1293 </div>
1294 <div class="paragraph">
1295 <p>and we&#8217;re done:</p>
1296 </div>
1297 <div class="listingblock">
1298 <div class="content">
1299 <pre class="highlight"><code>#include &lt;boost/mp11.hpp&gt;
1300 #include &lt;boost/core/demangle.hpp&gt;
1301 #include &lt;variant&gt;
1302 #include &lt;type_traits&gt;
1303 #include &lt;typeinfo&gt;
1304 #include &lt;iostream&gt;
1305
1306 using namespace boost::mp11;
1307
1308 template&lt;class F&gt; struct Qret
1309 {
1310     template&lt;class... T&gt; using fn =
1311         decltype( std::declval&lt;F&gt;()( std::declval&lt;T&gt;()... ) );
1312 };
1313
1314 template&lt;class F, class... V&gt; auto rvisit( F&amp;&amp; f, V&amp;&amp;... v )
1315 {
1316     using R = mp_unique&lt;mp_product_q&lt;Qret&lt;F&gt;, std::remove_reference_t&lt;V&gt;...&gt;&gt;;
1317
1318     return std::visit( [&amp;]( auto&amp;&amp;... x )
1319         { return R( std::forward&lt;F&gt;(f)( std::forward&lt;decltype(x)&gt;(x)... ) ); },
1320         std::forward&lt;V&gt;( v )... );
1321 }
1322
1323 template&lt;class T&gt; std::string name()
1324 {
1325     return boost::core::demangle( typeid(T).name() );
1326 }
1327
1328 template&lt;class V&gt; void print_variant( char const * n, V const&amp; v )
1329 {
1330     std::cout &lt;&lt; "(" &lt;&lt; name&lt;decltype(v)&gt;() &lt;&lt; ")" &lt;&lt; n &lt;&lt; ": ";
1331
1332     std::visit( []( auto const&amp; x )
1333         { std::cout &lt;&lt; "(" &lt;&lt; name&lt;decltype(x)&gt;() &lt;&lt; ")" &lt;&lt; x &lt;&lt; std::endl; }, v );
1334 }
1335
1336 int main()
1337 {
1338     std::variant&lt;char, int, float&gt; v1( 1 );
1339
1340     print_variant( "v1", v1 );
1341
1342     std::variant&lt;short, int, double&gt; v2( 3.14 );
1343
1344     print_variant( "v2", v2 );
1345
1346     auto v3 = rvisit( []( auto const&amp; x, auto const&amp; y ){ return x + y; }, v1, v2 );
1347
1348     print_variant( "v3", v3 );
1349 }</code></pre>
1350 </div>
1351 </div>
1352 </div>
1353 </div>
1354 </div>
1355 <div class="sect1">
1356 <h2 id="changelog">Revision History</h2>
1357 <div class="sectionbody">
1358 <div class="sect2">
1359 <h3 id="changes_in_1_70_0">Changes in 1.70.0</h3>
1360 <div class="ulist">
1361 <ul>
1362 <li>
1363 <p>Renamed <code>mp_invoke</code> to <code>mp_invoke_q</code></p>
1364 </li>
1365 <li>
1366 <p>Added <code>mp_similar</code></p>
1367 </li>
1368 <li>
1369 <p>Added <code>mp_set_union</code>, <code>mp_set_intersection</code>, <code>mp_set_difference</code></p>
1370 </li>
1371 <li>
1372 <p>Added <code>mp_not_fn</code></p>
1373 </li>
1374 <li>
1375 <p>Added <code>mp_transform_first</code>, <code>mp_transform_second</code>, <code>mp_transform_third</code></p>
1376 </li>
1377 <li>
1378 <p>Added <code>mp_filter</code></p>
1379 </li>
1380 <li>
1381 <p>Added <code>mp_eval_if_not</code>, <code>mp_eval_or</code>, <code>mp_valid_q</code></p>
1382 </li>
1383 <li>
1384 <p>Added <code>mp_back</code>, <code>mp_pop_back</code></p>
1385 </li>
1386 <li>
1387 <p>Added <code>BOOST_MP11_VERSION</code></p>
1388 </li>
1389 </ul>
1390 </div>
1391 </div>
1392 <div class="sect2">
1393 <h3 id="changes_in_1_69_0">Changes in 1.69.0</h3>
1394 <div class="ulist">
1395 <ul>
1396 <li>
1397 <p>Removed dependency on Boost.Config; Mp11 is now standalone</p>
1398 </li>
1399 <li>
1400 <p>Improved code generation for <code>mp_with_index</code></p>
1401 </li>
1402 <li>
1403 <p>Added <code>mp_starts_with</code> (contributed by Glen Fernandes)</p>
1404 </li>
1405 <li>
1406 <p>Added CMake support</p>
1407 </li>
1408 </ul>
1409 </div>
1410 </div>
1411 </div>
1412 </div>
1413 <div class="sect1">
1414 <h2 id="reference">Reference</h2>
1415 <div class="sectionbody">
1416 <div class="paragraph">
1417 <p>The contents of the library are in namespace <code>boost::mp11</code>.</p>
1418 </div>
1419 <div class="sect2">
1420 <h3 id="integral">Integral Constants, &lt;boost/mp11/integral.hpp&gt;</h3>
1421 <div class="paragraph">
1422 <p>For an Mp11 integral constant type <code>T</code>, <code>T::value</code> is an integral constant in the C++ sense.</p>
1423 </div>
1424 <div class="sect3">
1425 <h4 id="mp_boolb">mp_bool&lt;B&gt;</h4>
1426 <div class="literalblock">
1427 <div class="content">
1428 <pre>template&lt;bool B&gt; using mp_bool = std::integral_constant&lt;bool, B&gt;;</pre>
1429 </div>
1430 </div>
1431 <div class="paragraph">
1432 <p>Same as <code>std::bool_constant</code> in C++17.</p>
1433 </div>
1434 </div>
1435 <div class="sect3">
1436 <h4 id="mp_true">mp_true</h4>
1437 <div class="literalblock">
1438 <div class="content">
1439 <pre>using mp_true = mp_bool&lt;true&gt;;</pre>
1440 </div>
1441 </div>
1442 <div class="paragraph">
1443 <p>Same as <code>std::true_type</code>.</p>
1444 </div>
1445 </div>
1446 <div class="sect3">
1447 <h4 id="mp_false">mp_false</h4>
1448 <div class="literalblock">
1449 <div class="content">
1450 <pre>using mp_false = mp_bool&lt;false&gt;;</pre>
1451 </div>
1452 </div>
1453 <div class="paragraph">
1454 <p>Same as <code>std::false_type</code>.</p>
1455 </div>
1456 </div>
1457 <div class="sect3">
1458 <h4 id="mp_to_boolt">mp_to_bool&lt;T&gt;</h4>
1459 <div class="literalblock">
1460 <div class="content">
1461 <pre>template&lt;class T&gt; using mp_to_bool = mp_bool&lt;static_cast&lt;bool&gt;(T::value)&gt;;</pre>
1462 </div>
1463 </div>
1464 </div>
1465 <div class="sect3">
1466 <h4 id="mp_nott">mp_not&lt;T&gt;</h4>
1467 <div class="literalblock">
1468 <div class="content">
1469 <pre>template&lt;class T&gt; using mp_not = mp_bool&lt; !T::value &gt;;</pre>
1470 </div>
1471 </div>
1472 </div>
1473 <div class="sect3">
1474 <h4 id="mp_inti">mp_int&lt;I&gt;</h4>
1475 <div class="literalblock">
1476 <div class="content">
1477 <pre>template&lt;int I&gt; using mp_int = std::integral_constant&lt;int, I&gt;;</pre>
1478 </div>
1479 </div>
1480 </div>
1481 <div class="sect3">
1482 <h4 id="mp_size_tn">mp_size_t&lt;N&gt;</h4>
1483 <div class="literalblock">
1484 <div class="content">
1485 <pre>template&lt;std::size_t N&gt; using mp_size_t = std::integral_constant&lt;std::size_t, N&gt;;</pre>
1486 </div>
1487 </div>
1488 </div>
1489 </div>
1490 <div class="sect2">
1491 <h3 id="list">List Operations, &lt;boost/mp11/list.hpp&gt;</h3>
1492 <div class="sect3">
1493 <h4 id="mp_listt">mp_list&lt;T&#8230;&#8203;&gt;</h4>
1494 <div class="literalblock">
1495 <div class="content">
1496 <pre>template&lt;class... T&gt; struct mp_list {};</pre>
1497 </div>
1498 </div>
1499 <div class="paragraph">
1500 <p><code>mp_list</code> is the standard list type of Mp11, although the library is not restricted to it and can operate on arbitrary class templates
1501 such as <code>std::tuple</code> or <code>std::variant</code>. Even <code>std::pair</code> can be used if the transformation does not alter the number of the elements in
1502 the list.</p>
1503 </div>
1504 </div>
1505 <div class="sect3">
1506 <h4 id="mp_list_ct_i">mp_list_c&lt;T, I&#8230;&#8203;&gt;</h4>
1507 <div class="literalblock">
1508 <div class="content">
1509 <pre>template&lt;class T, T... I&gt; using mp_list_c =
1510     mp_list&lt;std::integral_constant&lt;T, I&gt;...&gt;;</pre>
1511 </div>
1512 </div>
1513 <div class="paragraph">
1514 <p><code>mp_list_c</code> produces an <code>mp_list</code> of the <code>std::integral_constant</code> types corresponding to its integer template arguments.</p>
1515 </div>
1516 <div class="listingblock">
1517 <div class="title">Code Example 1. Using mp_list_c</div>
1518 <div class="content">
1519 <pre class="highlight"><code>using L1 = mp_list_c&lt;int, 2, 3&gt;; // mp_list&lt;mp_int&lt;2&gt;, mp_int&lt;3&gt;&gt;</code></pre>
1520 </div>
1521 </div>
1522 </div>
1523 <div class="sect3">
1524 <h4 id="mp_is_listl">mp_is_list&lt;L&gt;</h4>
1525 <div class="literalblock">
1526 <div class="content">
1527 <pre>template&lt;class L&gt; using mp_is_list = /*...*/;</pre>
1528 </div>
1529 </div>
1530 <div class="paragraph">
1531 <p><code>mp_is_list&lt;L&gt;</code> is <code>mp_true</code> if <code>L</code> is a list (an instantiation of a class template whose template parameters are types), <code>mp_false</code> otherwise.</p>
1532 </div>
1533 </div>
1534 <div class="sect3">
1535 <h4 id="mp_sizel">mp_size&lt;L&gt;</h4>
1536 <div class="literalblock">
1537 <div class="content">
1538 <pre>template&lt;class L&gt; using mp_size = /*...*/;</pre>
1539 </div>
1540 </div>
1541 <div class="paragraph">
1542 <p><code>mp_size&lt;L&gt;</code> returns the number of elements in the list <code>L</code>, as a <code>mp_size_t</code>. In other words, <code>mp_size&lt;L&lt;T&#8230;&#8203;&gt;&gt;</code> is an alias for
1543 <code>mp_size_t&lt;sizeof&#8230;&#8203;(T)&gt;</code>.</p>
1544 </div>
1545 <div class="listingblock">
1546 <div class="title">Code Example 2. Using mp_size with mp_list</div>
1547 <div class="content">
1548 <pre class="highlight"><code>using L1 = mp_list&lt;&gt;;
1549 using R1 = mp_size&lt;L1&gt;; // mp_size_t&lt;0&gt;</code></pre>
1550 </div>
1551 </div>
1552 <div class="listingblock">
1553 <div class="title">Code Example 3. Using mp_size with std::pair</div>
1554 <div class="content">
1555 <pre class="highlight"><code>using L2 = std::pair&lt;int, int&gt;;
1556 using R2 = mp_size&lt;L2&gt;; // mp_size_t&lt;2&gt;</code></pre>
1557 </div>
1558 </div>
1559 <div class="listingblock">
1560 <div class="title">Code Example 4. Using mp_size with std::tuple</div>
1561 <div class="content">
1562 <pre class="highlight"><code>using L3 = std::tuple&lt;float&gt;;
1563 using R3 = mp_size&lt;L3&gt;; // mp_size_t&lt;1&gt;</code></pre>
1564 </div>
1565 </div>
1566 </div>
1567 <div class="sect3">
1568 <h4 id="mp_emptyl">mp_empty&lt;L&gt;</h4>
1569 <div class="literalblock">
1570 <div class="content">
1571 <pre>template&lt;class L&gt; using mp_empty = mp_bool&lt;mp_size&lt;L&gt;::value == 0&gt;;</pre>
1572 </div>
1573 </div>
1574 <div class="paragraph">
1575 <p><code>mp_empty&lt;L&gt;</code> is an alias for <code>mp_true</code> if the list <code>L</code> is empty, for <code>mp_false</code> otherwise.</p>
1576 </div>
1577 <div class="listingblock">
1578 <div class="title">Code Example 5. Using mp_empty with std::tuple</div>
1579 <div class="content">
1580 <pre class="highlight"><code>using L1 = std::tuple&lt;float&gt;;
1581 using R1 = mp_empty&lt;L1&gt;; // mp_false
1582
1583 using L2 = std::tuple&lt;&gt;;
1584 using R2 = mp_empty&lt;L2&gt;; // mp_true</code></pre>
1585 </div>
1586 </div>
1587 </div>
1588 <div class="sect3">
1589 <h4 id="mp_assignl1_l2">mp_assign&lt;L1, L2&gt;</h4>
1590 <div class="literalblock">
1591 <div class="content">
1592 <pre>template&lt;class L1, class L2&gt; using mp_assign = /*...*/;</pre>
1593 </div>
1594 </div>
1595 <div class="paragraph">
1596 <p><code>mp_assign&lt;L1&lt;T1&#8230;&#8203;&gt;, L2&lt;T2&#8230;&#8203;&gt;&gt;</code> is an alias for <code>L1&lt;T2&#8230;&#8203;&gt;</code>. That is, it replaces the elements of <code>L1</code> with those of <code>L2</code>.</p>
1597 </div>
1598 <div class="listingblock">
1599 <div class="title">Code Example 6. Using mp_assign with mp_list and std::tuple</div>
1600 <div class="content">
1601 <pre class="highlight"><code>using L1 = std::tuple&lt;long&gt;;
1602 using L2 = mp_list&lt;int, float&gt;;
1603
1604 using R1 = mp_assign&lt;L1, L2&gt;; // std::tuple&lt;int, float&gt;</code></pre>
1605 </div>
1606 </div>
1607 <div class="listingblock">
1608 <div class="title">Code Example 7. Using mp_assign with mp_list and std::pair</div>
1609 <div class="content">
1610 <pre class="highlight"><code>using L1 = std::pair&lt;long, char&gt;;
1611 using L2 = mp_list&lt;int, float&gt;;
1612
1613 using R1 = mp_assign&lt;L1, L2&gt;; // std::pair&lt;int, float&gt;</code></pre>
1614 </div>
1615 </div>
1616 </div>
1617 <div class="sect3">
1618 <h4 id="mp_clearl">mp_clear&lt;L&gt;</h4>
1619 <div class="literalblock">
1620 <div class="content">
1621 <pre>template&lt;class L&gt; using mp_clear = mp_assign&lt;L, mp_list&lt;&gt;&gt;;</pre>
1622 </div>
1623 </div>
1624 <div class="paragraph">
1625 <p><code>mp_clear&lt;L&lt;T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>L&lt;&gt;</code>, that is, it removes the elements of <code>L</code>.</p>
1626 </div>
1627 <div class="listingblock">
1628 <div class="title">Code Example 8. Using mp_clear with std::tuple</div>
1629 <div class="content">
1630 <pre class="highlight"><code>using L1 = std::tuple&lt;int, float&gt;;
1631 using R1 = mp_clear&lt;L1&gt;; // std::tuple&lt;&gt;</code></pre>
1632 </div>
1633 </div>
1634 </div>
1635 <div class="sect3">
1636 <h4 id="mp_frontl">mp_front&lt;L&gt;</h4>
1637 <div class="literalblock">
1638 <div class="content">
1639 <pre>template&lt;class L&gt; using mp_front = /*...*/;</pre>
1640 </div>
1641 </div>
1642 <div class="paragraph">
1643 <p><code>mp_front&lt;L&gt;</code> is the first element of the list <code>L</code>. That is, <code>mp_front&lt;L&lt;T1, T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>T1</code>.</p>
1644 </div>
1645 <div class="listingblock">
1646 <div class="title">Code Example 9. Using mp_front with std::pair</div>
1647 <div class="content">
1648 <pre class="highlight"><code>using L1 = std::pair&lt;int, float&gt;;
1649 using R1 = mp_front&lt;L1&gt;; // int</code></pre>
1650 </div>
1651 </div>
1652 <div class="listingblock">
1653 <div class="title">Code Example 10. Using mp_front with std::tuple</div>
1654 <div class="content">
1655 <pre class="highlight"><code>using L2 = std::tuple&lt;float, double, long double&gt;;
1656 using R2 = mp_front&lt;L2&gt;; // float</code></pre>
1657 </div>
1658 </div>
1659 <div class="listingblock">
1660 <div class="title">Code Example 11. Using mp_front with mp_list</div>
1661 <div class="content">
1662 <pre class="highlight"><code>using L3 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
1663 using R3 = mp_front&lt;L3&gt;; // char[1]</code></pre>
1664 </div>
1665 </div>
1666 </div>
1667 <div class="sect3">
1668 <h4 id="mp_pop_frontl">mp_pop_front&lt;L&gt;</h4>
1669 <div class="literalblock">
1670 <div class="content">
1671 <pre>template&lt;class L&gt; using mp_pop_front = /*...*/;</pre>
1672 </div>
1673 </div>
1674 <div class="paragraph">
1675 <p><code>mp_pop_front&lt;L&gt;</code> removes the first element of the list <code>L</code>. That is, <code>mp_pop_front&lt;L&lt;T1, T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>L&lt;T&#8230;&#8203;&gt;</code>.</p>
1676 </div>
1677 <div class="listingblock">
1678 <div class="title">Code Example 12. Using mp_pop_front with std::tuple</div>
1679 <div class="content">
1680 <pre class="highlight"><code>using L1 = std::tuple&lt;float, double, long double&gt;;
1681 using R1 = mp_pop_front&lt;L1&gt;; // std::tuple&lt;double, long double&gt;</code></pre>
1682 </div>
1683 </div>
1684 <div class="listingblock">
1685 <div class="title">Code Example 13. Using mp_pop_front with mp_list</div>
1686 <div class="content">
1687 <pre class="highlight"><code>using L2 = mp_list&lt;void&gt;;
1688 using R2 = mp_pop_front&lt;L2&gt;; // mp_list&lt;&gt;</code></pre>
1689 </div>
1690 </div>
1691 </div>
1692 <div class="sect3">
1693 <h4 id="mp_firstl">mp_first&lt;L&gt;</h4>
1694 <div class="literalblock">
1695 <div class="content">
1696 <pre>template&lt;class L&gt; using mp_first = mp_front&lt;L&gt;;</pre>
1697 </div>
1698 </div>
1699 <div class="paragraph">
1700 <p><code>mp_first</code> is another name for <code>mp_front</code>.</p>
1701 </div>
1702 </div>
1703 <div class="sect3">
1704 <h4 id="mp_restl">mp_rest&lt;L&gt;</h4>
1705 <div class="literalblock">
1706 <div class="content">
1707 <pre>template&lt;class L&gt; using mp_rest = mp_pop_front&lt;L&gt;;</pre>
1708 </div>
1709 </div>
1710 <div class="paragraph">
1711 <p><code>mp_rest</code> is another name for <code>mp_pop_front</code>.</p>
1712 </div>
1713 </div>
1714 <div class="sect3">
1715 <h4 id="mp_secondl">mp_second&lt;L&gt;</h4>
1716 <div class="literalblock">
1717 <div class="content">
1718 <pre>template&lt;class L&gt; using mp_second = /*...*/;</pre>
1719 </div>
1720 </div>
1721 <div class="paragraph">
1722 <p><code>mp_second&lt;L&gt;</code> is the second element of the list <code>L</code>. That is, <code>mp_second&lt;L&lt;T1, T2, T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>T2</code>.</p>
1723 </div>
1724 <div class="listingblock">
1725 <div class="title">Code Example 14. Using mp_second with std::pair</div>
1726 <div class="content">
1727 <pre class="highlight"><code>using L1 = std::pair&lt;int, float&gt;;
1728 using R1 = mp_second&lt;L1&gt;; // float</code></pre>
1729 </div>
1730 </div>
1731 <div class="listingblock">
1732 <div class="title">Code Example 15. Using mp_second with std::tuple</div>
1733 <div class="content">
1734 <pre class="highlight"><code>using L2 = std::tuple&lt;float, double, long double&gt;;
1735 using R2 = mp_second&lt;L2&gt;; // double</code></pre>
1736 </div>
1737 </div>
1738 <div class="listingblock">
1739 <div class="title">Code Example 16. Using mp_second with mp_list</div>
1740 <div class="content">
1741 <pre class="highlight"><code>using L3 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
1742 using R3 = mp_second&lt;L3&gt;; // char[2]</code></pre>
1743 </div>
1744 </div>
1745 </div>
1746 <div class="sect3">
1747 <h4 id="mp_thirdl">mp_third&lt;L&gt;</h4>
1748 <div class="literalblock">
1749 <div class="content">
1750 <pre>template&lt;class L&gt; using mp_third = /*...*/;</pre>
1751 </div>
1752 </div>
1753 <div class="paragraph">
1754 <p><code>mp_third&lt;L&gt;</code> is the third element of the list <code>L</code>. That is, <code>mp_third&lt;L&lt;T1, T2, T3, T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>T3</code>.</p>
1755 </div>
1756 <div class="listingblock">
1757 <div class="title">Code Example 17. Using mp_third with std::tuple</div>
1758 <div class="content">
1759 <pre class="highlight"><code>using L1 = std::tuple&lt;float, double, long double&gt;;
1760 using R1 = mp_third&lt;L1&gt;; // long double</code></pre>
1761 </div>
1762 </div>
1763 <div class="listingblock">
1764 <div class="title">Code Example 18. Using mp_third with mp_list</div>
1765 <div class="content">
1766 <pre class="highlight"><code>using L2 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
1767 using R2 = mp_third&lt;L2&gt;; // char[3]</code></pre>
1768 </div>
1769 </div>
1770 </div>
1771 <div class="sect3">
1772 <h4 id="mp_push_frontl_t">mp_push_front&lt;L, T&#8230;&#8203;&gt;</h4>
1773 <div class="literalblock">
1774 <div class="content">
1775 <pre>template&lt;class L, class... T&gt; using mp_push_front = /*...*/;</pre>
1776 </div>
1777 </div>
1778 <div class="paragraph">
1779 <p><code>mp_push_front&lt;L, T&#8230;&#8203;&gt;</code> inserts the elements <code>T&#8230;&#8203;</code> at the front of the list <code>L</code>. That is, <code>mp_push_front&lt;L&lt;U&#8230;&#8203;&gt;, T&#8230;&#8203;&gt;</code>
1780 is an alias for <code>L&lt;T&#8230;&#8203;, U&#8230;&#8203;&gt;</code>.</p>
1781 </div>
1782 <div class="listingblock">
1783 <div class="title">Code Example 19. Using mp_push_front with std::tuple</div>
1784 <div class="content">
1785 <pre class="highlight"><code>using L1 = std::tuple&lt;double, long double&gt;;
1786 using R1 = mp_push_front&lt;L1, float&gt;; // std::tuple&lt;float, double, long double&gt;</code></pre>
1787 </div>
1788 </div>
1789 <div class="listingblock">
1790 <div class="title">Code Example 20. Using mp_push_front with mp_list</div>
1791 <div class="content">
1792 <pre class="highlight"><code>using L2 = mp_list&lt;void&gt;;
1793 using R2 = mp_push_front&lt;L2, char[1], char[2]&gt;; // mp_list&lt;char[1], char[2], void&gt;</code></pre>
1794 </div>
1795 </div>
1796 </div>
1797 <div class="sect3">
1798 <h4 id="mp_push_backl_t">mp_push_back&lt;L, T&#8230;&#8203;&gt;</h4>
1799 <div class="literalblock">
1800 <div class="content">
1801 <pre>template&lt;class L, class... T&gt; using mp_push_back = /*...*/;</pre>
1802 </div>
1803 </div>
1804 <div class="paragraph">
1805 <p><code>mp_push_back&lt;L, T&#8230;&#8203;&gt;</code> inserts the elements <code>T&#8230;&#8203;</code> at the back of the list <code>L</code>. That is, <code>mp_push_back&lt;L&lt;U&#8230;&#8203;&gt;, T&#8230;&#8203;&gt;</code>
1806 is an alias for <code>L&lt;U&#8230;&#8203;, T&#8230;&#8203;&gt;</code>.</p>
1807 </div>
1808 <div class="listingblock">
1809 <div class="title">Code Example 21. Using mp_push_back with std::tuple</div>
1810 <div class="content">
1811 <pre class="highlight"><code>using L1 = std::tuple&lt;double, long double&gt;;
1812 using R1 = mp_push_back&lt;L1, float&gt;; // std::tuple&lt;double, long double, float&gt;</code></pre>
1813 </div>
1814 </div>
1815 <div class="listingblock">
1816 <div class="title">Code Example 22. Using mp_push_back with mp_list</div>
1817 <div class="content">
1818 <pre class="highlight"><code>using L2 = mp_list&lt;void&gt;;
1819 using R2 = mp_push_back&lt;L2, char[1], char[2]&gt;; // mp_list&lt;void, char[1], char[2]&gt;</code></pre>
1820 </div>
1821 </div>
1822 </div>
1823 <div class="sect3">
1824 <h4 id="mp_renamel_y">mp_rename&lt;L, Y&gt;</h4>
1825 <div class="literalblock">
1826 <div class="content">
1827 <pre>template&lt;class L, template&lt;class...&gt; class Y&gt; using mp_rename = /*...*/;</pre>
1828 </div>
1829 </div>
1830 <div class="paragraph">
1831 <p><code>mp_rename&lt;L, Y&gt;</code> changes the type of the list <code>L</code> to <code>Y</code>. That is, <code>mp_rename&lt;L&lt;T&#8230;&#8203;&gt;, Y&gt;</code> is an alias for <code>Y&lt;T&#8230;&#8203;&gt;</code>.</p>
1832 </div>
1833 <div class="listingblock">
1834 <div class="title">Code Example 23. Using mp_rename to rename std::pair to std::tuple</div>
1835 <div class="content">
1836 <pre class="highlight"><code>using L1 = std::pair&lt;double, long double&gt;;
1837 using R1 = mp_rename&lt;L1, std::tuple&gt;; // std::tuple&lt;double, long double&gt;</code></pre>
1838 </div>
1839 </div>
1840 <div class="listingblock">
1841 <div class="title">Code Example 24. Using mp_rename to rename std::tuple to mp_list</div>
1842 <div class="content">
1843 <pre class="highlight"><code>using L2 = std::tuple&lt;void&gt;;
1844 using R2 = mp_rename&lt;L2, mp_list&gt;; // mp_list&lt;void&gt;</code></pre>
1845 </div>
1846 </div>
1847 </div>
1848 <div class="sect3">
1849 <h4 id="mp_applyf_l">mp_apply&lt;F, L&gt;</h4>
1850 <div class="literalblock">
1851 <div class="content">
1852 <pre>template&lt;template&lt;class...&gt; class F, class L&gt; using mp_apply = mp_rename&lt;L, F&gt;;</pre>
1853 </div>
1854 </div>
1855 <div class="paragraph">
1856 <p><code>mp_apply&lt;F, L&gt;</code> applies the metafunction <code>F</code> to the contents of the list <code>L</code>, that is, <code>mp_apply&lt;F, L&lt;T&#8230;&#8203;&gt;&gt;</code> is an alias for <code>F&lt;T&#8230;&#8203;&gt;</code>.
1857 (<code>mp_apply</code> is the same as <code>mp_rename</code> with the arguments reversed.)</p>
1858 </div>
1859 <div class="listingblock">
1860 <div class="title">Code Example 25. Using mp_apply with std::pair</div>
1861 <div class="content">
1862 <pre class="highlight"><code>using L1 = std::pair&lt;double, long double&gt;;
1863 using R1 = mp_apply&lt;std::is_same, L1&gt;; // std::is_same&lt;double, long double&gt;</code></pre>
1864 </div>
1865 </div>
1866 </div>
1867 <div class="sect3">
1868 <h4 id="mp_apply_qq_l">mp_apply_q&lt;Q, L&gt;</h4>
1869 <div class="literalblock">
1870 <div class="content">
1871 <pre>template&lt;class Q, class L&gt; using mp_apply_q = mp_apply&lt;Q::template fn, L&gt;;</pre>
1872 </div>
1873 </div>
1874 <div class="paragraph">
1875 <p>Same as <code>mp_apply</code>, but takes a quoted metafunction.</p>
1876 </div>
1877 <div class="listingblock">
1878 <div class="title">Code Example 26. Using mp_apply_q with mp_bind_front</div>
1879 <div class="content">
1880 <pre class="highlight"><code>using L1 = std::tuple&lt;double, long double&gt;;
1881 using L2 = mp_list&lt;int, long&gt;;
1882
1883 using R1 = mp_apply_q&lt;mp_bind_front&lt;mp_push_back, L1&gt;, L2&gt;;
1884   // R1 is std::tuple&lt;double, long double, int, long&gt;</code></pre>
1885 </div>
1886 </div>
1887 </div>
1888 <div class="sect3">
1889 <h4 id="mp_appendl">mp_append&lt;L&#8230;&#8203;&gt;</h4>
1890 <div class="literalblock">
1891 <div class="content">
1892 <pre>template&lt;class... L&gt; using mp_append = /*...*/;</pre>
1893 </div>
1894 </div>
1895 <div class="paragraph">
1896 <p><code>mp_append&lt;L&#8230;&#8203;&gt;</code> concatenates the lists in <code>L&#8230;&#8203;</code> into a single list that has the same type as the first list. <code>mp_append&lt;&gt;</code>
1897 is an alias for <code>mp_list&lt;&gt;</code>. <code>mp_append&lt;L1&lt;T1&#8230;&#8203;&gt;, L2&lt;T2&#8230;&#8203;&gt;, &#8230;&#8203;, Ln&lt;Tn&#8230;&#8203;&gt;&gt;</code> is an alias for <code>L1&lt;T1&#8230;&#8203;, T2&#8230;&#8203;, &#8230;&#8203;, Tn&#8230;&#8203;&gt;</code>.</p>
1898 </div>
1899 <div class="listingblock">
1900 <div class="title">Code Example 27. Using mp_append with lists of various types</div>
1901 <div class="content">
1902 <pre class="highlight"><code>using L1 = std::tuple&lt;double, long double&gt;;
1903 using L2 = mp_list&lt;int&gt;;
1904 using L3 = std::pair&lt;short, long&gt;;
1905 using L4 = mp_list&lt;&gt;;
1906
1907 using R1 = mp_append&lt;L1, L2, L3, L4&gt;;
1908   // std::tuple&lt;double, long double, int, short, long&gt;</code></pre>
1909 </div>
1910 </div>
1911 </div>
1912 <div class="sect3">
1913 <h4 id="mp_replace_frontl_t">mp_replace_front&lt;L, T&gt;</h4>
1914 <div class="literalblock">
1915 <div class="content">
1916 <pre>template&lt;class L, class T&gt; using mp_replace_front = /*...*/;</pre>
1917 </div>
1918 </div>
1919 <div class="paragraph">
1920 <p><code>mp_replace_front&lt;L, T&gt;</code> replaces the first element of the list <code>L</code> with <code>T</code>. That is, <code>mp_replace_front&lt;L&lt;U1, U&#8230;&#8203;&gt;, T&gt;</code> is
1921 an alias for <code>L&lt;T, U&#8230;&#8203;&gt;</code>.</p>
1922 </div>
1923 <div class="listingblock">
1924 <div class="title">Code Example 28. Using mp_replace_front with std::pair</div>
1925 <div class="content">
1926 <pre class="highlight"><code>using L1 = std::pair&lt;int, float&gt;;
1927 using R1 = mp_replace_front&lt;L1, void&gt;; // std::pair&lt;void, float&gt;</code></pre>
1928 </div>
1929 </div>
1930 <div class="listingblock">
1931 <div class="title">Code Example 29. Using mp_replace_front with std::tuple</div>
1932 <div class="content">
1933 <pre class="highlight"><code>using L2 = std::tuple&lt;float, double, long double&gt;;
1934 using R2 = mp_replace_front&lt;L2, void&gt;; // std::tuple&lt;void, double, long double&gt;</code></pre>
1935 </div>
1936 </div>
1937 <div class="listingblock">
1938 <div class="title">Code Example 30. Using mp_replace_front with mp_list</div>
1939 <div class="content">
1940 <pre class="highlight"><code>using L3 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
1941 using R3 = mp_replace_front&lt;L3, void&gt;; // mp_list&lt;void, char[2], char[3], char[4]&gt;;</code></pre>
1942 </div>
1943 </div>
1944 </div>
1945 <div class="sect3">
1946 <h4 id="mp_replace_firstl_t">mp_replace_first&lt;L, T&gt;</h4>
1947 <div class="literalblock">
1948 <div class="content">
1949 <pre>template&lt;class L, class T&gt; using mp_replace_first = mp_replace_front&lt;L, T&gt;;</pre>
1950 </div>
1951 </div>
1952 <div class="paragraph">
1953 <p><code>mp_replace_first</code> is another name for <code>mp_replace_front</code>.</p>
1954 </div>
1955 </div>
1956 <div class="sect3">
1957 <h4 id="mp_replace_secondl_t">mp_replace_second&lt;L, T&gt;</h4>
1958 <div class="literalblock">
1959 <div class="content">
1960 <pre>template&lt;class L, class T&gt; using mp_replace_second = /*...*/;</pre>
1961 </div>
1962 </div>
1963 <div class="paragraph">
1964 <p><code>mp_replace_second&lt;L, T&gt;</code> replaces the second element of the list <code>L</code> with <code>T</code>. That is, <code>mp_replace_second&lt;L&lt;U1, U2, U&#8230;&#8203;&gt;, T&gt;</code>
1965 is an alias for <code>L&lt;U1, T, U&#8230;&#8203;&gt;</code>.</p>
1966 </div>
1967 <div class="listingblock">
1968 <div class="title">Code Example 31. Using mp_replace_second with std::pair</div>
1969 <div class="content">
1970 <pre class="highlight"><code>using L1 = std::pair&lt;int, float&gt;;
1971 using R1 = mp_replace_second&lt;L1, void&gt;; // std::pair&lt;int, void&gt;</code></pre>
1972 </div>
1973 </div>
1974 <div class="listingblock">
1975 <div class="title">Code Example 32. Using mp_replace_second with std::tuple</div>
1976 <div class="content">
1977 <pre class="highlight"><code>using L2 = std::tuple&lt;float, double, long double&gt;;
1978 using R2 = mp_replace_second&lt;L2, void&gt;; // std::tuple&lt;float, void, long double&gt;</code></pre>
1979 </div>
1980 </div>
1981 <div class="listingblock">
1982 <div class="title">Code Example 33. Using mp_replace_front with mp_list</div>
1983 <div class="content">
1984 <pre class="highlight"><code>using L3 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
1985 using R3 = mp_replace_second&lt;L3, void&gt;; // mp_list&lt;char[1], void, char[3], char[4]&gt;;</code></pre>
1986 </div>
1987 </div>
1988 </div>
1989 <div class="sect3">
1990 <h4 id="mp_replace_thirdl_t">mp_replace_third&lt;L, T&gt;</h4>
1991 <div class="literalblock">
1992 <div class="content">
1993 <pre>template&lt;class L, class T&gt; using mp_replace_third = /*...*/;</pre>
1994 </div>
1995 </div>
1996 <div class="paragraph">
1997 <p><code>mp_replace_third&lt;L, T&gt;</code> replaces the third element of the list <code>L</code> with <code>T</code>. That is, <code>mp_replace_third&lt;L&lt;U1, U2, U3, U&#8230;&#8203;&gt;, T&gt;</code>
1998 is an alias for <code>L&lt;U1, U2, T, U&#8230;&#8203;&gt;</code>.</p>
1999 </div>
2000 <div class="listingblock">
2001 <div class="title">Code Example 34. Using mp_replace_third with std::tuple</div>
2002 <div class="content">
2003 <pre class="highlight"><code>using L1 = std::tuple&lt;float, double, long double&gt;;
2004 using R1 = mp_replace_third&lt;L1, void&gt;; // std::tuple&lt;float, double, void&gt;</code></pre>
2005 </div>
2006 </div>
2007 <div class="listingblock">
2008 <div class="title">Code Example 35. Using mp_replace_third with mp_list</div>
2009 <div class="content">
2010 <pre class="highlight"><code>using L2 = mp_list&lt;char[1], char[2], char[3], char[4]&gt;;
2011 using R2 = mp_replace_third&lt;L2, void&gt;; // mp_list&lt;char[1], char[2], void, char[4]&gt;;</code></pre>
2012 </div>
2013 </div>
2014 </div>
2015 <div class="sect3">
2016 <h4 id="mp_transform_frontl_f">mp_transform_front&lt;L, F&gt;</h4>
2017 <div class="literalblock">
2018 <div class="content">
2019 <pre>template&lt;class L, template&lt;class...&gt; class F&gt; using mp_transform_front =
2020     /*...*/;</pre>
2021 </div>
2022 </div>
2023 <div class="paragraph">
2024 <p><code>mp_transform_front&lt;L, F&gt;</code> replaces the first element <code>T1</code> of the list <code>L</code> with <code>F&lt;T1&gt;</code>.</p>
2025 </div>
2026 </div>
2027 <div class="sect3">
2028 <h4 id="mp_transform_front_ql_q">mp_transform_front_q&lt;L, Q&gt;</h4>
2029 <div class="literalblock">
2030 <div class="content">
2031 <pre>template&lt;class L, class Q&gt; using mp_transform_front_q =
2032     mp_transform_front&lt;L, Q::template fn&gt;;</pre>
2033 </div>
2034 </div>
2035 <div class="paragraph">
2036 <p>As <code>mp_transform_front</code>, but takes a quoted metafunction.</p>
2037 </div>
2038 </div>
2039 <div class="sect3">
2040 <h4 id="mp_transform_firstl_f">mp_transform_first&lt;L, F&gt;</h4>
2041 <div class="literalblock">
2042 <div class="content">
2043 <pre>template&lt;class L, template&lt;class...&gt; class F&gt; using mp_transform_first =
2044     mp_transform_front&lt;L, F&gt;;</pre>
2045 </div>
2046 </div>
2047 <div class="paragraph">
2048 <p><code>mp_transform_first</code> is another name for <code>mp_transform_front</code>.</p>
2049 </div>
2050 </div>
2051 <div class="sect3">
2052 <h4 id="mp_transform_first_ql_q">mp_transform_first_q&lt;L, Q&gt;</h4>
2053 <div class="literalblock">
2054 <div class="content">
2055 <pre>template&lt;class L, class Q&gt; using mp_transform_first_q =
2056     mp_transform_first&lt;L, Q::template fn&gt;;</pre>
2057 </div>
2058 </div>
2059 <div class="paragraph">
2060 <p>As <code>mp_transform_first</code>, but takes a quoted metafunction.</p>
2061 </div>
2062 </div>
2063 <div class="sect3">
2064 <h4 id="mp_transform_secondl_f">mp_transform_second&lt;L, F&gt;</h4>
2065 <div class="literalblock">
2066 <div class="content">
2067 <pre>template&lt;class L, template&lt;class...&gt; class F&gt; using mp_transform_second =
2068     /*...*/;</pre>
2069 </div>
2070 </div>
2071 <div class="paragraph">
2072 <p><code>mp_transform_second&lt;L, F&gt;</code> replaces the second element <code>T2</code> of the list <code>L</code> with <code>F&lt;T2&gt;</code>.</p>
2073 </div>
2074 </div>
2075 <div class="sect3">
2076 <h4 id="mp_transform_second_ql_q">mp_transform_second_q&lt;L, Q&gt;</h4>
2077 <div class="literalblock">
2078 <div class="content">
2079 <pre>template&lt;class L, class Q&gt; using mp_transform_second_q =
2080     mp_transform_second&lt;L, Q::template fn&gt;;</pre>
2081 </div>
2082 </div>
2083 <div class="paragraph">
2084 <p>As <code>mp_transform_second</code>, but takes a quoted metafunction.</p>
2085 </div>
2086 </div>
2087 <div class="sect3">
2088 <h4 id="mp_transform_thirdl_f">mp_transform_third&lt;L, F&gt;</h4>
2089 <div class="literalblock">
2090 <div class="content">
2091 <pre>template&lt;class L, template&lt;class...&gt; class F&gt; using mp_transform_third =
2092     /*...*/;</pre>
2093 </div>
2094 </div>
2095 <div class="paragraph">
2096 <p><code>mp_transform_third&lt;L, F&gt;</code> replaces the third element <code>T3</code> of the list <code>L</code> with <code>F&lt;T3&gt;</code>.</p>
2097 </div>
2098 </div>
2099 <div class="sect3">
2100 <h4 id="mp_transform_third_ql_q">mp_transform_third_q&lt;L, Q&gt;</h4>
2101 <div class="literalblock">
2102 <div class="content">
2103 <pre>template&lt;class L, class Q&gt; using mp_transform_third_q =
2104     mp_transform_third&lt;L, Q::template fn&gt;;</pre>
2105 </div>
2106 </div>
2107 <div class="paragraph">
2108 <p>As <code>mp_transform_third</code>, but takes a quoted metafunction.</p>
2109 </div>
2110 </div>
2111 </div>
2112 <div class="sect2">
2113 <h3 id="utility">Utility Components, &lt;boost/mp11/utility.hpp&gt;</h3>
2114 <div class="sect3">
2115 <h4 id="mp_identityt">mp_identity&lt;T&gt;</h4>
2116 <div class="literalblock">
2117 <div class="content">
2118 <pre>template&lt;class T&gt; struct mp_identity
2119 {
2120     using type = T;
2121 };</pre>
2122 </div>
2123 </div>
2124 <div class="paragraph">
2125 <p><code>mp_identity</code> is a simple <em>transformation type trait</em> (as per the C++ standard)
2126 that just returns the same type. It&#8217;s useful both as such, and as a type wrapper
2127 for passing types as values to functions.</p>
2128 </div>
2129 <div class="listingblock">
2130 <div class="title">Code Example 36. Using mp_identity as a type trait</div>
2131 <div class="content">
2132 <pre class="highlight"><code>template&lt;class T&gt; using addp_if_not_ref =
2133     typename mp_if&lt;std::is_reference&lt;T&gt;, mp_identity&lt;T&gt;, std::add_pointer&lt;T&gt;&gt;::type;</code></pre>
2134 </div>
2135 </div>
2136 <div class="listingblock">
2137 <div class="title">Code Example 37. Using mp_identity to protect qualifiers and references</div>
2138 <div class="content">
2139 <pre class="highlight"><code>template&lt;class T&gt; void print1()
2140 {
2141     std::cout &lt;&lt; typeid(T).name() &lt;&lt; std::endl;
2142 }
2143
2144 template&lt;class T&gt; void print2()
2145 {
2146     std::cout &lt;&lt; typeid(mp_identity&lt;T&gt;).name() &lt;&lt; std::endl;
2147 }
2148
2149 int main()
2150 {
2151     print1&lt;int const&amp;&gt;(); // 'int'
2152     print2&lt;int const&amp;&gt;(); // 'mp_identity&lt;int const &amp;&gt;'
2153 }</code></pre>
2154 </div>
2155 </div>
2156 </div>
2157 <div class="sect3">
2158 <h4 id="mp_identity_tt">mp_identity_t&lt;T&gt;</h4>
2159 <div class="literalblock">
2160 <div class="content">
2161 <pre>template&lt;class T&gt; using mp_identity_t = typename mp_identity&lt;T&gt;::type;</pre>
2162 </div>
2163 </div>
2164 </div>
2165 <div class="sect3">
2166 <h4 id="mp_inheritt">mp_inherit&lt;T&#8230;&#8203;&gt;</h4>
2167 <div class="literalblock">
2168 <div class="content">
2169 <pre>template&lt;class... T&gt; struct mp_inherit: T... {};</pre>
2170 </div>
2171 </div>
2172 </div>
2173 <div class="sect3">
2174 <h4 id="mp_if_cc_t_e">mp_if_c&lt;C, T, E&#8230;&#8203;&gt;</h4>
2175 <div class="literalblock">
2176 <div class="content">
2177 <pre>template&lt;bool C, class T, class... E&gt; using mp_if_c = /*...*/;</pre>
2178 </div>
2179 </div>
2180 <div class="paragraph">
2181 <p><code>mp_if_c&lt;true, T, E&#8230;&#8203;&gt;</code> is an alias for <code>T</code>. <code>mp_if_c&lt;false, T, E&gt;</code> is an alias for <code>E</code>. Otherwise, the result is a substitution failure.</p>
2182 </div>
2183 <div class="listingblock">
2184 <div class="title">Code Example 38. Using mp_if_c to select between two alternatives</div>
2185 <div class="content">
2186 <pre class="highlight"><code>using R1 = mp_if_c&lt;true, int, void&gt;;  // int
2187
2188 using R2 = mp_if_c&lt;false, int, void&gt;; // void</code></pre>
2189 </div>
2190 </div>
2191 <div class="listingblock">
2192 <div class="title">Code Example 39. Using mp_if_c to fail substitution when a condition is not met</div>
2193 <div class="content">
2194 <pre class="highlight"><code>template&lt;class I&gt; using void_if_5 = mp_if_c&lt;I::value == 5, void&gt;;</code></pre>
2195 </div>
2196 </div>
2197 <div class="paragraph">
2198 <p>This example returns <code>void</code> when <code>I::value</code> is 5, and generates a substitution failure
2199 otherwise. It&#8217;s the same as <code>std::enable_if_t&lt;I::value == 5&gt;</code> in C&#43;&#43;14, or
2200 <code>typename std::enable_if&lt;I::value == 5&gt;::type</code> in C&#43;&#43;11.</p>
2201 </div>
2202 </div>
2203 <div class="sect3">
2204 <h4 id="mp_ifc_t_e">mp_if&lt;C, T, E&#8230;&#8203;&gt;</h4>
2205 <div class="literalblock">
2206 <div class="content">
2207 <pre>template&lt;class C, class T, class... E&gt; using mp_if =
2208     mp_if_c&lt;static_cast&lt;bool&gt;(C::value), T, E...&gt;;</pre>
2209 </div>
2210 </div>
2211 <div class="paragraph">
2212 <p>Like <code>mp_if_c</code>, but the first argument is a type.</p>
2213 </div>
2214 <div class="listingblock">
2215 <div class="title">Code Example 40. Using mp_if to select between two alternatives</div>
2216 <div class="content">
2217 <pre class="highlight"><code>using R1 = mp_if&lt;mp_true, int, void&gt;;  // int
2218
2219 using R2 = mp_if&lt;mp_false, int, void&gt;; // void</code></pre>
2220 </div>
2221 </div>
2222 <div class="listingblock">
2223 <div class="title">Code Example 41. Using mp_if to fail substitution when a condition is not met</div>
2224 <div class="content">
2225 <pre class="highlight"><code>template&lt;class T&gt; using void_if_const = mp_if&lt;std::is_const&lt;T&gt;, void&gt;;
2226
2227 template&lt;class... T&gt; using void_if_all_const =
2228     mp_if&lt;mp_all&lt;std::is_const&lt;T&gt;...&gt;, void&gt;;
2229
2230 template&lt;class T&gt; using if_non_const = mp_if&lt;mp_not&lt;std::is_const&lt;T&gt;&gt;, T&gt;;</code></pre>
2231 </div>
2232 </div>
2233 </div>
2234 <div class="sect3">
2235 <h4 id="mp_eval_if_cc_t_f_u">mp_eval_if_c&lt;C, T, F, U&#8230;&#8203;&gt;</h4>
2236 <div class="literalblock">
2237 <div class="content">
2238 <pre>template&lt;bool C, class T, template&lt;class...&gt; class F, class... U&gt; using mp_eval_if_c =
2239     /*...*/;</pre>
2240 </div>
2241 </div>
2242 <div class="paragraph">
2243 <p><code>mp_eval_if_c&lt;C, T, F, U&#8230;&#8203;&gt;</code> is an alias for <code>T</code> when <code>C</code> is <code>true</code>, for <code>F&lt;U&#8230;&#8203;&gt;</code> otherwise. Its purpose
2244 is to avoid evaluating <code>F&lt;U&#8230;&#8203;&gt;</code> when the condition is <code>true</code> as it may not be valid in this case.</p>
2245 </div>
2246 <div class="listingblock">
2247 <div class="title">Code Example 42. Using mp_eval_if_c to select the first pack element, or void</div>
2248 <div class="content">
2249 <pre class="highlight"><code>template&lt;class... T&gt; using first_or_void =
2250     mp_eval_if_c&lt;sizeof...(T) == 0, void, mp_apply, mp_first, mp_list&lt;T...&gt;&gt;;</code></pre>
2251 </div>
2252 </div>
2253 </div>
2254 <div class="sect3">
2255 <h4 id="mp_eval_ifc_t_f_u">mp_eval_if&lt;C, T, F, U&#8230;&#8203;&gt;</h4>
2256 <div class="literalblock">
2257 <div class="content">
2258 <pre>template&lt;class C, class T, template&lt;class...&gt; class F, class... U&gt; using mp_eval_if =
2259     mp_eval_if_c&lt;static_cast&lt;bool&gt;(C::value), T, F, U...&gt;;</pre>
2260 </div>
2261 </div>
2262 <div class="paragraph">
2263 <p>Like <code>mp_eval_if_c</code>, but the first argument is a type.</p>
2264 </div>
2265 <div class="listingblock">
2266 <div class="title">Code Example 43. Using mp_eval_if to select the first list element, or void</div>
2267 <div class="content">
2268 <pre class="highlight"><code>template&lt;class L&gt; using first_or_void = mp_eval_if&lt;mp_empty&lt;L&gt;, void, mp_first, L&gt;;</code></pre>
2269 </div>
2270 </div>
2271 </div>
2272 <div class="sect3">
2273 <h4 id="mp_eval_if_qc_t_q_u">mp_eval_if_q&lt;C, T, Q, U&#8230;&#8203;&gt;</h4>
2274 <div class="literalblock">
2275 <div class="content">
2276 <pre>template&lt;class C, class T, class Q, class... U&gt; using mp_eval_if_q =
2277     mp_eval_if&lt;C, T, Q::template fn, U...&gt;;</pre>
2278 </div>
2279 </div>
2280 <div class="paragraph">
2281 <p>Like <code>mp_eval_if</code>, but takes a quoted metafunction.</p>
2282 </div>
2283 </div>
2284 <div class="sect3">
2285 <h4 id="mp_eval_if_notc_t_f_u">mp_eval_if_not&lt;C, T, F, U&#8230;&#8203;&gt;</h4>
2286 <div class="literalblock">
2287 <div class="content">
2288 <pre>template&lt;class C, class T, template&lt;class...&gt; class F, class... U&gt;
2289     using mp_eval_if_not = mp_eval_if&lt;mp_not&lt;C&gt;, T, F, U...&gt;;</pre>
2290 </div>
2291 </div>
2292 <div class="paragraph">
2293 <p>Same as <code>mp_eval_if</code>, but the condition is reversed.</p>
2294 </div>
2295 </div>
2296 <div class="sect3">
2297 <h4 id="mp_eval_if_not_qc_t_q_u">mp_eval_if_not_q&lt;C, T, Q, U&#8230;&#8203;&gt;</h4>
2298 <div class="literalblock">
2299 <div class="content">
2300 <pre>template&lt;class C, class T, class Q, class... U&gt; using mp_eval_if_not_q =
2301     mp_eval_if_not&lt;C, T, Q::template fn, U...&gt;;</pre>
2302 </div>
2303 </div>
2304 <div class="paragraph">
2305 <p>Same as <code>mp_eval_if_not</code>, but takes a quoted metafunction.</p>
2306 </div>
2307 </div>
2308 <div class="sect3">
2309 <h4 id="mp_validf_t">mp_valid&lt;F, T&#8230;&#8203;&gt;</h4>
2310 <div class="literalblock">
2311 <div class="content">
2312 <pre>template&lt;template&lt;class...&gt; class F, class... T&gt; using mp_valid = /*...*/;</pre>
2313 </div>
2314 </div>
2315 <div class="paragraph">
2316 <p><code>mp_valid&lt;F, T&#8230;&#8203;&gt;</code> is an alias for <code>mp_true</code> when <code>F&lt;T&#8230;&#8203;&gt;</code> is a valid expression, for <code>mp_false</code> otherwise.</p>
2317 </div>
2318 <div class="listingblock">
2319 <div class="title">Code Example 44. Using mp_valid to write a metafunction that checks for the existence of a nested type</div>
2320 <div class="content">
2321 <pre class="highlight"><code>template&lt;class T&gt; using get_nested_type = typename T::type;
2322
2323 template&lt;class T&gt; struct has_nested_type: mp_valid&lt;get_nested_type, T&gt; {};</code></pre>
2324 </div>
2325 </div>
2326 </div>
2327 <div class="sect3">
2328 <h4 id="mp_valid_qq_t">mp_valid_q&lt;Q, T&#8230;&#8203;&gt;</h4>
2329 <div class="literalblock">
2330 <div class="content">
2331 <pre>template&lt;class Q, class... T&gt; using mp_valid_q = mp_valid&lt;Q::template fn, T...&gt;;</pre>
2332 </div>
2333 </div>
2334 <div class="paragraph">
2335 <p>Like <code>mp_valid</code>, but takes a quoted metafunction.</p>
2336 </div>
2337 </div>
2338 <div class="sect3">
2339 <h4 id="mp_eval_ort_f_u">mp_eval_or&lt;T, F, U&#8230;&#8203;&gt;</h4>
2340 <div class="literalblock">
2341 <div class="content">
2342 <pre>template&lt;class T, template&lt;class...&gt; class F, class... U&gt; using mp_eval_or =
2343     mp_eval_if_not&lt;mp_valid&lt;F, U...&gt;, T, F, U...&gt;;</pre>
2344 </div>
2345 </div>
2346 <div class="paragraph">
2347 <p><code>mp_eval_or&lt;T, F, U&#8230;&#8203;&gt;</code> is an alias for <code>F&lt;U&#8230;&#8203;&gt;</code> when this expression is valid, for <code>T</code> otherwise.</p>
2348 </div>
2349 </div>
2350 <div class="sect3">
2351 <h4 id="mp_eval_or_qt_q_u">mp_eval_or_q&lt;T, Q, U&#8230;&#8203;&gt;</h4>
2352 <div class="literalblock">
2353 <div class="content">
2354 <pre>template&lt;class T, class Q, class... U&gt; using mp_eval_or_q =
2355     mp_eval_or&lt;T, Q::template fn, U...&gt;;</pre>
2356 </div>
2357 </div>
2358 <div class="paragraph">
2359 <p>Like <code>mp_eval_or</code>, but takes a quoted metafunction.</p>
2360 </div>
2361 </div>
2362 <div class="sect3">
2363 <h4 id="mp_condc_t_r">mp_cond&lt;C, T, R&#8230;&#8203;&gt;</h4>
2364 <div class="literalblock">
2365 <div class="content">
2366 <pre>template&lt;class C, class T, class... R&gt; using mp_cond = /*...*/;</pre>
2367 </div>
2368 </div>
2369 <div class="paragraph">
2370 <p><code>mp_cond&lt;C, T, R&#8230;&#8203;&gt;</code> is an alias for <code>T</code> when <code>static_cast&lt;bool&gt;(C::value)</code> is <code>true</code>.
2371 When <code>static_cast&lt;bool&gt;(C::value)</code> is <code>false</code>, it&#8217;s an alias for <code>mp_cond&lt;R&#8230;&#8203;&gt;</code>.</p>
2372 </div>
2373 <div class="paragraph">
2374 <p>(If <code>static_cast&lt;bool&gt;(C::value)</code> is a substitution failure, the result is too a substitution
2375 failure.)</p>
2376 </div>
2377 <div class="listingblock">
2378 <div class="title">Code Example 45. Using mp_cond</div>
2379 <div class="content">
2380 <pre class="highlight"><code>template&lt;int N&gt; using unsigned_ = mp_cond&lt;
2381     mp_bool&lt;N ==  8&gt;, uint8_t,
2382     mp_bool&lt;N == 16&gt;, uint16_t,
2383     mp_bool&lt;N == 32&gt;, uint32_t,
2384     mp_bool&lt;N == 64&gt;, uint64_t,
2385     mp_true, unsigned // default case
2386 &gt;;</code></pre>
2387 </div>
2388 </div>
2389 </div>
2390 <div class="sect3">
2391 <h4 id="mp_deferf_t">mp_defer&lt;F, T&#8230;&#8203;&gt;</h4>
2392 <div class="literalblock">
2393 <div class="content">
2394 <pre>template&lt;template&lt;class...&gt; class F, class... T&gt; using mp_defer = /*...*/;</pre>
2395 </div>
2396 </div>
2397 <div class="paragraph">
2398 <p>When <code>mp_valid&lt;F, T&#8230;&#8203;&gt;</code> is <code>mp_true</code>, <code>mp_defer&lt;F, T&#8230;&#8203;&gt;</code> is a struct with a nested type <code>type</code> which is an alias for <code>F&lt;T&#8230;&#8203;&gt;</code>. Otherwise,
2399 <code>mp_defer&lt;F, T&#8230;&#8203;&gt;</code> is an empty struct.</p>
2400 </div>
2401 </div>
2402 <div class="sect3">
2403 <h4 id="mp_quotef">mp_quote&lt;F&gt;</h4>
2404 <div class="literalblock">
2405 <div class="content">
2406 <pre>template&lt;template&lt;class...&gt; class F&gt; struct mp_quote
2407 {
2408     template&lt;class... T&gt; using fn = F&lt;T...&gt;;
2409 };</pre>
2410 </div>
2411 </div>
2412 <div class="paragraph">
2413 <p><code>mp_quote&lt;F&gt;</code> transforms the template <code>F</code> into a <em>quoted metafunction</em>, a type with a nested template <code>fn</code> such that <code>fn&lt;T&#8230;&#8203;&gt;</code> returns <code>F&lt;T&#8230;&#8203;&gt;</code>.</p>
2414 </div>
2415 <div class="listingblock">
2416 <div class="title">Code Example 46. Using mp_quote to make a list of metafunctions</div>
2417 <div class="content">
2418 <pre class="highlight"><code>using LQ = mp_list&lt;mp_quote&lt;std::is_const&gt;, mp_quote&lt;std::is_volatile&gt;&gt;;</code></pre>
2419 </div>
2420 </div>
2421 </div>
2422 <div class="sect3">
2423 <h4 id="mp_quote_traitf">mp_quote_trait&lt;F&gt;</h4>
2424 <div class="literalblock">
2425 <div class="content">
2426 <pre>template&lt;template&lt;class...&gt; class F&gt; struct mp_quote_trait
2427 {
2428     template&lt;class... T&gt; using fn = typename F&lt;T...&gt;::type;
2429 };</pre>
2430 </div>
2431 </div>
2432 <div class="paragraph">
2433 <p><code>mp_quote_trait&lt;F&gt;</code> transforms the C++03-style trait <code>F</code> into a quoted metafunction.</p>
2434 </div>
2435 <div class="listingblock">
2436 <div class="title">Code Example 47. Using mp_quote_trait with std::add_pointer</div>
2437 <div class="content">
2438 <pre class="highlight"><code>using L1 = mp_list&lt;int, void, float&gt;;
2439 using R1 = mp_transform_q&lt;mp_quote_trait&lt;std::add_pointer&gt;, L1&gt;;
2440   // mp_list&lt;int*, void*, float*&gt;</code></pre>
2441 </div>
2442 </div>
2443 </div>
2444 <div class="sect3">
2445 <h4 id="mp_invoke_qq_t">mp_invoke_q&lt;Q, T&#8230;&#8203;&gt;</h4>
2446 <div class="literalblock">
2447 <div class="content">
2448 <pre>template&lt;class Q, class... T&gt; using mp_invoke_q = typename Q::template fn&lt;T...&gt;;</pre>
2449 </div>
2450 </div>
2451 <div class="paragraph">
2452 <p><code>mp_invoke_q&lt;Q, T&#8230;&#8203;&gt;</code> evaluates the nested template <code>fn</code> of a quoted metafunction. <code>mp_invoke_q&lt;mp_quote&lt;F&gt;, T&#8230;&#8203;&gt;</code> returns <code>F&lt;T&#8230;&#8203;&gt;</code>.</p>
2453 </div>
2454 <div class="listingblock">
2455 <div class="title">Code Example 48. Using mp_invoke_q to invoke a list of metafunctions, technique 1</div>
2456 <div class="content">
2457 <pre class="highlight"><code>using LQ = mp_list&lt;mp_quote&lt;std::is_const&gt;, mp_quote&lt;std::is_volatile&gt;&gt;;
2458
2459 template&lt;class T&gt; using is_const_and_volatile =
2460     mp_all&lt;mp_product&lt;mp_invoke_q, LQ, mp_list&lt;T&gt;&gt;&gt;;</code></pre>
2461 </div>
2462 </div>
2463 <div class="listingblock">
2464 <div class="title">Code Example 49. Using mp_invoke_q to invoke a list of metafunctions, technique 2</div>
2465 <div class="content">
2466 <pre class="highlight"><code>template&lt;class T&gt; using is_const_and_volatile =
2467     mp_all&lt;mp_transform_q&lt;mp_bind_back&lt;mp_invoke_q, T&gt;, LQ&gt;&gt;;</code></pre>
2468 </div>
2469 </div>
2470 <div class="listingblock">
2471 <div class="title">Code Example 50. Using mp_invoke_q to invoke a list of metafunctions, technique 3</div>
2472 <div class="content">
2473 <pre class="highlight"><code>template&lt;class T&gt; using is_const_and_volatile =
2474     mp_all&lt;mp_transform&lt;mp_invoke_q, LQ, mp_fill&lt;LQ, T&gt;&gt;&gt;;</code></pre>
2475 </div>
2476 </div>
2477 </div>
2478 <div class="sect3">
2479 <h4 id="mp_not_fnp">mp_not_fn&lt;P&gt;</h4>
2480 <div class="literalblock">
2481 <div class="content">
2482 <pre>template&lt;template&lt;class...&gt; class P&gt; struct mp_not_fn
2483 {
2484     template&lt;class... T&gt; using fn = mp_not&lt;P&lt;T...&gt;&gt;;
2485 };</pre>
2486 </div>
2487 </div>
2488 <div class="paragraph">
2489 <p><code>mp_not_fn&lt;P&gt;</code> returns a quoted metafunction <code>Q</code> such that <code>Q::fn&lt;T&#8230;&#8203;&gt;</code> returns <code>mp_not&lt;P&lt;T&#8230;&#8203;&gt;&gt;</code>.</p>
2490 </div>
2491 <div class="paragraph">
2492 <p>That is, it negates the result of <code>P</code>.</p>
2493 </div>
2494 </div>
2495 <div class="sect3">
2496 <h4 id="mp_not_fn_qq">mp_not_fn_q&lt;Q&gt;</h4>
2497 <div class="literalblock">
2498 <div class="content">
2499 <pre>template&lt;class Q&gt; using mp_not_fn_q = mp_not_fn&lt;Q::template fn&gt;;</pre>
2500 </div>
2501 </div>
2502 <div class="paragraph">
2503 <p>As <code>mp_not_fn</code>, but takes a quoted metafunction.</p>
2504 </div>
2505 </div>
2506 </div>
2507 <div class="sect2">
2508 <h3 id="algorithm">Algorithms, &lt;boost/mp11/algorithm.hpp&gt;</h3>
2509 <div class="sect3">
2510 <h4 id="mp_transformf_l">mp_transform&lt;F, L&#8230;&#8203;&gt;</h4>
2511 <div class="literalblock">
2512 <div class="content">
2513 <pre>template&lt;template&lt;class...&gt; class F, class... L&gt; using mp_transform = /*...*/;</pre>
2514 </div>
2515 </div>
2516 <div class="paragraph">
2517 <p><code>mp_transform&lt;F, L1&lt;T1&#8230;&#8203;&gt;, L2&lt;T2&#8230;&#8203;&gt;, &#8230;&#8203;, Ln&lt;Tn&#8230;&#8203;&gt;&gt;</code> applies <code>F</code> to each successive tuple of elements and returns <code>L1&lt;F&lt;T1, T2, &#8230;&#8203;, Tn&gt;&#8230;&#8203;&gt;</code>.</p>
2518 </div>
2519 <div class="listingblock">
2520 <div class="title">Code Example 51. Using mp_transform to produce a list of pointers from a list of pointees</div>
2521 <div class="content">
2522 <pre class="highlight"><code>template&lt;class T&gt; using add_pointer_t =
2523     typename std::add_pointer&lt;T&gt;::type;  // std::add_pointer_t in C++14
2524
2525 using L1 = std::tuple&lt;void, int, float&gt;;
2526 using R1 = mp_transform&lt;add_pointer_t, L1&gt;; // std::tuple&lt;void*, int*, float*&gt;</code></pre>
2527 </div>
2528 </div>
2529 <div class="listingblock">
2530 <div class="title">Code Example 52. Using mp_transform to compare the contents of two lists of types</div>
2531 <div class="content">
2532 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float&gt;;
2533 using L2 = mp_list&lt;void, int, float&gt;;
2534
2535 using R1 = mp_all&lt;mp_transform&lt;std::is_same, L1, L2&gt;&gt;; // mp_true</code></pre>
2536 </div>
2537 </div>
2538 <div class="listingblock">
2539 <div class="title">Code Example 53. Using mp_transform to compare the contents of two lists of integral constants</div>
2540 <div class="content">
2541 <pre class="highlight"><code>template&lt;class T1, class T2&gt; using eq = mp_bool&lt;T1::value == T2::value&gt;;
2542
2543 using L1 = std::tuple&lt;mp_int&lt;1&gt;, mp_int&lt;2&gt;, mp_int&lt;3&gt;&gt;;
2544 using L2 = mp_list&lt;mp_size_t&lt;1&gt;, mp_size_t&lt;2&gt;, mp_size_t&lt;3&gt;&gt;;
2545
2546 using R1 = mp_all&lt;mp_transform&lt;eq, L1, L2&gt;&gt;; // mp_true</code></pre>
2547 </div>
2548 </div>
2549 <table class="tableblock frame-all grid-all" style="width: 85%;">
2550 <caption class="title">Illustration 1. mp_transform on one list</caption>
2551 <colgroup>
2552 <col style="width: 50%;">
2553 <col style="width: 12.5%;">
2554 <col style="width: 12.5%;">
2555 <col style="width: 12.5%;">
2556 <col style="width: 12.5%;">
2557 </colgroup>
2558 <tbody>
2559 <tr>
2560 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2561 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2562 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2563 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2564 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2565 </tr>
2566 <tr>
2567 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2568 </tr>
2569 <tr>
2570 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_transform&lt;F, L1&gt;</strong></code></p></td>
2571 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>1</sub>&gt;</code></p></td>
2572 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>&gt;</code></p></td>
2573 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2574 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>n</sub>&gt;</code></p></td>
2575 </tr>
2576 </tbody>
2577 </table>
2578 <table class="tableblock frame-all grid-all" style="width: 85%;">
2579 <caption class="title">Illustration 2. mp_transform on two lists</caption>
2580 <colgroup>
2581 <col style="width: 50%;">
2582 <col style="width: 12.5%;">
2583 <col style="width: 12.5%;">
2584 <col style="width: 12.5%;">
2585 <col style="width: 12.5%;">
2586 </colgroup>
2587 <tbody>
2588 <tr>
2589 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2590 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2591 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2592 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2593 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2594 </tr>
2595 <tr>
2596 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2597 </tr>
2598 <tr>
2599 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L2</strong></code></p></td>
2600 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
2601 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
2602 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2603 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>n</sub></code></p></td>
2604 </tr>
2605 <tr>
2606 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2607 </tr>
2608 <tr>
2609 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_transform&lt;F, L1, L2&gt;</strong></code></p></td>
2610 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>1</sub>,B<sub>1</sub>&gt;</code></p></td>
2611 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>,B<sub>2</sub>&gt;</code></p></td>
2612 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2613 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>n</sub>,B<sub>n</sub>&gt;</code></p></td>
2614 </tr>
2615 </tbody>
2616 </table>
2617 </div>
2618 <div class="sect3">
2619 <h4 id="mp_transform_qq_l">mp_transform_q&lt;Q, L&#8230;&#8203;&gt;</h4>
2620 <div class="literalblock">
2621 <div class="content">
2622 <pre>template&lt;class Q, class... L&gt; using mp_transform_q =
2623     mp_transform&lt;Q::template fn, L...&gt;;</pre>
2624 </div>
2625 </div>
2626 <div class="paragraph">
2627 <p>As <code>mp_transform</code>, but takes a quoted metafunction.</p>
2628 </div>
2629 <div class="listingblock">
2630 <div class="title">Code Example 54. Using mp_transform_q to count the occurrences of <code>void</code> in a list</div>
2631 <div class="content">
2632 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float, void, int&gt;;
2633
2634 using R1 = mp_apply&lt;mp_plus,
2635     mp_transform_q&lt;mp_bind_front&lt;std::is_same, void&gt;, L1&gt;&gt;; // mp_int&lt;2&gt;</code></pre>
2636 </div>
2637 </div>
2638 <table class="tableblock frame-all grid-all" style="width: 85%;">
2639 <caption class="title">Illustration 3. mp_transform_q on two lists</caption>
2640 <colgroup>
2641 <col style="width: 50%;">
2642 <col style="width: 12.5%;">
2643 <col style="width: 12.5%;">
2644 <col style="width: 12.5%;">
2645 <col style="width: 12.5%;">
2646 </colgroup>
2647 <tbody>
2648 <tr>
2649 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2650 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2651 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2652 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2653 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2654 </tr>
2655 <tr>
2656 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2657 </tr>
2658 <tr>
2659 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L2</strong></code></p></td>
2660 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
2661 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
2662 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2663 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>n</sub></code></p></td>
2664 </tr>
2665 <tr>
2666 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2667 </tr>
2668 <tr>
2669 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_transform_q&lt;Q, L1, L2&gt;</strong></code></p></td>
2670 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>Q::fn&lt;A<sub>1</sub>,B<sub>1</sub>&gt;</code></p></td>
2671 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>Q::fn&lt;A<sub>2</sub>,B<sub>2</sub>&gt;</code></p></td>
2672 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2673 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>Q::fn&lt;A<sub>n</sub>,B<sub>n</sub>&gt;</code></p></td>
2674 </tr>
2675 </tbody>
2676 </table>
2677 </div>
2678 <div class="sect3">
2679 <h4 id="mp_transform_ifp_f_l">mp_transform_if&lt;P, F, L&#8230;&#8203;&gt;</h4>
2680 <div class="literalblock">
2681 <div class="content">
2682 <pre>template&lt;template&lt;class...&gt; class P, template&lt;class...&gt; class F, class... L&gt;
2683     using mp_transform_if = /*...*/;</pre>
2684 </div>
2685 </div>
2686 <div class="paragraph">
2687 <p><code>mp_transform_if&lt;P, F, L1, L2, &#8230;&#8203;, Ln&gt;</code> replaces the elements of the list <code>L1</code> for which <code>mp_to_bool&lt;P&lt;T1, T2, &#8230;&#8203;, Tn&gt;&gt;</code> is <code>mp_true</code> with
2688 <code>F&lt;T1, T2, &#8230;&#8203;, Tn&gt;</code>, and returns the result, where <code>Ti</code> are the corresponding elements of <code>Li</code>.</p>
2689 </div>
2690 <div class="listingblock">
2691 <div class="title">Code Example 55. Using mp_transform_if to replace the occurrences of 'void' in a list with the corresponding elements of a second list</div>
2692 <div class="content">
2693 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float, void, int&gt;;
2694 using L2 = std::tuple&lt;char[1], char[2], char[3], char[4], char[5]&gt;;
2695
2696 template&lt;class T1, class T2&gt; using first_is_void = std::is_same&lt;T1, void&gt;;
2697 template&lt;class T1, class T2&gt; using second = T2;
2698
2699 using R1 = mp_transform_if&lt;first_is_void, second, L1, L2&gt;;
2700   // std::tuple&lt;char[1], int, float, char[4], int&gt;</code></pre>
2701 </div>
2702 </div>
2703 <table class="tableblock frame-all grid-all" style="width: 85%;">
2704 <caption class="title">Illustration 4. mp_transform_if</caption>
2705 <colgroup>
2706 <col style="width: 50%;">
2707 <col style="width: 12.5%;">
2708 <col style="width: 12.5%;">
2709 <col style="width: 12.5%;">
2710 <col style="width: 12.5%;">
2711 </colgroup>
2712 <tbody>
2713 <tr>
2714 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2715 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2716 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2717 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2718 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2719 </tr>
2720 <tr>
2721 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2722 </tr>
2723 <tr>
2724 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L2</strong></code></p></td>
2725 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
2726 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
2727 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2728 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>n</sub></code></p></td>
2729 </tr>
2730 <tr>
2731 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2732 </tr>
2733 <tr>
2734 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>P&lt;A<sub>i</sub>, B<sub>i</sub>&gt;</strong></code></p></td>
2735 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
2736 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_true</code></p></td>
2737 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2738 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
2739 </tr>
2740 <tr>
2741 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2742 </tr>
2743 <tr>
2744 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_transform_if&lt;P, F, L1, L2&gt;</strong></code></p></td>
2745 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2746 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>,B<sub>2</sub>&gt;</code></p></td>
2747 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2748 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2749 </tr>
2750 </tbody>
2751 </table>
2752 </div>
2753 <div class="sect3">
2754 <h4 id="mp_transform_if_qqp_qf_l">mp_transform_if_q&lt;Qp, Qf, L&#8230;&#8203;&gt;</h4>
2755 <div class="literalblock">
2756 <div class="content">
2757 <pre>template&lt;class Qp, class Qf, class... L&gt; using mp_transform_if_q =
2758     mp_transform_if&lt;Qp::template fn, Qf::template fn, L...&gt;;</pre>
2759 </div>
2760 </div>
2761 <div class="paragraph">
2762 <p>As <code>mp_transform_if</code>, but takes quoted metafunctions.</p>
2763 </div>
2764 <div class="listingblock">
2765 <div class="title">Code Example 56. Using mp_transform_if_q to replace the occurrences of 'void' in a list with the corresponding elements of a second list</div>
2766 <div class="content">
2767 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float, void, int&gt;;
2768 using L2 = std::tuple&lt;char[1], char[2], char[3], char[4], char[5]&gt;;
2769
2770 using R1 = mp_transform_if_q&lt;mp_bind&lt;std::is_same, _1, void&gt;, _2, L1, L2&gt;;
2771   // std::tuple&lt;char[1], int, float, char[4], int&gt;</code></pre>
2772 </div>
2773 </div>
2774 <table class="tableblock frame-all grid-all" style="width: 85%;">
2775 <caption class="title">Illustration 5. mp_transform_if_q</caption>
2776 <colgroup>
2777 <col style="width: 50%;">
2778 <col style="width: 12.5%;">
2779 <col style="width: 12.5%;">
2780 <col style="width: 12.5%;">
2781 <col style="width: 12.5%;">
2782 </colgroup>
2783 <tbody>
2784 <tr>
2785 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2786 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2787 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2788 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2789 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2790 </tr>
2791 <tr>
2792 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2793 </tr>
2794 <tr>
2795 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L2</strong></code></p></td>
2796 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
2797 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
2798 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2799 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>n</sub></code></p></td>
2800 </tr>
2801 <tr>
2802 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2803 </tr>
2804 <tr>
2805 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>Qp::fn&lt;A<sub>i</sub>, B<sub>i</sub>&gt;</strong></code></p></td>
2806 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
2807 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_true</code></p></td>
2808 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2809 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
2810 </tr>
2811 <tr>
2812 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2813 </tr>
2814 <tr>
2815 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_transform_if_q&lt;Qp, _2, L1, L2&gt;</strong></code></p></td>
2816 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2817 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
2818 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2819 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2820 </tr>
2821 </tbody>
2822 </table>
2823 </div>
2824 <div class="sect3">
2825 <h4 id="mp_filterp_l">mp_filter&lt;P, L&#8230;&#8203;&gt;</h4>
2826 <div class="literalblock">
2827 <div class="content">
2828 <pre>template&lt;template&lt;class...&gt; class P, class... L&gt; using mp_filter = /*...*/;</pre>
2829 </div>
2830 </div>
2831 <div class="paragraph">
2832 <p><code>mp_filter&lt;P, L1, L2, &#8230;&#8203;, Ln&gt;</code> removes the elements of the list <code>L1</code> for which <code>mp_to_bool&lt;P&lt;T1, T2, &#8230;&#8203;, Tn&gt;&gt;</code>
2833 is <code>mp_false</code> and returns the result, where <code>Ti</code> are the corresponding elements of <code>Li</code>.</p>
2834 </div>
2835 <div class="paragraph">
2836 <p>See also <code>mp_copy_if</code> and <code>mp_remove_if</code>, less general variants of <code>mp_filter</code> that only take a single list.</p>
2837 </div>
2838 </div>
2839 <div class="sect3">
2840 <h4 id="mp_filter_qqp_l">mp_filter_q&lt;Qp, L&#8230;&#8203;&gt;</h4>
2841 <div class="literalblock">
2842 <div class="content">
2843 <pre>template&lt;class Qp, class... L&gt; using mp_filter_q =
2844     mp_filter&lt;Qp::template fn, L...&gt;;</pre>
2845 </div>
2846 </div>
2847 <div class="paragraph">
2848 <p>As <code>mp_filter</code>, but takes a quoted metafunction.</p>
2849 </div>
2850 <div class="listingblock">
2851 <div class="title">Code Example 57. Using mp_filter_q to pick elements of a list based on a mask in another list</div>
2852 <div class="content">
2853 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float&gt;;
2854 using L2 = mp_list&lt;mp_true, mp_false, mp_true&gt;;
2855 using R1 = mp_filter_q&lt;_2, L1, L2&gt;; // std::tuple&lt;void, float&gt;</code></pre>
2856 </div>
2857 </div>
2858 </div>
2859 <div class="sect3">
2860 <h4 id="mp_filll_v">mp_fill&lt;L, V&gt;</h4>
2861 <div class="literalblock">
2862 <div class="content">
2863 <pre>template&lt;class L, class V&gt; using mp_fill = /*...*/;</pre>
2864 </div>
2865 </div>
2866 <div class="paragraph">
2867 <p><code>mp_fill&lt;L&lt;T&#8230;&#8203;&gt;, V&gt;</code> returns <code>L&lt;V, V, &#8230;&#8203;, V&gt;</code>, with the result having the same size as the input.</p>
2868 </div>
2869 <div class="listingblock">
2870 <div class="title">Code Example 58. Using mp_fill with std::tuple</div>
2871 <div class="content">
2872 <pre class="highlight"><code>using L1 = std::tuple&lt;void, int, float&gt;;
2873 using R1 = mp_fill&lt;L1, double&gt;; // std::tuple&lt;double, double, double&gt;</code></pre>
2874 </div>
2875 </div>
2876 <div class="listingblock">
2877 <div class="title">Code Example 59. Using mp_fill with std::pair</div>
2878 <div class="content">
2879 <pre class="highlight"><code>using L1 = std::pair&lt;int, float&gt;;
2880 using R1 = mp_fill&lt;L1, void&gt;; // std::pair&lt;void, void&gt;</code></pre>
2881 </div>
2882 </div>
2883 <table class="tableblock frame-all grid-all" style="width: 85%;">
2884 <caption class="title">Illustration 6. mp_fill</caption>
2885 <colgroup>
2886 <col style="width: 50%;">
2887 <col style="width: 12.5%;">
2888 <col style="width: 12.5%;">
2889 <col style="width: 12.5%;">
2890 <col style="width: 12.5%;">
2891 </colgroup>
2892 <tbody>
2893 <tr>
2894 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
2895 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
2896 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
2897 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2898 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
2899 </tr>
2900 <tr>
2901 <td class="tableblock halign-left valign-middle" colspan="5"></td>
2902 </tr>
2903 <tr>
2904 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_fill&lt;L1, V&gt;</strong></code></p></td>
2905 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>V</code></p></td>
2906 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>V</code></p></td>
2907 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
2908 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>V</code></p></td>
2909 </tr>
2910 </tbody>
2911 </table>
2912 </div>
2913 <div class="sect3">
2914 <h4 id="mp_countl_v">mp_count&lt;L, V&gt;</h4>
2915 <div class="literalblock">
2916 <div class="content">
2917 <pre>template&lt;class L, class V&gt; using mp_count = /*...*/;</pre>
2918 </div>
2919 </div>
2920 <div class="paragraph">
2921 <p><code>mp_count&lt;L, V&gt;</code> returns <code>mp_size_t&lt;N&gt;</code>, where <code>N</code> is the number of elements of <code>L</code> same as <code>V</code>.</p>
2922 </div>
2923 </div>
2924 <div class="sect3">
2925 <h4 id="mp_count_ifl_p">mp_count_if&lt;L, P&gt;</h4>
2926 <div class="literalblock">
2927 <div class="content">
2928 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_count_if = /*...*/;</pre>
2929 </div>
2930 </div>
2931 <div class="paragraph">
2932 <p><code>mp_count_if&lt;L, P&gt;</code> returns <code>mp_size_t&lt;N&gt;</code>, where <code>N</code> is the number of elements <code>T</code> of <code>L</code> for which <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code>.</p>
2933 </div>
2934 </div>
2935 <div class="sect3">
2936 <h4 id="mp_count_if_ql_q">mp_count_if_q&lt;L, Q&gt;</h4>
2937 <div class="literalblock">
2938 <div class="content">
2939 <pre>template&lt;class L, class Q&gt; using mp_count_if_q = mp_count_if&lt;L, Q::template fn&gt;;</pre>
2940 </div>
2941 </div>
2942 <div class="paragraph">
2943 <p>As <code>mp_count_if</code>, but takes a quoted metafunction.</p>
2944 </div>
2945 </div>
2946 <div class="sect3">
2947 <h4 id="mp_containsl_v">mp_contains&lt;L, V&gt;</h4>
2948 <div class="literalblock">
2949 <div class="content">
2950 <pre>template&lt;class L, class V&gt; using mp_contains = mp_to_bool&lt;mp_count&lt;L, V&gt;&gt;;</pre>
2951 </div>
2952 </div>
2953 <div class="paragraph">
2954 <p><code>mp_contains&lt;L, V&gt;</code> is <code>mp_true</code> when <code>L</code> contains an element <code>V</code>, <code>mp_false</code> otherwise.</p>
2955 </div>
2956 </div>
2957 <div class="sect3">
2958 <h4 id="mp_starts_withl1_l2">mp_starts_with&lt;L1, L2&gt;</h4>
2959 <div class="literalblock">
2960 <div class="content">
2961 <pre>template&lt;class L1, class L2&gt; using mp_starts_with = /*...*/;</pre>
2962 </div>
2963 </div>
2964 <div class="paragraph">
2965 <p><code>mp_starts_with&lt;L1, L2&gt;</code> is <code>mp_true</code> when <code>L1</code> starts with <code>L2</code>, <code>mp_false</code>
2966 otherwise.</p>
2967 </div>
2968 </div>
2969 <div class="sect3">
2970 <h4 id="mp_repeat_cl_n">mp_repeat_c&lt;L, N&gt;</h4>
2971 <div class="literalblock">
2972 <div class="content">
2973 <pre>template&lt;class L, std::size_t N&gt; using mp_repeat_c = /*...*/;</pre>
2974 </div>
2975 </div>
2976 <div class="paragraph">
2977 <p><code>mp_repeat_c&lt;L, N&gt;</code> returns a list of the same form as <code>L</code> that consists of <code>N</code> concatenated copies of <code>L</code>.</p>
2978 </div>
2979 <div class="listingblock">
2980 <div class="title">Code Example 60. Using mp_repeat_c</div>
2981 <div class="content">
2982 <pre class="highlight"><code>using L1 = tuple&lt;int&gt;;
2983 using R1 = mp_repeat_c&lt;L1, 3&gt;; // tuple&lt;int, int, int&gt;
2984
2985 using L2 = pair&lt;int, float&gt;;
2986 using R2 = mp_repeat_c&lt;L2, 1&gt;; // pair&lt;int, float&gt;
2987
2988 using L3 = mp_list&lt;int, float&gt;;
2989 using R3 = mp_repeat_c&lt;L3, 2&gt;; // mp_list&lt;int, float, int, float&gt;
2990
2991 using L4 = mp_list&lt;int, float, double&gt;;
2992 using R4 = mp_repeat_c&lt;L4, 0&gt;; // mp_list&lt;&gt;</code></pre>
2993 </div>
2994 </div>
2995 </div>
2996 <div class="sect3">
2997 <h4 id="mp_repeatl_n">mp_repeat&lt;L, N&gt;</h4>
2998 <div class="literalblock">
2999 <div class="content">
3000 <pre>template&lt;class L, class N&gt; using mp_repeat = /*...*/;</pre>
3001 </div>
3002 </div>
3003 <div class="paragraph">
3004 <p>Same as <code>mp_repeat_c</code> but with a type argument <code>N</code>. The number of copies is <code>N::value</code> and must be nonnegative.</p>
3005 </div>
3006 </div>
3007 <div class="sect3">
3008 <h4 id="mp_productf_l">mp_product&lt;F, L&#8230;&#8203;&gt;</h4>
3009 <div class="literalblock">
3010 <div class="content">
3011 <pre>template&lt;template&lt;class...&gt; class F, class... L&gt; using mp_product = /*...*/;</pre>
3012 </div>
3013 </div>
3014 <div class="paragraph">
3015 <p><code>mp_product&lt;F, L1&lt;T1&#8230;&#8203;&gt;, L2&lt;T2&#8230;&#8203;&gt;, &#8230;&#8203;, Ln&lt;Tn&#8230;&#8203;&gt;&gt;</code> evaluates <code>F&lt;U1, U2, &#8230;&#8203;, Un&gt;</code> for values <code>Ui</code> taken from
3016 the Cartesian product of the lists, as if the elements <code>Ui</code> are formed by <code>n</code> nested loops, each traversing <code>Li</code>.
3017 It returns a list of the form <code>L1&lt;V&#8230;&#8203;&gt;</code> containing the results of the application of <code>F</code>.</p>
3018 </div>
3019 <table class="tableblock frame-all grid-all" style="width: 85%;">
3020 <caption class="title">Illustration 7. mp_product on two lists</caption>
3021 <colgroup>
3022 <col style="width: 50%;">
3023 <col style="width: 12.5%;">
3024 <col style="width: 12.5%;">
3025 <col style="width: 12.5%;">
3026 <col style="width: 12.5%;">
3027 </colgroup>
3028 <tbody>
3029 <tr>
3030 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3031 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3032 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
3033 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3034 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3035 </tr>
3036 <tr>
3037 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3038 </tr>
3039 <tr>
3040 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L2</strong></code></p></td>
3041 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
3042 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
3043 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3044 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>m</sub></code></p></td>
3045 </tr>
3046 <tr>
3047 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3048 </tr>
3049 <tr>
3050 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_product&lt;F, L1, L2&gt;</strong></code></p></td>
3051 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>1</sub>,B<sub>1</sub>&gt;</code></p></td>
3052 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>1</sub>,B<sub>2</sub>&gt;</code></p></td>
3053 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3054 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>1</sub>,B<sub>m</sub>&gt;</code></p></td>
3055 </tr>
3056 <tr>
3057 <td class="tableblock halign-left valign-middle"></td>
3058 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>,B<sub>1</sub>&gt;</code></p></td>
3059 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>,B<sub>2</sub>&gt;</code></p></td>
3060 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3061 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>2</sub>,B<sub>m</sub>&gt;</code></p></td>
3062 </tr>
3063 <tr>
3064 <td class="tableblock halign-left valign-middle"></td>
3065 <td class="tableblock halign-center valign-middle" colspan="4"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3066 </tr>
3067 <tr>
3068 <td class="tableblock halign-left valign-middle"></td>
3069 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>n</sub>,B<sub>1</sub>&gt;</code></p></td>
3070 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>n</sub>,B<sub>2</sub>&gt;</code></p></td>
3071 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3072 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>F&lt;A<sub>n</sub>,B<sub>m</sub>&gt;</code></p></td>
3073 </tr>
3074 </tbody>
3075 </table>
3076 </div>
3077 <div class="sect3">
3078 <h4 id="mp_product_qq_l">mp_product_q&lt;Q, L&#8230;&#8203;&gt;</h4>
3079 <div class="literalblock">
3080 <div class="content">
3081 <pre>template&lt;class Q, class... L&gt; using mp_product_q = mp_product&lt;Q::template fn, L...&gt;;</pre>
3082 </div>
3083 </div>
3084 <div class="paragraph">
3085 <p>As <code>mp_product</code>, but takes a quoted metafunction.</p>
3086 </div>
3087 </div>
3088 <div class="sect3">
3089 <h4 id="mp_drop_cl_n">mp_drop_c&lt;L, N&gt;</h4>
3090 <div class="literalblock">
3091 <div class="content">
3092 <pre>template&lt;class L, std::size_t N&gt; using mp_drop_c = /*...*/;</pre>
3093 </div>
3094 </div>
3095 <div class="paragraph">
3096 <p><code>mp_drop_c&lt;L, N&gt;</code> removes the first <code>N</code> elements of <code>L</code> and returns the result.</p>
3097 </div>
3098 <table class="tableblock frame-all grid-all" style="width: 85%;">
3099 <caption class="title">Illustration 8. mp_drop_c</caption>
3100 <colgroup>
3101 <col style="width: 40%;">
3102 <col style="width: 10%;">
3103 <col style="width: 10%;">
3104 <col style="width: 10%;">
3105 <col style="width: 10%;">
3106 <col style="width: 10%;">
3107 <col style="width: 10%;">
3108 </colgroup>
3109 <tbody>
3110 <tr>
3111 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3112 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3113 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3114 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m</sub></code></p></td>
3115 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m+1</sub></code></p></td>
3116 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3117 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3118 </tr>
3119 <tr>
3120 <td class="tableblock halign-left valign-middle" colspan="7"></td>
3121 </tr>
3122 <tr>
3123 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_drop_c&lt;L1, M&gt;</strong></code></p></td>
3124 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m+1</sub></code></p></td>
3125 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3126 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3127 <td class="tableblock halign-center valign-middle" colspan="3"></td>
3128 </tr>
3129 </tbody>
3130 </table>
3131 </div>
3132 <div class="sect3">
3133 <h4 id="mp_dropl_n">mp_drop&lt;L, N&gt;</h4>
3134 <div class="literalblock">
3135 <div class="content">
3136 <pre>template&lt;class L, class N&gt; using mp_drop = /*...*/;</pre>
3137 </div>
3138 </div>
3139 <div class="paragraph">
3140 <p>Same as <code>mp_drop_c</code>, but with a type argument <code>N</code>. <code>N::value</code> must be a nonnegative number.</p>
3141 </div>
3142 </div>
3143 <div class="sect3">
3144 <h4 id="mp_from_sequences">mp_from_sequence&lt;S&gt;</h4>
3145 <div class="literalblock">
3146 <div class="content">
3147 <pre>template&lt;class S&gt; using mp_from_sequence = /*...*/</pre>
3148 </div>
3149 </div>
3150 <div class="paragraph">
3151 <p><code>mp_from_sequence</code> transforms an integer sequence produced by <code>make_integer_sequence</code> into an <code>mp_list</code>
3152 of the corresponding <code>std::integral_constant</code> types. Given</p>
3153 </div>
3154 <div class="literalblock">
3155 <div class="content">
3156 <pre>template&lt;class T, T... I&gt; struct S;</pre>
3157 </div>
3158 </div>
3159 <div class="paragraph">
3160 <p><code>mp_from_sequence&lt;S&lt;T, I&#8230;&#8203;&gt;&gt;</code> is an alias for <code>mp_list&lt;std::integral_constant&lt;T, I&gt;&#8230;&#8203;&gt;</code>.</p>
3161 </div>
3162 </div>
3163 <div class="sect3">
3164 <h4 id="mp_iota_cn">mp_iota_c&lt;N&gt;</h4>
3165 <div class="literalblock">
3166 <div class="content">
3167 <pre>template&lt;std::size_t N&gt; using mp_iota_c = /*...*/;</pre>
3168 </div>
3169 </div>
3170 <div class="paragraph">
3171 <p><code>mp_iota_c&lt;N&gt;</code> is an alias for <code>mp_list&lt;mp_size_t&lt;0&gt;, mp_size_t&lt;1&gt;, &#8230;&#8203;, mp_size_t&lt;N-1&gt;&gt;</code>.</p>
3172 </div>
3173 </div>
3174 <div class="sect3">
3175 <h4 id="mp_iotan">mp_iota&lt;N&gt;</h4>
3176 <div class="literalblock">
3177 <div class="content">
3178 <pre>template&lt;class N&gt; using mp_iota = /*...*/;</pre>
3179 </div>
3180 </div>
3181 <div class="paragraph">
3182 <p>Same as <code>mp_iota_c</code>, but with a type argument <code>N</code>. <code>N::value</code> must be a nonnegative number. Returns
3183 <code>mp_list&lt;std::integral_constant&lt;T, 0&gt;, std::integral_constant&lt;T, 1&gt;, &#8230;&#8203;, std::integral_constant&lt;T, N::value-1&gt;&gt;</code>
3184 where <code>T</code> is the type of <code>N::value</code>.</p>
3185 </div>
3186 <table class="tableblock frame-all grid-all" style="width: 85%;">
3187 <caption class="title">Illustration 9. mp_iota</caption>
3188 <colgroup>
3189 <col style="width: 50%;">
3190 <col style="width: 12.5%;">
3191 <col style="width: 12.5%;">
3192 <col style="width: 12.5%;">
3193 <col style="width: 12.5%;">
3194 </colgroup>
3195 <tbody>
3196 <tr>
3197 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_iota&lt;mp_int&lt;4&gt;&gt;</strong></code></p></td>
3198 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_int&lt;0&gt;</code></p></td>
3199 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_int&lt;1&gt;</code></p></td>
3200 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_int&lt;2&gt;</code></p></td>
3201 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_int&lt;3&gt;</code></p></td>
3202 </tr>
3203 </tbody>
3204 </table>
3205 </div>
3206 <div class="sect3">
3207 <h4 id="mp_at_cl_i">mp_at_c&lt;L, I&gt;</h4>
3208 <div class="literalblock">
3209 <div class="content">
3210 <pre>template&lt;class L, std::size_t I&gt; using mp_at_c = /*...*/;</pre>
3211 </div>
3212 </div>
3213 <div class="paragraph">
3214 <p><code>mp_at_c&lt;L, I&gt;</code> returns the <code>I</code>-th element of <code>L</code>, zero-based.</p>
3215 </div>
3216 </div>
3217 <div class="sect3">
3218 <h4 id="mp_atl_i">mp_at&lt;L, I&gt;</h4>
3219 <div class="literalblock">
3220 <div class="content">
3221 <pre>template&lt;class L, class I&gt; using mp_at = /*...*/;</pre>
3222 </div>
3223 </div>
3224 <div class="paragraph">
3225 <p>Same as <code>mp_at_c</code>, but with a type argument <code>I</code>. <code>I::value</code> must be a nonnegative number.</p>
3226 </div>
3227 </div>
3228 <div class="sect3">
3229 <h4 id="mp_take_cl_n">mp_take_c&lt;L, N&gt;</h4>
3230 <div class="literalblock">
3231 <div class="content">
3232 <pre>template&lt;class L, std::size_t N&gt; using mp_take_c = /*...*/;</pre>
3233 </div>
3234 </div>
3235 <div class="paragraph">
3236 <p><code>mp_take_c&lt;L, N&gt;</code> returns a list of the same form as <code>L</code> containing the first <code>N</code> elements of <code>L</code>.</p>
3237 </div>
3238 <table class="tableblock frame-all grid-all" style="width: 85%;">
3239 <caption class="title">Illustration 10. mp_take_c</caption>
3240 <colgroup>
3241 <col style="width: 40%;">
3242 <col style="width: 10%;">
3243 <col style="width: 10%;">
3244 <col style="width: 10%;">
3245 <col style="width: 10%;">
3246 <col style="width: 10%;">
3247 <col style="width: 10%;">
3248 </colgroup>
3249 <tbody>
3250 <tr>
3251 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3252 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3253 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3254 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m</sub></code></p></td>
3255 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m+1</sub></code></p></td>
3256 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3257 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3258 </tr>
3259 <tr>
3260 <td class="tableblock halign-left valign-middle" colspan="7"></td>
3261 </tr>
3262 <tr>
3263 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_take_c&lt;L1, M&gt;</strong></code></p></td>
3264 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3265 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3266 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m</sub></code></p></td>
3267 <td class="tableblock halign-center valign-middle" colspan="3"></td>
3268 </tr>
3269 </tbody>
3270 </table>
3271 </div>
3272 <div class="sect3">
3273 <h4 id="mp_takel_n">mp_take&lt;L, N&gt;</h4>
3274 <div class="literalblock">
3275 <div class="content">
3276 <pre>template&lt;class L, class N&gt; using mp_take = /*...*/;</pre>
3277 </div>
3278 </div>
3279 <div class="paragraph">
3280 <p>Same as <code>mp_take_c</code>, but with a type argument <code>N</code>. <code>N::value</code> must be a nonnegative number.</p>
3281 </div>
3282 </div>
3283 <div class="sect3">
3284 <h4 id="mp_backl">mp_back&lt;L&gt;</h4>
3285 <div class="literalblock">
3286 <div class="content">
3287 <pre>template&lt;class L&gt; using mp_back = mp_at_c&lt;L, mp_size&lt;L&gt;::value - 1&gt;;</pre>
3288 </div>
3289 </div>
3290 <div class="paragraph">
3291 <p><code>mp_back&lt;L&gt;</code> returns the last element of the list <code>L</code>.</p>
3292 </div>
3293 </div>
3294 <div class="sect3">
3295 <h4 id="mp_pop_backl">mp_pop_back&lt;L&gt;</h4>
3296 <div class="literalblock">
3297 <div class="content">
3298 <pre>template&lt;class L&gt; using mp_pop_back = mp_take_c&lt;L, mp_size&lt;L&gt;::value - 1&gt;;</pre>
3299 </div>
3300 </div>
3301 <div class="paragraph">
3302 <p><code>mp_pop_back&lt;L&gt;</code> removes the last element of the list <code>L</code> and returns the result.</p>
3303 </div>
3304 </div>
3305 <div class="sect3">
3306 <h4 id="mp_insert_cl_i_t">mp_insert_c&lt;L, I, T&#8230;&#8203;&gt;</h4>
3307 <div class="literalblock">
3308 <div class="content">
3309 <pre>template&lt;class L, std::size_t I, class... T&gt; using mp_insert_c =
3310     mp_append&lt;mp_take_c&lt;L, I&gt;, mp_push_front&lt;mp_drop_c&lt;L, I&gt;, T...&gt;&gt;;</pre>
3311 </div>
3312 </div>
3313 <div class="paragraph">
3314 <p>Inserts the elements <code>T&#8230;&#8203;</code> into the list <code>L</code> at position <code>I</code> (a zero-based index).</p>
3315 </div>
3316 <table class="tableblock frame-all grid-all" style="width: 85%;">
3317 <caption class="title">Illustration 11. mp_insert_c with two elements</caption>
3318 <colgroup>
3319 <col style="width: 33.3333%;">
3320 <col style="width: 8.3333%;">
3321 <col style="width: 8.3333%;">
3322 <col style="width: 8.3333%;">
3323 <col style="width: 8.3333%;">
3324 <col style="width: 8.3333%;">
3325 <col style="width: 8.3333%;">
3326 <col style="width: 8.3333%;">
3327 <col style="width: 8.3336%;">
3328 </colgroup>
3329 <tbody>
3330 <tr>
3331 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3332 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3333 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3334 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m</sub></code></p></td>
3335 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m+1</sub></code></p></td>
3336 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3337 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3338 <td class="tableblock halign-center valign-middle" colspan="2"></td>
3339 </tr>
3340 <tr>
3341 <td class="tableblock halign-left valign-middle" colspan="9"></td>
3342 </tr>
3343 <tr>
3344 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_insert_c&lt;L1, M, B<sub>1</sub>, B<sub>2</sub>&gt;</strong></code></p></td>
3345 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3346 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3347 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m</sub></code></p></td>
3348 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>1</sub></code></p></td>
3349 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>B<sub>2</sub></code></p></td>
3350 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>m+1</sub></code></p></td>
3351 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3352 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3353 </tr>
3354 </tbody>
3355 </table>
3356 </div>
3357 <div class="sect3">
3358 <h4 id="mp_insertl_i_t">mp_insert&lt;L, I, T&#8230;&#8203;&gt;</h4>
3359 <div class="literalblock">
3360 <div class="content">
3361 <pre>template&lt;class L, class I, class... T&gt; using mp_insert =
3362     mp_append&lt;mp_take&lt;L, I&gt;, mp_push_front&lt;mp_drop&lt;L, I&gt;, T...&gt;&gt;;</pre>
3363 </div>
3364 </div>
3365 <div class="paragraph">
3366 <p>Same as <code>mp_insert_c</code>, but with a type argument <code>I</code>.</p>
3367 </div>
3368 </div>
3369 <div class="sect3">
3370 <h4 id="mp_erase_cl_i_j">mp_erase_c&lt;L, I, J&gt;</h4>
3371 <div class="literalblock">
3372 <div class="content">
3373 <pre>template&lt;class L, std::size_t I, std::size_t J&gt; using mp_erase_c =
3374     mp_append&lt;mp_take_c&lt;L, I&gt;, mp_drop_c&lt;L, J&gt;&gt;;</pre>
3375 </div>
3376 </div>
3377 <div class="paragraph">
3378 <p>Removes from the list <code>L</code> the elements with indices from <code>I</code> (inclusive) to <code>J</code> (exclusive).</p>
3379 </div>
3380 <table class="tableblock frame-all grid-all" style="width: 85%;">
3381 <caption class="title">Illustration 12. mp_erase_c</caption>
3382 <colgroup>
3383 <col style="width: 30.7692%;">
3384 <col style="width: 7.6923%;">
3385 <col style="width: 7.6923%;">
3386 <col style="width: 7.6923%;">
3387 <col style="width: 7.6923%;">
3388 <col style="width: 7.6923%;">
3389 <col style="width: 7.6923%;">
3390 <col style="width: 7.6923%;">
3391 <col style="width: 7.6923%;">
3392 <col style="width: 7.6924%;">
3393 </colgroup>
3394 <tbody>
3395 <tr>
3396 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3397 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>0</sub></code></p></td>
3398 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3399 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>i-1</sub></code></p></td>
3400 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>i</sub></code></p></td>
3401 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3402 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>j-1</sub></code></p></td>
3403 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>j</sub></code></p></td>
3404 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3405 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n-1</sub></code></p></td>
3406 </tr>
3407 <tr>
3408 <td class="tableblock halign-left valign-middle" colspan="10"></td>
3409 </tr>
3410 <tr>
3411 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_erase_c&lt;L1, I, J&gt;</strong></code></p></td>
3412 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>0</sub></code></p></td>
3413 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3414 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>i-1</sub></code></p></td>
3415 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>j</sub></code></p></td>
3416 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3417 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n-1</sub></code></p></td>
3418 <td class="tableblock halign-center valign-middle" colspan="3"></td>
3419 </tr>
3420 </tbody>
3421 </table>
3422 </div>
3423 <div class="sect3">
3424 <h4 id="mp_erasel_i_j">mp_erase&lt;L, I, J&gt;</h4>
3425 <div class="literalblock">
3426 <div class="content">
3427 <pre>template&lt;class L, class I, class J&gt; using mp_erase =
3428     mp_append&lt;mp_take&lt;L, I&gt;, mp_drop&lt;L, J&gt;&gt;;</pre>
3429 </div>
3430 </div>
3431 <div class="paragraph">
3432 <p>Same as <code>mp_erase_c</code>, but with a type arguments <code>I</code> and <code>J</code>.</p>
3433 </div>
3434 </div>
3435 <div class="sect3">
3436 <h4 id="mp_replacel_v_w">mp_replace&lt;L, V, W&gt;</h4>
3437 <div class="literalblock">
3438 <div class="content">
3439 <pre>template&lt;class L, class V, class W&gt; using mp_replace = /*...*/;</pre>
3440 </div>
3441 </div>
3442 <div class="paragraph">
3443 <p>Replaces all <code>V</code> elements of <code>L</code> with <code>W</code> and returns the result.</p>
3444 </div>
3445 <table class="tableblock frame-all grid-all" style="width: 85%;">
3446 <caption class="title">Illustration 13. mp_replace</caption>
3447 <colgroup>
3448 <col style="width: 50%;">
3449 <col style="width: 12.5%;">
3450 <col style="width: 12.5%;">
3451 <col style="width: 12.5%;">
3452 <col style="width: 12.5%;">
3453 </colgroup>
3454 <tbody>
3455 <tr>
3456 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3457 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3458 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>V</code></p></td>
3459 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3460 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3461 </tr>
3462 <tr>
3463 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3464 </tr>
3465 <tr>
3466 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_replace&lt;L1, V, W&gt;</strong></code></p></td>
3467 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3468 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>W</code></p></td>
3469 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3470 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3471 </tr>
3472 </tbody>
3473 </table>
3474 </div>
3475 <div class="sect3">
3476 <h4 id="mp_replace_ifl_p_w">mp_replace_if&lt;L, P, W&gt;</h4>
3477 <div class="literalblock">
3478 <div class="content">
3479 <pre>template&lt;class L, template&lt;class...&gt; class P, class W&gt; using mp_replace_if = /*...*/;</pre>
3480 </div>
3481 </div>
3482 <div class="paragraph">
3483 <p>Replaces all <code>T</code> elements of <code>L</code> for which <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code> with <code>W</code> and returns the result.</p>
3484 </div>
3485 <table class="tableblock frame-all grid-all" style="width: 85%;">
3486 <caption class="title">Illustration 14. mp_replace_if</caption>
3487 <colgroup>
3488 <col style="width: 50%;">
3489 <col style="width: 12.5%;">
3490 <col style="width: 12.5%;">
3491 <col style="width: 12.5%;">
3492 <col style="width: 12.5%;">
3493 </colgroup>
3494 <tbody>
3495 <tr>
3496 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3497 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3498 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
3499 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3500 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3501 </tr>
3502 <tr>
3503 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3504 </tr>
3505 <tr>
3506 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>P&lt;A<sub>i</sub>&gt;</strong></code></p></td>
3507 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
3508 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_true</code></p></td>
3509 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3510 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>mp_false</code></p></td>
3511 </tr>
3512 <tr>
3513 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3514 </tr>
3515 <tr>
3516 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_replace_if&lt;L1, P, W&gt;</strong></code></p></td>
3517 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3518 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>W</code></p></td>
3519 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3520 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3521 </tr>
3522 </tbody>
3523 </table>
3524 </div>
3525 <div class="sect3">
3526 <h4 id="mp_replace_if_ql_q_w">mp_replace_if_q&lt;L, Q, W&gt;</h4>
3527 <div class="literalblock">
3528 <div class="content">
3529 <pre>template&lt;class L, class Q, class W&gt; using mp_replace_if_q =
3530     mp_replace_if&lt;L, Q::template fn, W&gt;;</pre>
3531 </div>
3532 </div>
3533 <div class="paragraph">
3534 <p>As <code>mp_replace_if</code>, but takes a quoted metafunction.</p>
3535 </div>
3536 </div>
3537 <div class="sect3">
3538 <h4 id="mp_replace_at_cl_i_w">mp_replace_at_c&lt;L, I, W&gt;</h4>
3539 <div class="literalblock">
3540 <div class="content">
3541 <pre>template&lt;class L, std::size_t I, class W&gt; using mp_replace_at_c = /*...*/;</pre>
3542 </div>
3543 </div>
3544 <div class="paragraph">
3545 <p>Replaces the element of <code>L</code> at zero-based index <code>I</code> with <code>W</code> and returns the result.</p>
3546 </div>
3547 </div>
3548 <div class="sect3">
3549 <h4 id="mp_replace_atl_i_w">mp_replace_at&lt;L, I, W&gt;</h4>
3550 <div class="literalblock">
3551 <div class="content">
3552 <pre>template&lt;class L, class I, class W&gt; using mp_replace_at = /*...*/;</pre>
3553 </div>
3554 </div>
3555 <div class="paragraph">
3556 <p>Same as <code>mp_replace_at_c</code>, but with a type argument <code>I</code>. <code>I::value</code> must be a nonnegative number.</p>
3557 </div>
3558 </div>
3559 <div class="sect3">
3560 <h4 id="mp_copy_ifl_p">mp_copy_if&lt;L, P&gt;</h4>
3561 <div class="literalblock">
3562 <div class="content">
3563 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_copy_if = /*...*/;</pre>
3564 </div>
3565 </div>
3566 <div class="paragraph">
3567 <p>Copies the elements <code>T</code> of <code>L</code> for which <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code> to a new list of the same form and returns it.</p>
3568 </div>
3569 </div>
3570 <div class="sect3">
3571 <h4 id="mp_copy_if_ql_q">mp_copy_if_q&lt;L, Q&gt;</h4>
3572 <div class="literalblock">
3573 <div class="content">
3574 <pre>template&lt;class L, class Q&gt; using mp_copy_if_q = mp_copy_if&lt;L, Q::template fn&gt;;</pre>
3575 </div>
3576 </div>
3577 <div class="paragraph">
3578 <p>As <code>mp_copy_if</code>, but takes a quoted metafunction.</p>
3579 </div>
3580 </div>
3581 <div class="sect3">
3582 <h4 id="mp_removel_v">mp_remove&lt;L, V&gt;</h4>
3583 <div class="literalblock">
3584 <div class="content">
3585 <pre>template&lt;class L, class V&gt; using mp_remove = /*...*/;</pre>
3586 </div>
3587 </div>
3588 <div class="paragraph">
3589 <p>Removes all <code>V</code> elements of <code>L</code> and returns the result.</p>
3590 </div>
3591 </div>
3592 <div class="sect3">
3593 <h4 id="mp_remove_ifl_p">mp_remove_if&lt;L, P&gt;</h4>
3594 <div class="literalblock">
3595 <div class="content">
3596 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_remove_if = /*...*/;</pre>
3597 </div>
3598 </div>
3599 <div class="paragraph">
3600 <p>Removes all elements <code>T</code> of <code>L</code> for which <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code> and returns the result.</p>
3601 </div>
3602 </div>
3603 <div class="sect3">
3604 <h4 id="mp_remove_if_ql_q">mp_remove_if_q&lt;L, Q&gt;</h4>
3605 <div class="literalblock">
3606 <div class="content">
3607 <pre>template&lt;class L, class Q&gt; using mp_remove_if_q = mp_remove_if&lt;L, Q::template fn&gt;;</pre>
3608 </div>
3609 </div>
3610 <div class="paragraph">
3611 <p>As <code>mp_remove_if</code>, but takes a quoted metafunction.</p>
3612 </div>
3613 </div>
3614 <div class="sect3">
3615 <h4 id="mp_partitionl_p">mp_partition&lt;L, P&gt;</h4>
3616 <div class="literalblock">
3617 <div class="content">
3618 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_partition = /*...*/;</pre>
3619 </div>
3620 </div>
3621 <div class="paragraph">
3622 <p><code>mp_partition&lt;L&lt;T&#8230;&#8203;&gt;, P&gt;</code> partitions <code>L</code> into two lists <code>L&lt;U1&#8230;&#8203;&gt;</code> and <code>L&lt;U2&#8230;&#8203;&gt;</code> such that <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code>
3623 for the elements of <code>L&lt;U1&#8230;&#8203;&gt;</code> and <code>mp_false</code> for the elements of <code>L&lt;U2&#8230;&#8203;&gt;</code>. Returns <code>L&lt;L&lt;U1&#8230;&#8203;&gt;, L&lt;U2&#8230;&#8203;&gt;&gt;</code>.</p>
3624 </div>
3625 </div>
3626 <div class="sect3">
3627 <h4 id="mp_partition_ql_q">mp_partition_q&lt;L, Q&gt;</h4>
3628 <div class="literalblock">
3629 <div class="content">
3630 <pre>template&lt;class L, class Q&gt; using mp_partition_q = mp_partition&lt;L, Q::template fn&gt;;</pre>
3631 </div>
3632 </div>
3633 <div class="paragraph">
3634 <p>As <code>mp_partition</code>, but takes a quoted metafunction.</p>
3635 </div>
3636 </div>
3637 <div class="sect3">
3638 <h4 id="mp_sortl_p">mp_sort&lt;L, P&gt;</h4>
3639 <div class="literalblock">
3640 <div class="content">
3641 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_sort = /*...*/;</pre>
3642 </div>
3643 </div>
3644 <div class="paragraph">
3645 <p><code>mp_sort&lt;L, P&gt;</code> sorts the list <code>L</code> according to the strict weak ordering <code>mp_to_bool&lt;P&lt;T, U&gt;&gt;</code>.</p>
3646 </div>
3647 <div class="listingblock">
3648 <div class="title">Code Example 61. Using mp_sort to sort a list of std::ratio values</div>
3649 <div class="content">
3650 <pre>#include &lt;ratio&gt;
3651
3652 using L1 = mp_list&lt;std::ratio&lt;1,2&gt;, std::ratio&lt;1,4&gt;&gt;;
3653 using R1 = mp_sort&lt;L1, std::ratio_less&gt;; // mp_list&lt;ratio&lt;1,4&gt;, ratio&lt;1,2&gt;&gt;</pre>
3654 </div>
3655 </div>
3656 </div>
3657 <div class="sect3">
3658 <h4 id="mp_sort_ql_q">mp_sort_q&lt;L, Q&gt;</h4>
3659 <div class="literalblock">
3660 <div class="content">
3661 <pre>template&lt;class L, class Q&gt; using mp_sort_q = mp_sort&lt;L, Q::template fn&gt;;</pre>
3662 </div>
3663 </div>
3664 <div class="paragraph">
3665 <p>As <code>mp_sort</code>, but takes a quoted metafunction.</p>
3666 </div>
3667 </div>
3668 <div class="sect3">
3669 <h4 id="mp_nth_element_cl_i_p">mp_nth_element_c&lt;L, I, P&gt;</h4>
3670 <div class="literalblock">
3671 <div class="content">
3672 <pre>template&lt;class L, std::size_t I, template&lt;class...&gt; class P&gt; using mp_nth_element_c =
3673     /*...*/;</pre>
3674 </div>
3675 </div>
3676 <div class="paragraph">
3677 <p>Returns the element at position <code>I</code> in <code>mp_sort&lt;L, P&gt;</code>.</p>
3678 </div>
3679 </div>
3680 <div class="sect3">
3681 <h4 id="mp_nth_elementl_i_p">mp_nth_element&lt;L, I, P&gt;</h4>
3682 <div class="literalblock">
3683 <div class="content">
3684 <pre>template&lt;class L, class I, template&lt;class...&gt; class P&gt; using mp_nth_element = /*...*/;</pre>
3685 </div>
3686 </div>
3687 <div class="paragraph">
3688 <p>Like <code>mp_nth_element_c</code>, but with a type argument <code>I</code>. <code>I::value</code> must be a nonnegative number.</p>
3689 </div>
3690 </div>
3691 <div class="sect3">
3692 <h4 id="mp_nth_element_ql_i_q">mp_nth_element_q&lt;L, I, Q&gt;</h4>
3693 <div class="literalblock">
3694 <div class="content">
3695 <pre>template&lt;class L, class I, class Q&gt; using mp_nth_element_q =
3696     mp_nth_element&lt;L, I, Q::template fn&gt;;</pre>
3697 </div>
3698 </div>
3699 <div class="paragraph">
3700 <p>Like <code>mp_nth_element</code>, but takes a quoted metafunction.</p>
3701 </div>
3702 </div>
3703 <div class="sect3">
3704 <h4 id="mp_min_elementl_p">mp_min_element&lt;L, P&gt;</h4>
3705 <div class="literalblock">
3706 <div class="content">
3707 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_min_element = /*...*/;</pre>
3708 </div>
3709 </div>
3710 <div class="paragraph">
3711 <p><code>mp_min_element&lt;L, P&gt;</code> returns the minimal element of the list <code>L</code> according to the ordering <code>mp_to_bool&lt;P&lt;T, U&gt;&gt;</code>.</p>
3712 </div>
3713 <div class="paragraph">
3714 <p>It&#8217;s equivalent to <code>mp_fold&lt;mp_rest&lt;L&gt;, mp_first&lt;L&gt;, F&gt;</code>, where <code>F&lt;T, U&gt;</code> returns <code>mp_if&lt;P&lt;T, U&gt;, T, U&gt;</code>.</p>
3715 </div>
3716 </div>
3717 <div class="sect3">
3718 <h4 id="mp_min_element_ql_q">mp_min_element_q&lt;L, Q&gt;</h4>
3719 <div class="literalblock">
3720 <div class="content">
3721 <pre>template&lt;class L, class Q&gt; using mp_min_element_q = mp_min_element&lt;L, Q::template fn&gt;;</pre>
3722 </div>
3723 </div>
3724 <div class="paragraph">
3725 <p>As <code>mp_min_element</code>, but takes a quoted metafunction.</p>
3726 </div>
3727 </div>
3728 <div class="sect3">
3729 <h4 id="mp_max_elementl_p">mp_max_element&lt;L, P&gt;</h4>
3730 <div class="literalblock">
3731 <div class="content">
3732 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_max_element = /*...*/;</pre>
3733 </div>
3734 </div>
3735 <div class="paragraph">
3736 <p><code>mp_max_element&lt;L, P&gt;</code> returns the maximal element of the list <code>L</code> according to the ordering <code>mp_to_bool&lt;P&lt;T, U&gt;&gt;</code>.</p>
3737 </div>
3738 <div class="paragraph">
3739 <p>It&#8217;s equivalent to <code>mp_fold&lt;mp_rest&lt;L&gt;, mp_first&lt;L&gt;, F&gt;</code>, where <code>F&lt;T, U&gt;</code> returns <code>mp_if&lt;P&lt;U, T&gt;, T, U&gt;</code>.</p>
3740 </div>
3741 </div>
3742 <div class="sect3">
3743 <h4 id="mp_max_element_ql_q">mp_max_element_q&lt;L, Q&gt;</h4>
3744 <div class="literalblock">
3745 <div class="content">
3746 <pre>template&lt;class L, class Q&gt; using mp_max_element_q = mp_max_element&lt;L, Q::template fn&gt;;</pre>
3747 </div>
3748 </div>
3749 <div class="paragraph">
3750 <p>As <code>mp_max_element</code>, but takes a quoted metafunction.</p>
3751 </div>
3752 </div>
3753 <div class="sect3">
3754 <h4 id="mp_findl_v">mp_find&lt;L, V&gt;</h4>
3755 <div class="literalblock">
3756 <div class="content">
3757 <pre>template&lt;class L, class V&gt; using mp_find = /*...*/;</pre>
3758 </div>
3759 </div>
3760 <div class="paragraph">
3761 <p><code>mp_find&lt;L, V&gt;</code> returns the index at which the type <code>V</code> is located in the list <code>L</code>. It&#8217;s an alias for <code>mp_size_t&lt;I&gt;</code>,
3762 where <code>I</code> is the zero-based index of the first occurrence of <code>V</code> in <code>L</code>. If <code>L</code> does not contain <code>V</code>, <code>mp_find&lt;L, V&gt;</code>
3763 is <code>mp_size&lt;L&gt;</code>.</p>
3764 </div>
3765 </div>
3766 <div class="sect3">
3767 <h4 id="mp_find_ifl_p">mp_find_if&lt;L, P&gt;</h4>
3768 <div class="literalblock">
3769 <div class="content">
3770 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_find_if = /*...*/;</pre>
3771 </div>
3772 </div>
3773 <div class="paragraph">
3774 <p><code>mp_find_f&lt;L, P&gt;</code> is an alias for <code>mp_size_t&lt;I&gt;</code>, where <code>I</code> is the zero-based index of the first element <code>T</code> in <code>L</code> for which
3775 <code>mp_to_bool&lt;P&lt;T&gt;&gt;</code> is <code>mp_true</code>. If there is no such element, <code>mp_find_if&lt;L, P&gt;</code> is <code>mp_size&lt;L&gt;</code>.</p>
3776 </div>
3777 </div>
3778 <div class="sect3">
3779 <h4 id="mp_find_if_ql_q">mp_find_if_q&lt;L, Q&gt;</h4>
3780 <div class="literalblock">
3781 <div class="content">
3782 <pre>template&lt;class L, class Q&gt; using mp_find_if_q = mp_find_if&lt;L, Q::template fn&gt;;</pre>
3783 </div>
3784 </div>
3785 <div class="paragraph">
3786 <p>As <code>mp_find_if</code>, but takes a quoted metafunction.</p>
3787 </div>
3788 </div>
3789 <div class="sect3">
3790 <h4 id="mp_reversel">mp_reverse&lt;L&gt;</h4>
3791 <div class="literalblock">
3792 <div class="content">
3793 <pre>template&lt;class L&gt; using mp_reverse = /*...*/;</pre>
3794 </div>
3795 </div>
3796 <div class="paragraph">
3797 <p><code>mp_reverse&lt;L&lt;T1, T2, &#8230;&#8203;, Tn&gt;&gt;</code> is <code>L&lt;Tn, &#8230;&#8203;, T2, T1&gt;</code>.</p>
3798 </div>
3799 <table class="tableblock frame-all grid-all" style="width: 85%;">
3800 <caption class="title">Illustration 15. mp_reverse</caption>
3801 <colgroup>
3802 <col style="width: 50%;">
3803 <col style="width: 12.5%;">
3804 <col style="width: 12.5%;">
3805 <col style="width: 12.5%;">
3806 <col style="width: 12.5%;">
3807 </colgroup>
3808 <tbody>
3809 <tr>
3810 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>L1</strong></code></p></td>
3811 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3812 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>2</sub></code></p></td>
3813 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3814 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3815 </tr>
3816 <tr>
3817 <td class="tableblock halign-left valign-middle" colspan="5"></td>
3818 </tr>
3819 <tr>
3820 <td class="tableblock halign-left valign-middle"><p class="tableblock"><code><strong>mp_reverse&lt;L1&gt;</strong></code></p></td>
3821 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n</sub></code></p></td>
3822 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>n-1</sub></code></p></td>
3823 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>&#8230;&#8203;</code></p></td>
3824 <td class="tableblock halign-center valign-middle"><p class="tableblock"><code>A<sub>1</sub></code></p></td>
3825 </tr>
3826 </tbody>
3827 </table>
3828 </div>
3829 <div class="sect3">
3830 <h4 id="mp_foldl_v_f">mp_fold&lt;L, V, F&gt;</h4>
3831 <div class="literalblock">
3832 <div class="content">
3833 <pre>template&lt;class L, class V, template&lt;class...&gt; class F&gt; using mp_fold = /*...*/;</pre>
3834 </div>
3835 </div>
3836 <div class="paragraph">
3837 <p><code>mp_fold&lt;L&lt;T1, T2, &#8230;&#8203;, Tn&gt;, V, F&gt;</code> is <code>F&lt; F&lt; F&lt; F&lt;V, T1&gt;, T2&gt;, &#8230;&#8203;&gt;, Tn&gt;</code>, or <code>V</code>, if <code>L</code> is empty.</p>
3838 </div>
3839 <div class="listingblock">
3840 <div class="title">Code Example 62. Using mp_fold to add the contents of a list of std::ratio values</div>
3841 <div class="content">
3842 <pre>#include &lt;ratio&gt;
3843
3844 using L1 = mp_list&lt;std::ratio&lt;1,8&gt;, std::ratio&lt;1,4&gt;, std::ratio&lt;1,2&gt;&gt;;
3845 using R1 = mp_fold&lt;L1, std::ratio&lt;0,1&gt;, std::ratio_add&gt;; // std::ratio&lt;7,8&gt;</pre>
3846 </div>
3847 </div>
3848 </div>
3849 <div class="sect3">
3850 <h4 id="mp_fold_ql_v_q">mp_fold_q&lt;L, V, Q&gt;</h4>
3851 <div class="literalblock">
3852 <div class="content">
3853 <pre>template&lt;class L, class V, class Q&gt; using mp_fold_q =
3854     mp_fold&lt;L, V, Q::template fn&gt;;</pre>
3855 </div>
3856 </div>
3857 <div class="paragraph">
3858 <p>As <code>mp_fold</code>, but takes a quoted metafunction.</p>
3859 </div>
3860 </div>
3861 <div class="sect3">
3862 <h4 id="mp_reverse_foldl_v_f">mp_reverse_fold&lt;L, V, F&gt;</h4>
3863 <div class="literalblock">
3864 <div class="content">
3865 <pre>template&lt;class L, class V, template&lt;class...&gt; class F&gt; using mp_reverse_fold =
3866     /*...*/;</pre>
3867 </div>
3868 </div>
3869 <div class="paragraph">
3870 <p><code>mp_reverse_fold&lt;L&lt;T1, T2, &#8230;&#8203;, Tn&gt;, V, F&gt;</code> is <code>F&lt;T1, F&lt;T2, F&lt;&#8230;&#8203;, F&lt;Tn, V&gt;&gt;&gt;&gt;</code>, or <code>V</code>, if <code>L</code> is empty.</p>
3871 </div>
3872 </div>
3873 <div class="sect3">
3874 <h4 id="mp_reverse_fold_ql_v_q">mp_reverse_fold_q&lt;L, V, Q&gt;</h4>
3875 <div class="literalblock">
3876 <div class="content">
3877 <pre>template&lt;class L, class V, class Q&gt; using mp_reverse_fold_q =
3878     mp_reverse_fold&lt;L, V, Q::template fn&gt;;</pre>
3879 </div>
3880 </div>
3881 <div class="paragraph">
3882 <p>As <code>mp_reverse_fold</code>, but takes a quoted metafunction.</p>
3883 </div>
3884 </div>
3885 <div class="sect3">
3886 <h4 id="mp_uniquel">mp_unique&lt;L&gt;</h4>
3887 <div class="literalblock">
3888 <div class="content">
3889 <pre>template&lt;class L&gt; using mp_unique = /*...*/;</pre>
3890 </div>
3891 </div>
3892 <div class="paragraph">
3893 <p><code>mp_unique&lt;L&gt;</code> returns a list of the same form as <code>L</code> with the duplicate elements removed.</p>
3894 </div>
3895 </div>
3896 <div class="sect3">
3897 <h4 id="mp_all_ofl_p">mp_all_of&lt;L, P&gt;</h4>
3898 <div class="literalblock">
3899 <div class="content">
3900 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_all_of =
3901     mp_bool&lt; mp_count_if&lt;L, P&gt;::value == mp_size&lt;L&gt;::value &gt;;</pre>
3902 </div>
3903 </div>
3904 <div class="paragraph">
3905 <p><code>mp_all_of&lt;L, P&gt;</code> is <code>mp_true</code> when <code>P</code> holds for all elements of <code>L</code>, <code>mp_false</code> otherwise. When <code>L</code> is empty, the result is <code>mp_true</code>.</p>
3906 </div>
3907 </div>
3908 <div class="sect3">
3909 <h4 id="mp_all_of_ql_q">mp_all_of_q&lt;L, Q&gt;</h4>
3910 <div class="literalblock">
3911 <div class="content">
3912 <pre>template&lt;class L, class Q&gt; using mp_all_of_q = mp_all_of&lt;L, Q::template fn&gt;;</pre>
3913 </div>
3914 </div>
3915 <div class="paragraph">
3916 <p>As <code>mp_all_of</code>, but takes a quoted metafunction.</p>
3917 </div>
3918 </div>
3919 <div class="sect3">
3920 <h4 id="mp_none_ofl_p">mp_none_of&lt;L, P&gt;</h4>
3921 <div class="literalblock">
3922 <div class="content">
3923 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_none_of =
3924     mp_bool&lt; mp_count_if&lt;L, P&gt;::value == 0 &gt;;</pre>
3925 </div>
3926 </div>
3927 <div class="paragraph">
3928 <p><code>mp_none_of&lt;L, P&gt;</code> is <code>mp_true</code> when <code>P</code> holds for no element of <code>L</code>, <code>mp_false</code> otherwise. When <code>L</code> is empty, the result is <code>mp_true</code>.</p>
3929 </div>
3930 </div>
3931 <div class="sect3">
3932 <h4 id="mp_none_of_ql_q">mp_none_of_q&lt;L, Q&gt;</h4>
3933 <div class="literalblock">
3934 <div class="content">
3935 <pre>template&lt;class L, class Q&gt; using mp_none_of_q = mp_none_of&lt;L, Q::template fn&gt;;</pre>
3936 </div>
3937 </div>
3938 <div class="paragraph">
3939 <p>As <code>mp_none_of</code>, but takes a quoted metafunction.</p>
3940 </div>
3941 </div>
3942 <div class="sect3">
3943 <h4 id="mp_any_ofl_p">mp_any_of&lt;L, P&gt;</h4>
3944 <div class="literalblock">
3945 <div class="content">
3946 <pre>template&lt;class L, template&lt;class...&gt; class P&gt; using mp_any_of =
3947     mp_bool&lt; mp_count_if&lt;L, P&gt;::value != 0 &gt;;</pre>
3948 </div>
3949 </div>
3950 <div class="paragraph">
3951 <p><code>mp_any_of&lt;L, P&gt;</code> is <code>mp_true</code> when <code>P</code> holds for at least one element of <code>L</code>, <code>mp_false</code> otherwise. When <code>L</code> is empty, the result is <code>mp_false</code>.</p>
3952 </div>
3953 </div>
3954 <div class="sect3">
3955 <h4 id="mp_any_of_ql_q">mp_any_of_q&lt;L, Q&gt;</h4>
3956 <div class="literalblock">
3957 <div class="content">
3958 <pre>template&lt;class L, class Q&gt; using mp_any_of_q = mp_any_of&lt;L, Q::template fn&gt;;</pre>
3959 </div>
3960 </div>
3961 <div class="paragraph">
3962 <p>As <code>mp_any_of</code>, but takes a quoted metafunction.</p>
3963 </div>
3964 </div>
3965 <div class="sect3">
3966 <h4 id="mp_for_eachlf">mp_for_each&lt;L&gt;(f)</h4>
3967 <div class="literalblock">
3968 <div class="content">
3969 <pre>template&lt;class L, class F&gt; constexpr F mp_for_each(F&amp;&amp; f);</pre>
3970 </div>
3971 </div>
3972 <div class="paragraph">
3973 <p><code>mp_for_each&lt;L&gt;(f)</code> calls <code>f</code> with <code>T()</code> for each element <code>T</code> of the list <code>L</code>, in order.</p>
3974 </div>
3975 <div class="paragraph">
3976 <p>Returns <code>std::forward&lt;F&gt;(f)</code>.</p>
3977 </div>
3978 <div class="listingblock">
3979 <div class="title">Code Example 63. Using mp_for_each and a C++14 lambda to print a tuple</div>
3980 <div class="content">
3981 <pre class="highlight"><code>template&lt;class... T&gt; void print( std::tuple&lt;T...&gt; const &amp; tp )
3982 {
3983     std::size_t const N = sizeof...(T);
3984
3985     mp_for_each&lt;mp_iota_c&lt;N&gt;&gt;( [&amp;]( auto I ){
3986
3987         // I is mp_size_t&lt;0&gt;, mp_size_t&lt;1&gt;, ..., mp_size_t&lt;N-1&gt;
3988
3989         std::cout &lt;&lt; std::get&lt;I&gt;(tp) &lt;&lt; std::endl;
3990
3991     });
3992 }</code></pre>
3993 </div>
3994 </div>
3995 </div>
3996 <div class="sect3">
3997 <h4 id="mp_with_indexni_f">mp_with_index&lt;N&gt;(i, f)</h4>
3998 <div class="literalblock">
3999 <div class="content">
4000 <pre>template&lt;std::size_t N, class F&gt;
4001   constexpr auto mp_with_index( std::size_t i, F &amp;&amp; f )
4002     -&gt; decltype(std::declval&lt;F&gt;()(std::declval&lt;mp_size_t&lt;0&gt;&gt;()));</pre>
4003 </div>
4004 </div>
4005 <div class="paragraph">
4006 <p><code>mp_with_index&lt;N&gt;(i, f)</code> calls <code>f</code> with <code>mp_size_t&lt;i&gt;()</code> and returns the result. <code>i</code> must be less than <code>N</code>.
4007 Only <code>constexpr</code> on C++14 and higher.</p>
4008 </div>
4009 <div class="literalblock">
4010 <div class="content">
4011 <pre>template&lt;class N, class F&gt;
4012   constexpr auto mp_with_index( std::size_t i, F &amp;&amp; f )
4013     -&gt; decltype(std::declval&lt;F&gt;()(std::declval&lt;mp_size_t&lt;0&gt;&gt;()));</pre>
4014 </div>
4015 </div>
4016 <div class="paragraph">
4017 <p>Returns <code>mp_with_index&lt;N::value&gt;(i, f)</code>.</p>
4018 </div>
4019 <div class="listingblock">
4020 <div class="title">Code Example 64. Using mp_with_index and a C++14 lambda to print the active element of a variant</div>
4021 <div class="content">
4022 <pre class="highlight"><code>template&lt;class... T&gt; void print( std::variant&lt;T...&gt; const&amp; v )
4023 {
4024     mp_with_index&lt;sizeof...(T)&gt;( v.index(), [&amp;]( auto I ) {
4025
4026         // I is mp_size_t&lt;v.index()&gt;{} here
4027
4028         std::cout &lt;&lt; std::get&lt;I&gt;( v ) &lt;&lt; std::endl;
4029
4030     });
4031 }</code></pre>
4032 </div>
4033 </div>
4034 </div>
4035 </div>
4036 <div class="sect2">
4037 <h3 id="set">Set Operations, &lt;boost/mp11/set.hpp&gt;</h3>
4038 <div class="paragraph">
4039 <p>A set is a list whose elements are unique.</p>
4040 </div>
4041 <div class="sect3">
4042 <h4 id="mp_is_sets">mp_is_set&lt;S&gt;</h4>
4043 <div class="literalblock">
4044 <div class="content">
4045 <pre>template&lt;class S&gt; using mp_is_set = /*...*/;</pre>
4046 </div>
4047 </div>
4048 <div class="paragraph">
4049 <p><code>mp_is_set&lt;S&gt;</code> is <code>mp_true</code> if <code>S</code> is a set, <code>mp_false</code> otherwise.</p>
4050 </div>
4051 </div>
4052 <div class="sect3">
4053 <h4 id="mp_set_containss_v">mp_set_contains&lt;S, V&gt;</h4>
4054 <div class="literalblock">
4055 <div class="content">
4056 <pre>template&lt;class S, class V&gt; using mp_set_contains = /*...*/;</pre>
4057 </div>
4058 </div>
4059 <div class="paragraph">
4060 <p><code>mp_set_contains&lt;S, V&gt;</code> is <code>mp_true</code> if the type <code>V</code> is an element of the set <code>S</code>, <code>mp_false</code> otherwise.</p>
4061 </div>
4062 </div>
4063 <div class="sect3">
4064 <h4 id="mp_set_push_backs_t">mp_set_push_back&lt;S, T&#8230;&#8203;&gt;</h4>
4065 <div class="literalblock">
4066 <div class="content">
4067 <pre>template&lt;class S, class... T&gt; using mp_set_push_back = /*...*/;</pre>
4068 </div>
4069 </div>
4070 <div class="paragraph">
4071 <p>For each <code>T1</code> in <code>T&#8230;&#8203;</code>, <code>mp_set_push_back&lt;S, T&#8230;&#8203;&gt;</code> appends <code>T1</code> to the end of the set <code>S</code> if it&#8217;s not already an element of <code>S</code>.</p>
4072 </div>
4073 </div>
4074 <div class="sect3">
4075 <h4 id="mp_set_push_fronts_t">mp_set_push_front&lt;S, T&#8230;&#8203;&gt;</h4>
4076 <div class="literalblock">
4077 <div class="content">
4078 <pre>template&lt;class S, class... T&gt; using mp_set_push_front = /*...*/;</pre>
4079 </div>
4080 </div>
4081 <div class="paragraph">
4082 <p><code>mp_set_push_front&lt;S, T&#8230;&#8203;&gt;</code> inserts at the front of the set <code>S</code> those elements of <code>T&#8230;&#8203;</code> for which <code>S</code> does not already contain the same type.</p>
4083 </div>
4084 </div>
4085 <div class="sect3">
4086 <h4 id="mp_set_unionl">mp_set_union&lt;L&#8230;&#8203;&gt;</h4>
4087 <div class="literalblock">
4088 <div class="content">
4089 <pre>template&lt;class... L&gt; using mp_set_union = /*...*/;</pre>
4090 </div>
4091 </div>
4092 <div class="paragraph">
4093 <p><code>mp_set_union&lt;S, L&#8230;&#8203;&gt;</code> is <code>mp_set_push_back&lt;S, T&#8230;&#8203;&gt;</code>, where <code>T&#8230;&#8203;</code> are the combined elements of the lists <code>L&#8230;&#8203;</code>.
4094 <code>mp_set_union&lt;&gt;</code> is <code>mp_list&lt;&gt;</code>.</p>
4095 </div>
4096 </div>
4097 <div class="sect3">
4098 <h4 id="mp_set_intersections">mp_set_intersection&lt;S&#8230;&#8203;&gt;</h4>
4099 <div class="literalblock">
4100 <div class="content">
4101 <pre>template&lt;class... S&gt; using mp_set_intersection = /*...*/;</pre>
4102 </div>
4103 </div>
4104 <div class="paragraph">
4105 <p><code>mp_set_intersection&lt;S&#8230;&#8203;&gt;</code> returns a set that contains the elements that occur in all of the sets <code>S&#8230;&#8203;</code>.
4106 <code>mp_set_intersection&lt;&gt;</code> is <code>mp_list&lt;&gt;</code>.</p>
4107 </div>
4108 </div>
4109 <div class="sect3">
4110 <h4 id="mp_set_differencel_s">mp_set_difference&lt;L, S&#8230;&#8203;&gt;</h4>
4111 <div class="literalblock">
4112 <div class="content">
4113 <pre>template&lt;class L, class... S&gt; using mp_set_difference = /*...*/;</pre>
4114 </div>
4115 </div>
4116 <div class="paragraph">
4117 <p><code>mp_set_difference&lt;L, S&#8230;&#8203;&gt;</code> removes the elements of the list <code>L</code> that appear in any of the sets <code>S&#8230;&#8203;</code> and
4118 returns the result.</p>
4119 </div>
4120 </div>
4121 </div>
4122 <div class="sect2">
4123 <h3 id="map">Map Operations, &lt;boost/mp11/map.hpp&gt;</h3>
4124 <div class="paragraph">
4125 <p>A map is a list of lists, the inner lists having at least one element (the key.) The keys of the map must be unique.</p>
4126 </div>
4127 <div class="sect3">
4128 <h4 id="mp_is_mapm">mp_is_map&lt;M&gt;</h4>
4129 <div class="literalblock">
4130 <div class="content">
4131 <pre>template&lt;class M&gt; using mp_is_map = /*...*/;</pre>
4132 </div>
4133 </div>
4134 <div class="paragraph">
4135 <p><code>mp_is_map&lt;M&gt;</code> is <code>mp_true</code> if <code>M</code> is a map, <code>mp_false</code> otherwise.</p>
4136 </div>
4137 </div>
4138 <div class="sect3">
4139 <h4 id="mp_map_findm_k">mp_map_find&lt;M, K&gt;</h4>
4140 <div class="literalblock">
4141 <div class="content">
4142 <pre>template&lt;class M, class K&gt; using mp_map_find = /*...*/;</pre>
4143 </div>
4144 </div>
4145 <div class="paragraph">
4146 <p><code>mp_map_find&lt;M, K&gt;</code> is an alias for the element of the map <code>M</code> with a key <code>K</code>, or for <code>void</code>, if there is no such element.</p>
4147 </div>
4148 </div>
4149 <div class="sect3">
4150 <h4 id="mp_map_containsm_k">mp_map_contains&lt;M, K&gt;</h4>
4151 <div class="literalblock">
4152 <div class="content">
4153 <pre>template&lt;class M, class K&gt; using mp_map_contains =
4154     mp_not&lt;std::is_same&lt;mp_map_find&lt;M, K&gt;, void&gt;&gt;;</pre>
4155 </div>
4156 </div>
4157 <div class="paragraph">
4158 <p><code>mp_map_contains&lt;M, K&gt;</code> is <code>mp_true</code> if the map <code>M</code> contains an element with a key <code>K</code>, <code>mp_false</code> otherwise.</p>
4159 </div>
4160 </div>
4161 <div class="sect3">
4162 <h4 id="mp_map_insertm_t">mp_map_insert&lt;M, T&gt;</h4>
4163 <div class="literalblock">
4164 <div class="content">
4165 <pre>template&lt;class M, class T&gt; using mp_map_insert =
4166     mp_if&lt; mp_map_contains&lt;M, mp_first&lt;T&gt;&gt;, M, mp_push_back&lt;M, T&gt; &gt;;</pre>
4167 </div>
4168 </div>
4169 <div class="paragraph">
4170 <p>Inserts the element <code>T</code> into the map <code>M</code>, if an element with a key <code>mp_first&lt;T&gt;</code> is not already in <code>M</code>.</p>
4171 </div>
4172 </div>
4173 <div class="sect3">
4174 <h4 id="mp_map_replacem_t">mp_map_replace&lt;M, T&gt;</h4>
4175 <div class="literalblock">
4176 <div class="content">
4177 <pre>template&lt;class M, class T&gt; using mp_map_replace = /*...*/;</pre>
4178 </div>
4179 </div>
4180 <div class="paragraph">
4181 <p>If the map <code>M</code> does not contain an element with a key <code>mp_first&lt;T&gt;</code>, inserts it (using <code>mp_push_back&lt;M, T&gt;</code>); otherwise,
4182 replaces the existing element with <code>T</code>.</p>
4183 </div>
4184 </div>
4185 <div class="sect3">
4186 <h4 id="mp_map_updatem_t_f">mp_map_update&lt;M, T, F&gt;</h4>
4187 <div class="literalblock">
4188 <div class="content">
4189 <pre>template&lt;class M, class T, template&lt;class...&gt; class F&gt; using mp_map_update = /*...*/;</pre>
4190 </div>
4191 </div>
4192 <div class="paragraph">
4193 <p>If the map <code>M</code> does not contain an element with a key <code>mp_first&lt;T&gt;</code>, inserts it (using <code>mp_push_back&lt;M, T&gt;</code>); otherwise,
4194 replaces the existing element <code>L&lt;X, Y&#8230;&#8203;&gt;</code> with <code>L&lt;X, F&lt;X, Y&#8230;&#8203;&gt;&gt;</code>.</p>
4195 </div>
4196 <div class="listingblock">
4197 <div class="title">Code Example 65. Using mp_map_update to count the number of occurrences of types in a list</div>
4198 <div class="content">
4199 <pre class="highlight"><code>template&lt;class T, class U&gt; using inc2nd = mp_int&lt;U::value + 1&gt;;
4200
4201 template&lt;class M, class T&gt; using count_types =
4202     mp_map_update&lt;M, std::pair&lt;T, mp_int&lt;1&gt;&gt;, inc2nd&gt;;
4203
4204 using L1 = mp_list&lt;float, char, float, float, float, float, char, float&gt;;
4205
4206 using R1 = mp_fold&lt;L1, std::tuple&lt;&gt;, count_types&gt;;
4207 // std::tuple&lt;std::pair&lt;float, mp_int&lt;6&gt;&gt;, std::pair&lt;char, mp_int&lt;2&gt;&gt;&gt;</code></pre>
4208 </div>
4209 </div>
4210 </div>
4211 <div class="sect3">
4212 <h4 id="mp_map_update_qm_t_q">mp_map_update_q&lt;M, T, Q&gt;</h4>
4213 <div class="literalblock">
4214 <div class="content">
4215 <pre>template&lt;class M, class T, class Q&gt; using mp_map_update_q =
4216     mp_map_update&lt;M, T, Q::template fn&gt;;</pre>
4217 </div>
4218 </div>
4219 <div class="paragraph">
4220 <p>As <code>mp_map_update</code>, but takes a quoted metafunction.</p>
4221 </div>
4222 </div>
4223 <div class="sect3">
4224 <h4 id="mp_map_erasem_k">mp_map_erase&lt;M, K&gt;</h4>
4225 <div class="literalblock">
4226 <div class="content">
4227 <pre>template&lt;class M, class K&gt; using mp_map_erase = /*...*/;</pre>
4228 </div>
4229 </div>
4230 <div class="paragraph">
4231 <p>If the map <code>M</code> contains an element with a key <code>K</code>, removes it.</p>
4232 </div>
4233 </div>
4234 <div class="sect3">
4235 <h4 id="mp_map_keysm">mp_map_keys&lt;M&gt;</h4>
4236 <div class="literalblock">
4237 <div class="content">
4238 <pre>template&lt;class M&gt; using mp_map_keys = mp_transform&lt;mp_first, M&gt;;</pre>
4239 </div>
4240 </div>
4241 <div class="paragraph">
4242 <p><code>mp_map_keys&lt;M&gt;</code> returns a list of the keys of <code>M</code>. When <code>M</code> is a valid map, the keys are unique, so the result is a set.</p>
4243 </div>
4244 </div>
4245 </div>
4246 <div class="sect2">
4247 <h3 id="function">Helper Metafunctions, &lt;boost/mp11/function.hpp&gt;</h3>
4248 <div class="sect3">
4249 <h4 id="mp_voidt">mp_void&lt;T&#8230;&#8203;&gt;</h4>
4250 <div class="literalblock">
4251 <div class="content">
4252 <pre>template&lt;class... T&gt; using mp_void = void;</pre>
4253 </div>
4254 </div>
4255 <div class="paragraph">
4256 <p>Same as <code>std::void_t</code> from C++17.</p>
4257 </div>
4258 </div>
4259 <div class="sect3">
4260 <h4 id="mp_andt">mp_and&lt;T&#8230;&#8203;&gt;</h4>
4261 <div class="literalblock">
4262 <div class="content">
4263 <pre>template&lt;class... T&gt; using mp_and = /*...*/;</pre>
4264 </div>
4265 </div>
4266 <div class="paragraph">
4267 <p><code>mp_and&lt;T&#8230;&#8203;&gt;</code> applies <code>mp_to_bool</code> to the types in <code>T&#8230;&#8203;</code>, in order. If the result of an application is <code>mp_false</code>, <code>mp_and</code>
4268 returns <code>mp_false</code>. If the application causes a substitution failure, returns <code>mp_false</code>. If all results are <code>mp_true</code>,
4269 returns <code>mp_true</code>. <code>mp_and&lt;&gt;</code> is <code>mp_true</code>.</p>
4270 </div>
4271 <div class="listingblock">
4272 <div class="title">Code Example 66. mp_and behavior</div>
4273 <div class="content">
4274 <pre class="highlight"><code>using R1 = mp_and&lt;mp_true, mp_true&gt;;   // mp_true
4275
4276 using R2 = mp_and&lt;mp_false, void&gt;;     // mp_false, void is not reached
4277
4278 using R3 = mp_and&lt;mp_false, mp_false&gt;; // mp_false
4279
4280 using R4 = mp_and&lt;void, mp_true&gt;;      // mp_false (!)</code></pre>
4281 </div>
4282 </div>
4283 </div>
4284 <div class="sect3">
4285 <h4 id="mp_allt">mp_all&lt;T&#8230;&#8203;&gt;</h4>
4286 <div class="literalblock">
4287 <div class="content">
4288 <pre>template&lt;class... T&gt; using mp_all = /*...*/;</pre>
4289 </div>
4290 </div>
4291 <div class="paragraph">
4292 <p><code>mp_all&lt;T&#8230;&#8203;&gt;</code> is <code>mp_true</code> if <code>mp_to_bool&lt;U&gt;</code> is <code>mp_true</code> for all types <code>U</code> in <code>T&#8230;&#8203;</code>, <code>mp_false</code> otherwise. Same as
4293 <code>mp_and</code>, but does not perform short-circuit evaluation. <code>mp_and&lt;mp_false, void&gt;</code> is <code>mp_false</code>, but <code>mp_all&lt;mp_false, void&gt;</code>
4294 is an error because <code>void</code> does not have a nested <code>value</code>. The upside is that <code>mp_all</code> is potentially faster and does not
4295 mask substitution failures as <code>mp_and</code> does.</p>
4296 </div>
4297 <div class="listingblock">
4298 <div class="title">Code Example 67. mp_all behavior</div>
4299 <div class="content">
4300 <pre class="highlight"><code>using R1 = mp_all&lt;mp_true, mp_true&gt;;   // mp_true
4301
4302 using R2 = mp_all&lt;mp_false, void&gt;;     // compile-time error
4303
4304 using R3 = mp_all&lt;mp_false, mp_false&gt;; // mp_false
4305
4306 using R4 = mp_all&lt;void, mp_true&gt;;      // compile-time error</code></pre>
4307 </div>
4308 </div>
4309 </div>
4310 <div class="sect3">
4311 <h4 id="mp_ort">mp_or&lt;T&#8230;&#8203;&gt;</h4>
4312 <div class="literalblock">
4313 <div class="content">
4314 <pre>template&lt;class... T&gt; using mp_or = /*...*/;</pre>
4315 </div>
4316 </div>
4317 <div class="paragraph">
4318 <p><code>mp_or&lt;T&#8230;&#8203;&gt;</code> applies <code>mp_to_bool</code> to the types in <code>T&#8230;&#8203;</code>, in order. If the result of an application is <code>mp_true</code>, <code>mp_or</code>
4319 returns <code>mp_true</code>. If all results are <code>mp_false</code>, returns <code>mp_false</code>. <code>mp_or&lt;&gt;</code> is <code>mp_false</code>.</p>
4320 </div>
4321 <div class="listingblock">
4322 <div class="title">Code Example 68. mp_or behavior</div>
4323 <div class="content">
4324 <pre class="highlight"><code>using R1 = mp_or&lt;mp_true, mp_false&gt;;   // mp_true
4325
4326 using R2 = mp_or&lt;mp_true, void&gt;;       // mp_true, void is not reached
4327
4328 using R3 = mp_or&lt;mp_false, mp_false&gt;;  // mp_false
4329
4330 using R4 = mp_or&lt;void, mp_true&gt;;       // compile-time error</code></pre>
4331 </div>
4332 </div>
4333 </div>
4334 <div class="sect3">
4335 <h4 id="mp_anyt">mp_any&lt;T&#8230;&#8203;&gt;</h4>
4336 <div class="literalblock">
4337 <div class="content">
4338 <pre>template&lt;class... T&gt; using mp_any = /*...*/;</pre>
4339 </div>
4340 </div>
4341 <div class="paragraph">
4342 <p><code>mp_any&lt;T&#8230;&#8203;&gt;</code> is <code>mp_true</code> if <code>mp_to_bool&lt;U&gt;</code> is <code>mp_true</code> for any type <code>U</code> in <code>T&#8230;&#8203;</code>, <code>mp_false</code> otherwise. Same as
4343 <code>mp_or</code>, but does not perform short-circuit evaluation.</p>
4344 </div>
4345 <div class="listingblock">
4346 <div class="title">Code Example 69. mp_any behavior</div>
4347 <div class="content">
4348 <pre class="highlight"><code>using R1 = mp_any&lt;mp_true, mp_false&gt;;  // mp_true
4349
4350 using R2 = mp_any&lt;mp_true, void&gt;;      // compile-time error
4351
4352 using R3 = mp_any&lt;mp_false, mp_false&gt;; // mp_false
4353
4354 using R4 = mp_any&lt;void, mp_true&gt;;      // compile-time error</code></pre>
4355 </div>
4356 </div>
4357 </div>
4358 <div class="sect3">
4359 <h4 id="mp_samet">mp_same&lt;T&#8230;&#8203;&gt;</h4>
4360 <div class="literalblock">
4361 <div class="content">
4362 <pre>template&lt;class... T&gt; using mp_same = /*...*/;</pre>
4363 </div>
4364 </div>
4365 <div class="paragraph">
4366 <p><code>mp_same&lt;T&#8230;&#8203;&gt;</code> is <code>mp_true</code> if all the types in <code>T&#8230;&#8203;</code> are the same type, <code>mp_false</code> otherwise. <code>mp_same&lt;&gt;</code> is <code>mp_true</code>.</p>
4367 </div>
4368 </div>
4369 <div class="sect3">
4370 <h4 id="mp_similart">mp_similar&lt;T&#8230;&#8203;&gt;</h4>
4371 <div class="literalblock">
4372 <div class="content">
4373 <pre>template&lt;class... T&gt; using mp_similar = /*...*/;</pre>
4374 </div>
4375 </div>
4376 <div class="paragraph">
4377 <p><code>mp_similar&lt;T&#8230;&#8203;&gt;</code> is <code>mp_true</code> if all the types in <code>T&#8230;&#8203;</code> are the same type, or instantiations of the same class template
4378 whose parameters are all types, <code>mp_false</code> otherwise. <code>mp_similar&lt;&gt;</code> is <code>mp_true</code>.</p>
4379 </div>
4380 <div class="listingblock">
4381 <div class="title">Code Example 70. mp_similar</div>
4382 <div class="content">
4383 <pre class="highlight"><code>using R1 = mp_similar&lt;void&gt;;                        // mp_true
4384 using R2 = mp_similar&lt;void, void&gt;;                  // mp_true
4385 using R3 = mp_similar&lt;void, void, void&gt;;            // mp_true
4386 using R4 = mp_similar&lt;void, void, float&gt;;           // mp_false
4387
4388 template&lt;class T&gt; struct X;
4389 template&lt;class... T&gt; struct Y;
4390
4391 using R5 = mp_similar&lt;X&lt;int&gt;, X&lt;void&gt;, X&lt;float&gt;&gt;;   // mp_true
4392 using R6 = mp_similar&lt;Y&lt;&gt;, Y&lt;void&gt;, Y&lt;void, void&gt;&gt;; // mp_true
4393 using R7 = mp_similar&lt;X&lt;void&gt;, Y&lt;void&gt;&gt;;            // mp_false</code></pre>
4394 </div>
4395 </div>
4396 </div>
4397 <div class="sect3">
4398 <h4 id="mp_plust">mp_plus&lt;T&#8230;&#8203;&gt;</h4>
4399 <div class="literalblock">
4400 <div class="content">
4401 <pre>template&lt;class... T&gt; using mp_plus = /*...*/;</pre>
4402 </div>
4403 </div>
4404 <div class="paragraph">
4405 <p><code>mp_plus&lt;T&#8230;&#8203;&gt;</code> is an integral constant type with a value that is the sum of <code>U::value</code> for all types <code>U</code> in <code>T&#8230;&#8203;</code>.
4406 <code>mp_plus&lt;&gt;</code> is <code>mp_int&lt;0&gt;</code>.</p>
4407 </div>
4408 </div>
4409 <div class="sect3">
4410 <h4 id="mp_lesst1_t2">mp_less&lt;T1, T2&gt;</h4>
4411 <div class="literalblock">
4412 <div class="content">
4413 <pre>template&lt;class T1, class T2&gt; using mp_less = /*...*/;</pre>
4414 </div>
4415 </div>
4416 <div class="paragraph">
4417 <p><code>mp_less&lt;T1, T2&gt;</code> is <code>mp_true</code> when the numeric value of <code>T1::value</code> is less than the numeric value of <code>T2::value</code>,
4418 <code>mp_false</code> otherwise.</p>
4419 </div>
4420 <div class="paragraph">
4421 <p>(Note that this is not necessarily the same as <code>T1::value &lt; T2::value</code> when comparing between signed and unsigned types;
4422 <code>-1 &lt; 1u</code> is <code>false</code>, but <code>mp_less&lt;mp_int&lt;-1&gt;, mp_size_t&lt;1&gt;&gt;</code> is <code>mp_true</code>.)</p>
4423 </div>
4424 </div>
4425 <div class="sect3">
4426 <h4 id="mp_mint1_t">mp_min&lt;T1, T&#8230;&#8203;&gt;</h4>
4427 <div class="literalblock">
4428 <div class="content">
4429 <pre>template&lt;class T1, class... T&gt; using mp_min = mp_min_element&lt;mp_list&lt;T1, T...&gt;, mp_less&gt;;</pre>
4430 </div>
4431 </div>
4432 <div class="paragraph">
4433 <p><code>mp_min&lt;T&#8230;&#8203;&gt;</code> returns the type <code>U</code> in <code>T&#8230;&#8203;</code> with the lowest <code>U::value</code>.</p>
4434 </div>
4435 </div>
4436 <div class="sect3">
4437 <h4 id="mp_maxt1_t">mp_max&lt;T1, T&#8230;&#8203;&gt;</h4>
4438 <div class="literalblock">
4439 <div class="content">
4440 <pre>template&lt;class T1, class... T&gt; using mp_max = mp_max_element&lt;mp_list&lt;T1, T...&gt;, mp_less&gt;;</pre>
4441 </div>
4442 </div>
4443 <div class="paragraph">
4444 <p><code>mp_max&lt;T&#8230;&#8203;&gt;</code> returns the type <code>U</code> in <code>T&#8230;&#8203;</code> with the highest <code>U::value</code>.</p>
4445 </div>
4446 </div>
4447 </div>
4448 <div class="sect2">
4449 <h3 id="bind">Bind, &lt;boost/mp11/bind.hpp&gt;</h3>
4450 <div class="sect3">
4451 <h4 id="mp_argi">mp_arg&lt;I&gt;</h4>
4452 <div class="literalblock">
4453 <div class="content">
4454 <pre>template&lt;std::size_t I&gt; struct mp_arg;</pre>
4455 </div>
4456 </div>
4457 <div class="paragraph">
4458 <p><code>mp_arg&lt;I&gt;</code> is a quoted metafunction whose nested template <code>fn&lt;T&#8230;&#8203;&gt;</code> returns the <code>I</code>-th zero-based element of <code>T&#8230;&#8203;</code>.</p>
4459 </div>
4460 </div>
4461 <div class="sect3">
4462 <h4 id="1_9">_1, &#8230;&#8203;, _9</h4>
4463 <div class="literalblock">
4464 <div class="content">
4465 <pre>using _1 = mp_arg&lt;0&gt;;
4466 using _2 = mp_arg&lt;1&gt;;
4467 using _3 = mp_arg&lt;2&gt;;
4468 using _4 = mp_arg&lt;3&gt;;
4469 using _5 = mp_arg&lt;4&gt;;
4470 using _6 = mp_arg&lt;5&gt;;
4471 using _7 = mp_arg&lt;6&gt;;
4472 using _8 = mp_arg&lt;7&gt;;
4473 using _9 = mp_arg&lt;8&gt;;</pre>
4474 </div>
4475 </div>
4476 <div class="paragraph">
4477 <p><code>_1</code> to <code>_9</code> are placeholder types, the equivalent to the placeholders of <code>boost::bind</code>.</p>
4478 </div>
4479 </div>
4480 <div class="sect3">
4481 <h4 id="mp_bindf_t">mp_bind&lt;F, T&#8230;&#8203;&gt;</h4>
4482 <div class="literalblock">
4483 <div class="content">
4484 <pre>template&lt;template&lt;class...&gt; class F, class... T&gt; struct mp_bind;</pre>
4485 </div>
4486 </div>
4487 <div class="paragraph">
4488 <p><code>mp_bind&lt;F, T&#8230;&#8203;&gt;</code> is a quoted metafunction that implements the type-based
4489 equivalent of <code>boost::bind</code>. Its nested template <code>fn&lt;U&#8230;&#8203;&gt;</code> returns <code>F&lt;V&#8230;&#8203;&gt;</code>,
4490 where <code>V&#8230;&#8203;</code> is <code>T&#8230;&#8203;</code> with the placeholders replaced by the corresponding
4491 element of <code>U&#8230;&#8203;</code> and the <code>mp_bind</code>, <code>mp_bind_front</code>, and <code>mp_bind_back</code>
4492 expressions replaced with their corresponding evaluations against <code>U&#8230;&#8203;</code>.</p>
4493 </div>
4494 <div class="paragraph">
4495 <p>For example, <code>mp_bind&lt;F, int, _2, mp_bind&lt;G, _1&gt;&gt;::fn&lt;float, void&gt;</code> is <code>F&lt;int, void, G&lt;float&gt;&gt;</code>.</p>
4496 </div>
4497 </div>
4498 <div class="sect3">
4499 <h4 id="mp_bind_qq_t">mp_bind_q&lt;Q, T&#8230;&#8203;&gt;</h4>
4500 <div class="literalblock">
4501 <div class="content">
4502 <pre>template&lt;class Q, class... T&gt; using mp_bind_q = mp_bind&lt;Q::template fn, T...&gt;;</pre>
4503 </div>
4504 </div>
4505 <div class="paragraph">
4506 <p>As <code>mp_bind</code>, but takes a quoted metafunction.</p>
4507 </div>
4508 </div>
4509 <div class="sect3">
4510 <h4 id="mp_bind_frontf_t">mp_bind_front&lt;F, T&#8230;&#8203;&gt;</h4>
4511 <div class="literalblock">
4512 <div class="content">
4513 <pre>template&lt;template&lt;class...&gt; class F, class... T&gt; struct mp_bind_front;</pre>
4514 </div>
4515 </div>
4516 <div class="paragraph">
4517 <p><code>mp_bind_front&lt;F, T&#8230;&#8203;&gt;</code> binds the leftmost arguments of <code>F</code> to <code>T&#8230;&#8203;</code>. Its nested template <code>fn&lt;U&#8230;&#8203;&gt;</code> returns <code>F&lt;T&#8230;&#8203;, U&#8230;&#8203;&gt;</code>.</p>
4518 </div>
4519 </div>
4520 <div class="sect3">
4521 <h4 id="mp_bind_front_qq_t">mp_bind_front_q&lt;Q, T&#8230;&#8203;&gt;</h4>
4522 <div class="literalblock">
4523 <div class="content">
4524 <pre>template&lt;class Q, class... T&gt; using mp_bind_front_q =
4525     mp_bind_front&lt;Q::template fn, T...&gt;;</pre>
4526 </div>
4527 </div>
4528 <div class="paragraph">
4529 <p>As <code>mp_bind_front</code>, but takes a quoted metafunction.</p>
4530 </div>
4531 </div>
4532 <div class="sect3">
4533 <h4 id="mp_bind_backf_t">mp_bind_back&lt;F, T&#8230;&#8203;&gt;</h4>
4534 <div class="literalblock">
4535 <div class="content">
4536 <pre>template&lt;template&lt;class...&gt; class F, class... T&gt; struct mp_bind_back;</pre>
4537 </div>
4538 </div>
4539 <div class="paragraph">
4540 <p><code>mp_bind_back&lt;F, T&#8230;&#8203;&gt;</code> binds the rightmost arguments of <code>F</code> to <code>T&#8230;&#8203;</code>. Its nested template <code>fn&lt;U&#8230;&#8203;&gt;</code> returns <code>F&lt;U&#8230;&#8203;, T&#8230;&#8203;&gt;</code>.</p>
4541 </div>
4542 </div>
4543 <div class="sect3">
4544 <h4 id="mp_bind_back_qq_t">mp_bind_back_q&lt;Q, T&#8230;&#8203;&gt;</h4>
4545 <div class="literalblock">
4546 <div class="content">
4547 <pre>template&lt;class Q, class... T&gt; using mp_bind_back_q =
4548     mp_bind_back&lt;Q::template fn, T...&gt;;</pre>
4549 </div>
4550 </div>
4551 <div class="paragraph">
4552 <p>As <code>mp_bind_back</code>, but takes a quoted metafunction.</p>
4553 </div>
4554 </div>
4555 </div>
4556 <div class="sect2">
4557 <h3 id="integer_sequence">Integer Sequences, &lt;boost/mp11/integer_sequence.hpp&gt;</h3>
4558 <div class="sect3">
4559 <h4 id="integer_sequencet_i">integer_sequence&lt;T, I&#8230;&#8203;&gt;</h4>
4560 <div class="literalblock">
4561 <div class="content">
4562 <pre>template&lt;class T, T... I&gt; struct integer_sequence
4563 {
4564 };</pre>
4565 </div>
4566 </div>
4567 <div class="paragraph">
4568 <p><code>integer_sequence&lt;T, I&#8230;&#8203;&gt;</code> holds a sequence of integers of type <code>T</code>. Same as C++14&#8217;s <code>std::integer_sequence</code>.</p>
4569 </div>
4570 </div>
4571 <div class="sect3">
4572 <h4 id="make_integer_sequencet_n">make_integer_sequence&lt;T, N&gt;</h4>
4573 <div class="literalblock">
4574 <div class="content">
4575 <pre>template&lt;class T, T N&gt; using make_integer_sequence = /*...*/;</pre>
4576 </div>
4577 </div>
4578 <div class="paragraph">
4579 <p><code>make_integer_sequence&lt;T, N&gt;</code> is <code>integer_sequence&lt;T, 0, 1, &#8230;&#8203;, N-1&gt;</code>. Same as C++14&#8217;s <code>std::make_integer_sequence</code>.</p>
4580 </div>
4581 </div>
4582 <div class="sect3">
4583 <h4 id="index_sequencei">index_sequence&lt;I&#8230;&#8203;&gt;</h4>
4584 <div class="literalblock">
4585 <div class="content">
4586 <pre>template&lt;std::size_t... I&gt; using index_sequence = integer_sequence&lt;std::size_t, I...&gt;;</pre>
4587 </div>
4588 </div>
4589 <div class="paragraph">
4590 <p><code>index_sequence&lt;I&#8230;&#8203;&gt;</code> is an alias for <code>integer_sequence&lt;size_t, I&#8230;&#8203;&gt;</code>. Same as C++14&#8217;s <code>std::index_sequence</code>.</p>
4591 </div>
4592 </div>
4593 <div class="sect3">
4594 <h4 id="make_index_sequencen">make_index_sequence&lt;N&gt;</h4>
4595 <div class="literalblock">
4596 <div class="content">
4597 <pre>template&lt;std::size_t N&gt; using make_index_sequence =
4598     make_integer_sequence&lt;std::size_t, N&gt;;</pre>
4599 </div>
4600 </div>
4601 <div class="paragraph">
4602 <p><code>make_index_sequence&lt;N&gt;</code> is <code>index_sequence&lt;0, 1, &#8230;&#8203;, N-1&gt;</code>. Same as C++14&#8217;s <code>std::make_index_sequence</code>.</p>
4603 </div>
4604 </div>
4605 <div class="sect3">
4606 <h4 id="index_sequence_fort">index_sequence_for&lt;T&#8230;&#8203;&gt;</h4>
4607 <div class="literalblock">
4608 <div class="content">
4609 <pre>template&lt;class... T&gt; using index_sequence_for =
4610     make_integer_sequence&lt;std::size_t, sizeof...(T)&gt;;</pre>
4611 </div>
4612 </div>
4613 <div class="paragraph">
4614 <p><code>index_sequence_for&lt;N&gt;</code> is <code>make_index_sequence&lt;sizeof&#8230;&#8203;(T)&gt;</code>. Same as C++14&#8217;s <code>std::index_sequence_for</code>.</p>
4615 </div>
4616 </div>
4617 </div>
4618 <div class="sect2">
4619 <h3 id="tuple">Tuple Operations, &lt;boost/mp11/tuple.hpp&gt;</h3>
4620 <div class="sect3">
4621 <h4 id="tuple_applyf_tp">tuple_apply(f, tp)</h4>
4622 <div class="literalblock">
4623 <div class="content">
4624 <pre>template&lt;class F, class Tp&gt; constexpr /*...*/ tuple_apply(F&amp;&amp; f, Tp&amp;&amp; tp);</pre>
4625 </div>
4626 </div>
4627 <div class="paragraph">
4628 <p><code>tuple_apply(f, tp)</code> returns <code>std::forward&lt;F&gt;(f)(std::get&lt;J&gt;(std::forward&lt;Tp&gt;(tp))&#8230;&#8203;)</code> for <code>J</code> in 0..<code>N-1</code>,
4629 where <code>N</code> is <code>std::tuple_size&lt;typename std::remove_reference&lt;Tp&gt;::type&gt;::value</code>. Same as <code>std::apply</code> in C++17.</p>
4630 </div>
4631 </div>
4632 <div class="sect3">
4633 <h4 id="construct_from_tuplettp">construct_from_tuple&lt;T&gt;(tp)</h4>
4634 <div class="literalblock">
4635 <div class="content">
4636 <pre>template&lt;class T, class Tp&gt; T construct_from_tuple(Tp&amp;&amp; tp);</pre>
4637 </div>
4638 </div>
4639 <div class="paragraph">
4640 <p><code>construct_from_tuple&lt;T&gt;(tp)</code> returns <code>T(std::get&lt;J&gt;(std::forward&lt;Tp&gt;(tp))&#8230;&#8203;)</code> for <code>J</code> in 0..<code>N-1</code>,
4641 where <code>N</code> is <code>std::tuple_size&lt;typename std::remove_reference&lt;Tp&gt;::type&gt;::value</code>. Same as <code>std::make_from_tuple</code> in C&#43;&#43;17.
4642 The name of the function doesn&#8217;t match the C&#43;&#43;17 one to avoid ambiguities when both are visible or in unqualified calls.</p>
4643 </div>
4644 </div>
4645 <div class="sect3">
4646 <h4 id="tuple_for_eachtp_f">tuple_for_each(tp, f)</h4>
4647 <div class="literalblock">
4648 <div class="content">
4649 <pre>template&lt;class Tp, class F&gt; constexpr F tuple_for_each(Tp&amp;&amp; tp, F&amp;&amp; f);</pre>
4650 </div>
4651 </div>
4652 <div class="paragraph">
4653 <p><code>tuple_for_each(tp, f)</code> applies the function object <code>f</code> to each element of <code>tp</code> by evaluating the
4654 expression <code>f(std::get&lt;J&gt;(std::forward&lt;Tp&gt;(tp)))</code> for <code>J</code> in 0..<code>N-1</code>, where <code>N</code> is <code>std::tuple_size&lt;typename std::remove_reference&lt;Tp&gt;::type&gt;::value</code>.</p>
4655 </div>
4656 <div class="paragraph">
4657 <p>Returns <code>std::forward&lt;F&gt;(f)</code>.</p>
4658 </div>
4659 </div>
4660 </div>
4661 <div class="sect2">
4662 <h3 id="mp11">Convenience Header, &lt;boost/mp11.hpp&gt;</h3>
4663 <div class="paragraph">
4664 <p>The convenience header <code>&lt;boost/mp11.hpp&gt;</code> includes all of the
4665 headers listed previously in this reference.</p>
4666 </div>
4667 </div>
4668 <div class="sect2">
4669 <h3 id="mpl">MPL Support, &lt;boost/mp11/mpl.hpp&gt;</h3>
4670 <div class="paragraph">
4671 <p>The header <code>&lt;boost/mp11/mpl.hpp&gt;</code>, when included, defines the
4672 necessary support infrastructure for <code>mp_list</code> and <code>std::tuple</code>
4673 to be valid <a href="../../../../libs/mpl">MPL</a> sequences.</p>
4674 </div>
4675 <div class="admonitionblock note">
4676 <table>
4677 <tr>
4678 <td class="icon">
4679 <div class="title">Note</div>
4680 </td>
4681 <td class="content">
4682 <code>mpl.hpp</code> is not included by <code>&lt;boost/mp11.hpp&gt;</code>.
4683 </td>
4684 </tr>
4685 </table>
4686 </div>
4687 <div class="paragraph">
4688 <p>It&#8217;s also possible to only enable support for <code>mp_list</code> by
4689 including <code>&lt;boost/mp11/mpl_list.hpp&gt;</code>, and for <code>std::tuple</code>
4690 by including <code>&lt;boost/mp11/mpl_tuple.hpp&gt;</code>. This may be required
4691 because some libraries, such as Boost.Fusion, contain their own MPL
4692 support for <code>std::tuple</code>, which conflicts with Mp11&#8217;s one.</p>
4693 </div>
4694 </div>
4695 </div>
4696 </div>
4697 <div class="sect1">
4698 <h2 id="copyright_license_and_acknowledgments">Appendix A: Copyright, License, and Acknowledgments</h2>
4699 <div class="sectionbody">
4700 <div class="paragraph">
4701 <p>This documentation is</p>
4702 </div>
4703 <div class="ulist">
4704 <ul>
4705 <li>
4706 <p>Copyright 2017-2019 Peter Dimov</p>
4707 </li>
4708 <li>
4709 <p>Copyright 2017 Bjørn Reese</p>
4710 </li>
4711 </ul>
4712 </div>
4713 <div class="paragraph">
4714 <p>and is distributed under the <a href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</p>
4715 </div>
4716 <div class="paragraph">
4717 <p>The "Simple C&#43;&#43;11 metaprogramming" articles have been graciously converted to Asciidoc format for incorporation
4718 into this documentation by Glen Fernandes.</p>
4719 </div>
4720 </div>
4721 </div>
4722 </div>
4723 <div id="footer">
4724 <div id="footer-text">
4725 Last updated 2019-12-10 00:19:27 UTC
4726 </div>
4727 </div>
4728 <style>
4729
4730 *:not(pre)>code { background: none; color: #600000; }
4731 :not(pre):not([class^=L])>code { background: none; color: #600000; }
4732 table tr.even, table tr.alt, table tr:nth-of-type(even) { background: none; }
4733
4734 </style>
4735 </body>
4736 </html>