expressions_reference.xml 133 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference id="expressions"><title>Expressions</title><header name="boost/log/expressions/attr.hpp">
  3. <para><para>Andrey Semashev </para>
  4. <para>21.07.2012</para>
  5. The header contains implementation of a generic attribute placeholder in template expressions. </para><namespace name="boost">
  6. <namespace name="log">
  7. <namespace name="expressions">
  8. <function name="attr"><type><classname>attribute_actor</classname>&lt; AttributeValueT &gt;</type><template>
  9. <template-type-parameter name="AttributeValueT"/>
  10. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will extract the value of the attribute with the specified name and type. </para></description></function>
  11. <function name="attr"><type><classname>attribute_actor</classname>&lt; AttributeValueT, fallback_to_none, TagT &gt;</type><template>
  12. <template-type-parameter name="AttributeValueT"/>
  13. <template-type-parameter name="TagT"/>
  14. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will extract the value of the attribute with the specified name and type. </para></description></function>
  15. </namespace>
  16. </namespace>
  17. </namespace>
  18. </header>
  19. <header name="boost/log/expressions/attr_fwd.hpp">
  20. <para><para>Andrey Semashev </para>
  21. <para>21.07.2012</para>
  22. The header contains forward declaration of a generic attribute placeholder in template expressions. </para><namespace name="boost">
  23. <namespace name="log">
  24. <namespace name="expressions">
  25. <class name="attribute_actor"><template>
  26. <template-type-parameter name="T"/>
  27. <template-type-parameter name="FallbackPolicyT"/>
  28. <template-type-parameter name="TagT"/>
  29. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  30. </template><inherit access="public">ActorT&lt; attribute_terminal&lt; T, FallbackPolicyT, TagT &gt; &gt;</inherit><description><para>An attribute value extraction terminal actor </para></description><method-group name="public member functions">
  31. <method name="get_name" cv="const"><type>attribute_name</type><description><para>
  32. </para></description><returns><para>The attribute name </para>
  33. </returns></method>
  34. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><description><para>
  35. </para></description><returns><para>Fallback policy </para>
  36. </returns></method>
  37. <method name="or_none" cv="const"><type>or_none_result_type</type><purpose>Generates an expression that extracts the attribute value or a default value. </purpose></method>
  38. <method name="or_throw" cv="const"><type>or_throw_result_type</type><purpose>Generates an expression that extracts the attribute value or throws an exception. </purpose></method>
  39. <method name="or_default" cv="const"><type><classname>attribute_actor</classname>&lt; value_type, fallback_to_default&lt; DefaultT &gt;, tag_type, ActorT &gt;</type><template>
  40. <template-type-parameter name="DefaultT"/>
  41. </template><parameter name="def_val"><paramtype>DefaultT const &amp;</paramtype></parameter><purpose>Generates an expression that extracts the attribute value or a default value. </purpose></method>
  42. </method-group>
  43. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  44. </class><class name="attribute_terminal"><template>
  45. <template-type-parameter name="T"/>
  46. <template-type-parameter name="FallbackPolicyT"/>
  47. <template-type-parameter name="TagT"/>
  48. </template><description><para>An attribute value extraction terminal </para></description><method-group name="public member functions">
  49. <method name="get_name" cv="const"><type>attribute_name</type><description><para>
  50. </para></description><returns><para>Attribute value name </para>
  51. </returns></method>
  52. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><description><para>
  53. </para></description><returns><para>Fallback policy </para>
  54. </returns></method>
  55. <method name="operator()"><type><classname>result</classname>&lt; <classname>this_type</classname>(ContextT const &amp;) &gt;::type</type><template>
  56. <template-type-parameter name="ContextT"/>
  57. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>The operator extracts attribute value </para></description></method>
  58. <method name="operator()" cv="const"><type><classname>result</classname>&lt; const <classname>this_type</classname>(ContextT const &amp;) &gt;::type</type><template>
  59. <template-type-parameter name="ContextT"/>
  60. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>The operator extracts attribute value </para></description></method>
  61. </method-group>
  62. <constructor specifiers="explicit"><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><description><para>Initializing constructor </para></description></constructor>
  63. <constructor><template>
  64. <template-type-parameter name="U"/>
  65. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="arg"><paramtype>U const &amp;</paramtype></parameter><description><para>Initializing constructor </para></description></constructor>
  66. <constructor cv="= delete"/>
  67. </class>
  68. </namespace>
  69. </namespace>
  70. </namespace>
  71. </header>
  72. <header name="boost/log/expressions/filter.hpp">
  73. <para><para>Andrey Semashev </para>
  74. <para>13.07.2012</para>
  75. The header contains a filter function object definition. </para><namespace name="boost">
  76. <namespace name="log">
  77. <class name="filter"><description><para>Log record filter function wrapper. </para></description><struct name="default_filter"><purpose>Default filter, always returns <computeroutput>true</computeroutput>. </purpose><typedef name="result_type"><type>bool</type></typedef>
  78. <method-group name="public member functions">
  79. <method name="operator()" cv="const"><type>result_type</type><parameter name=""><paramtype>attribute_value_set const &amp;</paramtype></parameter></method>
  80. </method-group>
  81. </struct><typedef name="result_type"><purpose>Result type. </purpose><type>bool</type></typedef>
  82. <method-group name="public member functions">
  83. <method name="operator()" cv="const"><type>result_type</type><parameter name="values"><paramtype>attribute_value_set const &amp;</paramtype><description><para>Attribute values of the log record. </para></description></parameter><description><para>Filtering operator.</para><para>
  84. </para></description><returns><para><computeroutput>true</computeroutput> if the log record passes the filter, <computeroutput>false</computeroutput> otherwise. </para>
  85. </returns></method>
  86. <method name="reset"><type>void</type><description><para>Resets the filter to the default. The default filter always returns <computeroutput>true</computeroutput>. </para></description></method>
  87. <method name="swap" cv="noexcept"><type>void</type><parameter name="that"><paramtype><classname>filter</classname> &amp;</paramtype></parameter><description><para>Swaps two filters </para></description></method>
  88. </method-group>
  89. <constructor><description><para>Default constructor. Creates a filter that always returns <computeroutput>true</computeroutput>. </para></description></constructor>
  90. <constructor><parameter name="that"><paramtype><classname>filter</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  91. <constructor cv="noexcept"><parameter name="that"><paramtype><classname>filter</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor. The moved-from filter is left in an unspecified state. </para></description></constructor>
  92. <constructor><template>
  93. <template-type-parameter name="FunT"/>
  94. </template><parameter name="fun"><paramtype>FunT &amp;&amp;</paramtype></parameter><description><para>Initializing constructor. Creates a filter which will invoke the specified function object. </para></description></constructor>
  95. <copy-assignment cv="noexcept"><type><classname>filter</classname> &amp;</type><parameter name="that"><paramtype><classname>filter</classname> &amp;&amp;</paramtype></parameter><description><para>Move assignment. The moved-from filter is left in an unspecified state. </para></description></copy-assignment>
  96. <copy-assignment><type><classname>filter</classname> &amp;</type><parameter name="that"><paramtype><classname>filter</classname> const &amp;</paramtype></parameter><description><para>Copy assignment. </para></description></copy-assignment>
  97. <copy-assignment><type><classname>filter</classname> &amp;</type><template>
  98. <template-type-parameter name="FunT"/>
  99. </template><parameter name="fun"><paramtype>FunT const &amp;</paramtype></parameter><description><para>Initializing assignment. Sets the specified function object to the filter. </para></description></copy-assignment>
  100. </class>
  101. <function name="swap"><type>void</type><parameter name="left"><paramtype><classname>filter</classname> &amp;</paramtype></parameter><parameter name="right"><paramtype><classname>filter</classname> &amp;</paramtype></parameter></function>
  102. </namespace>
  103. </namespace>
  104. </header>
  105. <header name="boost/log/expressions/formatter.hpp">
  106. <para><para>Andrey Semashev </para>
  107. <para>13.07.2012</para>
  108. The header contains a formatter function object definition. </para><namespace name="boost">
  109. <namespace name="log">
  110. <class name="basic_formatter"><template>
  111. <template-type-parameter name="CharT"/>
  112. </template><description><para>Log record formatter function wrapper. </para></description><typedef name="result_type"><purpose>Result type. </purpose><type>void</type></typedef>
  113. <typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  114. <typedef name="stream_type"><purpose>Output stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  115. <method-group name="public member functions">
  116. <method name="operator()" cv="const"><type>result_type</type><parameter name="rec"><paramtype>record_view const &amp;</paramtype><description><para>A log record to format. </para></description></parameter><parameter name="strm"><paramtype>stream_type &amp;</paramtype><description><para>A stream to put the formatted characters to. </para></description></parameter><description><para>Formatting operator.</para><para>
  117. </para></description></method>
  118. <method name="reset"><type>void</type><description><para>Resets the formatter to the default. The default formatter only outputs message text. </para></description></method>
  119. <method name="swap" cv="noexcept"><type>void</type><parameter name="that"><paramtype><classname>basic_formatter</classname> &amp;</paramtype></parameter><description><para>Swaps two formatters </para></description></method>
  120. </method-group>
  121. <constructor><description><para>Default constructor. Creates a formatter that only outputs log message. </para></description></constructor>
  122. <constructor><parameter name="that"><paramtype><classname>basic_formatter</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  123. <constructor cv="noexcept"><parameter name="that"><paramtype><classname>this_type</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor. The moved-from formatter is left in an unspecified state. </para></description></constructor>
  124. <constructor><template>
  125. <template-type-parameter name="FunT"/>
  126. </template><parameter name="fun"><paramtype>FunT &amp;&amp;</paramtype></parameter><description><para>Initializing constructor. Creates a formatter which will invoke the specified function object. </para></description></constructor>
  127. <copy-assignment cv="noexcept"><type><classname>basic_formatter</classname> &amp;</type><parameter name="that"><paramtype><classname>this_type</classname> &amp;&amp;</paramtype></parameter><description><para>Move assignment. The moved-from formatter is left in an unspecified state. </para></description></copy-assignment>
  128. <copy-assignment><type><classname>basic_formatter</classname> &amp;</type><parameter name="that"><paramtype><classname>this_type</classname> const &amp;</paramtype></parameter><description><para>Copy assignment. </para></description></copy-assignment>
  129. <copy-assignment><type><classname>basic_formatter</classname> &amp;</type><template>
  130. <template-type-parameter name="FunT"/>
  131. </template><parameter name="fun"><paramtype>FunT &amp;&amp;</paramtype></parameter><description><para>Initializing assignment. Sets the specified function object to the formatter. </para></description></copy-assignment>
  132. </class><namespace name="expressions">
  133. </namespace>
  134. <typedef name="formatter"><type><classname>basic_formatter</classname>&lt; char &gt;</type></typedef>
  135. <typedef name="wformatter"><type><classname>basic_formatter</classname>&lt; wchar_t &gt;</type></typedef>
  136. <function name="swap"><type>void</type><template>
  137. <template-type-parameter name="CharT"/>
  138. </template><parameter name="left"><paramtype><classname>basic_formatter</classname>&lt; CharT &gt; &amp;</paramtype></parameter><parameter name="right"><paramtype><classname>basic_formatter</classname>&lt; CharT &gt; &amp;</paramtype></parameter></function>
  139. </namespace>
  140. </namespace>
  141. </header>
  142. <header name="boost/log/expressions/formatters.hpp">
  143. <para><para>Andrey Semashev </para>
  144. <para>10.11.2012</para>
  145. The header includes all template expression formatters. </para></header>
  146. <header name="boost/log/expressions/formatters/auto_newline.hpp">
  147. <para><para>Andrey Semashev </para>
  148. <para>23.06.2019</para>
  149. The header contains implementation of formatter for inserting a newline, unless there is already one inserted. </para><namespace name="boost">
  150. <namespace name="log">
  151. <namespace name="expressions">
  152. </namespace>
  153. </namespace>
  154. </namespace>
  155. </header>
  156. <header name="boost/log/expressions/formatters/c_decorator.hpp">
  157. <para><para>Andrey Semashev </para>
  158. <para>18.11.2012</para>
  159. The header contains implementation of C-style character decorators. </para><namespace name="boost">
  160. <namespace name="log">
  161. <namespace name="expressions">
  162. <class name="c_ascii_pattern_replacer"><template>
  163. <template-type-parameter name="CharT"/>
  164. </template><inherit access="public">boost::log::expressions::pattern_replacer&lt; CharT &gt;</inherit><description><para>A character decorator implementation that escapes all non-prontable and non-ASCII characters in the output with C-style escape sequences. </para></description><typedef name="result_type"><purpose>Result type. </purpose><type>base_type::result_type</type></typedef>
  165. <typedef name="char_type"><purpose>Character type. </purpose><type>base_type::char_type</type></typedef>
  166. <typedef name="string_type"><purpose>String type. </purpose><type>base_type::string_type</type></typedef>
  167. <method-group name="public member functions">
  168. <method name="operator()" cv="const"><type>result_type</type><parameter name="str"><paramtype>string_type &amp;</paramtype></parameter><parameter name="start_pos"><paramtype>typename string_type::size_type</paramtype><default>0</default></parameter><purpose>Applies string replacements starting from the specified position. </purpose></method>
  169. </method-group>
  170. <constructor><purpose>Default constructor. </purpose></constructor>
  171. </class><data-member name="c_decor"><type><emphasis>unspecified</emphasis></type><description><para>C-style decorator generator object. The decorator replaces characters with specific meaning in C language with the corresponding escape sequences. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator. For example:</para><para><computeroutput> c_decor[ stream &lt;&lt; attr&lt; std::string &gt;("MyAttr") ] </computeroutput></para><para>For wide-character formatting there is the similar <computeroutput>wc_decor</computeroutput> decorator generator object. </para></description></data-member>
  172. <data-member name="wc_decor"><type><emphasis>unspecified</emphasis></type></data-member>
  173. <data-member name="c_ascii_decor"><type><emphasis>unspecified</emphasis></type><description><para>C-style decorator generator object. Acts similarly to <computeroutput>c_decor</computeroutput>, except that <computeroutput>c_ascii_decor</computeroutput> also converts all non-ASCII and non-printable ASCII characters, except for space character, into C-style hexadecimal escape sequences. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator. For example:</para><para><computeroutput> c_ascii_decor[ stream &lt;&lt; attr&lt; std::string &gt;("MyAttr") ] </computeroutput></para><para>For wide-character formatting there is the similar <computeroutput>wc_ascii_decor</computeroutput> decorator generator object. </para></description></data-member>
  174. <data-member name="wc_ascii_decor"><type><emphasis>unspecified</emphasis></type></data-member>
  175. <function name="make_c_decor"><type><emphasis>unspecified</emphasis></type><template>
  176. <template-type-parameter name="CharT"/>
  177. </template><description><para>The function creates a C-style decorator generator for arbitrary character type. </para></description></function>
  178. <function name="make_c_ascii_decor"><type><emphasis>unspecified</emphasis></type><template>
  179. <template-type-parameter name="CharT"/>
  180. </template><description><para>The function creates a C-style decorator generator for arbitrary character type. </para></description></function>
  181. </namespace>
  182. </namespace>
  183. </namespace>
  184. </header>
  185. <header name="boost/log/expressions/formatters/char_decorator.hpp">
  186. <para><para>Andrey Semashev </para>
  187. <para>17.11.2012</para>
  188. The header contains implementation of a character decorator. </para><namespace name="boost">
  189. <namespace name="log">
  190. <namespace name="expressions">
  191. <class name="char_decorator_actor"><template>
  192. <template-type-parameter name="SubactorT"/>
  193. <template-type-parameter name="ImplT"/>
  194. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  195. </template><inherit access="public">ActorT&lt; char_decorator_terminal&lt; SubactorT, ImplT &gt; &gt;</inherit><description><para>Character decorator actor </para></description><typedef name="terminal_type"><purpose>Base terminal type. </purpose><type><classname>char_decorator_terminal</classname>&lt; SubactorT, ImplT &gt;</type></typedef>
  196. <typedef name="char_type"><purpose>Character type. </purpose><type>terminal_type::char_type</type></typedef>
  197. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  198. <method-group name="public member functions">
  199. <method name="get_terminal" cv="const"><type>terminal_type const &amp;</type><purpose>Returns reference to the terminal. </purpose></method>
  200. </method-group>
  201. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  202. </class><class name="char_decorator_terminal"><template>
  203. <template-type-parameter name="SubactorT"/>
  204. <template-type-parameter name="ImplT"/>
  205. </template><description><para>Character decorator terminal class. This formatter allows to modify strings generated by other formatters on character level. The most obvious application of decorators is replacing a certain set of characters with decorated equivalents to satisfy requirements of text-based sinks.</para><para>The <computeroutput><classname alt="boost::log::expressions::char_decorator_terminal">char_decorator_terminal</classname></computeroutput> class aggregates the formatter being decorated, and a set of string pairs that are used as decorations. All decorations are applied sequentially. The <computeroutput><classname alt="boost::log::expressions::char_decorator_terminal">char_decorator_terminal</classname></computeroutput> class is a formatter itself, so it can be used to construct more complex formatters, including nesting decorators. </para></description><typedef name="impl_type"><purpose>Implementation type. </purpose><type>ImplT</type></typedef>
  206. <typedef name="char_type"><purpose>Character type. </purpose><type>impl_type::char_type</type></typedef>
  207. <typedef name="string_type"><purpose>String type. </purpose><type>impl_type::string_type</type></typedef>
  208. <typedef name="stream_type"><purpose>Stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  209. <typedef name="subactor_type"><purpose>Adopted actor type. </purpose><type>SubactorT</type></typedef>
  210. <typedef name="result_type"><purpose>Result type definition. </purpose><type>string_type</type></typedef>
  211. <method-group name="public member functions">
  212. <method name="get_subactor" cv="const"><type>subactor_type const &amp;</type><description><para>
  213. </para></description><returns><para>Adopted subactor </para>
  214. </returns></method>
  215. <method name="get_impl" cv="const"><type>impl_type const &amp;</type><description><para>
  216. </para></description><returns><para>Implementation </para>
  217. </returns></method>
  218. <method name="operator()"><type>result_type</type><template>
  219. <template-type-parameter name="ContextT"/>
  220. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>Invokation operator </para></description></method>
  221. <method name="operator()" cv="const"><type>result_type</type><template>
  222. <template-type-parameter name="ContextT"/>
  223. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>Invokation operator </para></description></method>
  224. </method-group>
  225. <constructor><parameter name="sub"><paramtype>subactor_type const &amp;</paramtype></parameter><parameter name="impl"><paramtype>impl_type const &amp;</paramtype></parameter><description><para>Initializing constructor. </para></description></constructor>
  226. <constructor><parameter name="that"><paramtype><classname>char_decorator_terminal</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  227. <constructor cv="= delete"/>
  228. </class><class name="pattern_replacer"><template>
  229. <template-type-parameter name="CharT"/>
  230. </template><description><para>A simple character decorator implementation. This implementation replaces string patterns in the source string with the fixed replacements. Source patterns and replacements can be specified at the object construction. </para></description><struct name="string_lengths"><purpose>Lengths of source pattern and replacement. </purpose><data-member name="from_len"><type>unsigned int</type></data-member>
  231. <data-member name="to_len"><type>unsigned int</type></data-member>
  232. </struct><typedef name="result_type"><purpose>Result type. </purpose><type>void</type></typedef>
  233. <typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  234. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  235. <method-group name="public member functions">
  236. <method name="operator()" cv="const"><type>result_type</type><parameter name="str"><paramtype>string_type &amp;</paramtype></parameter><parameter name="start_pos"><paramtype>typename string_type::size_type</paramtype><default>0</default></parameter><purpose>Applies string replacements starting from the specified position. </purpose></method>
  237. </method-group>
  238. <constructor specifiers="explicit"><template>
  239. <template-type-parameter name="RangeT"/>
  240. </template><parameter name="decorations"><paramtype>RangeT const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates a pattern replacer with the specified <emphasis>decorations</emphasis>. The provided decorations must be a sequence of <computeroutput>std::pair</computeroutput> of strings. The first element of each pair is the source pattern, and the second one is the corresponding replacement. </para></description></constructor>
  241. <constructor><template>
  242. <template-type-parameter name="FromRangeT"/>
  243. <template-type-parameter name="ToRangeT"/>
  244. </template><parameter name="from"><paramtype>FromRangeT const &amp;</paramtype></parameter><parameter name="to"><paramtype>ToRangeT const &amp;</paramtype></parameter><description><para>Initializing constructor. Creates a pattern replacer with decorations specified in form of two same-sized string sequences. Each <computeroutput>i</computeroutput>'th decoration will be <computeroutput>from[i]</computeroutput> -&gt; <computeroutput>to[i]</computeroutput>. </para></description></constructor>
  245. <constructor><parameter name="that"><paramtype><classname>pattern_replacer</classname> const &amp;</paramtype></parameter><purpose>Copy constructor. </purpose></constructor>
  246. <method-group name="private static functions">
  247. <method name="string_begin" specifiers="static"><type>char_type *</type><parameter name="p"><paramtype>char_type *</paramtype></parameter></method>
  248. <method name="string_begin" specifiers="static"><type>const char_type *</type><parameter name="p"><paramtype>const char_type *</paramtype></parameter></method>
  249. <method name="string_begin" specifiers="static"><type>range_const_iterator&lt; RangeT &gt;::type</type><template>
  250. <template-type-parameter name="RangeT"/>
  251. </template><parameter name="r"><paramtype>RangeT const &amp;</paramtype></parameter></method>
  252. <method name="string_end" specifiers="static"><type>char_type *</type><parameter name="p"><paramtype>char_type *</paramtype></parameter></method>
  253. <method name="string_end" specifiers="static"><type>const char_type *</type><parameter name="p"><paramtype>const char_type *</paramtype></parameter></method>
  254. <method name="string_end" specifiers="static"><type>range_const_iterator&lt; RangeT &gt;::type</type><template>
  255. <template-type-parameter name="RangeT"/>
  256. </template><parameter name="r"><paramtype>RangeT const &amp;</paramtype></parameter></method>
  257. </method-group>
  258. </class>
  259. <function name="char_decor"><type><emphasis>unspecified</emphasis></type><template>
  260. <template-type-parameter name="RangeT"/>
  261. </template><parameter name="decorations"><paramtype>RangeT const &amp;</paramtype><description><para>A sequence of string pairs that will be used as decorations. Every <computeroutput>decorations[i].first</computeroutput> substring occurrence in the output will be replaced with <computeroutput>decorations[i].second</computeroutput>. </para></description></parameter><description><para>The function returns a decorator generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator.</para><para>
  262. </para></description></function>
  263. <function name="char_decor"><type><emphasis>unspecified</emphasis></type><template>
  264. <template-type-parameter name="FromRangeT"/>
  265. <template-type-parameter name="ToRangeT"/>
  266. </template><parameter name="from"><paramtype>FromRangeT const &amp;</paramtype><description><para>A sequence of strings that will be sought in the output. </para></description></parameter><parameter name="to"><paramtype>ToRangeT const &amp;</paramtype><description><para>A sequence of strings that will be used as replacements.</para></description></parameter><description><para>The function returns a decorator generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator.</para><para>
  267. <note><para>The <emphasis>from</emphasis> and <emphasis>to</emphasis> sequences mush be of the same size. Every <computeroutput>from[i]</computeroutput> substring occurrence in the output will be replaced with <computeroutput>to[i]</computeroutput>. </para>
  268. </note>
  269. </para></description></function>
  270. </namespace>
  271. </namespace>
  272. </namespace>
  273. </header>
  274. <header name="boost/log/expressions/formatters/csv_decorator.hpp">
  275. <para><para>Andrey Semashev </para>
  276. <para>18.11.2012</para>
  277. The header contains implementation of a CSV-style character decorator. See: <ulink url="http://en.wikipedia.org/wiki/Comma-separated_values">http://en.wikipedia.org/wiki/Comma-separated_values</ulink> </para><namespace name="boost">
  278. <namespace name="log">
  279. <namespace name="expressions">
  280. <data-member name="csv_decor"><type><emphasis>unspecified</emphasis></type><description><para>CSV-style decorator generator object. The decorator doubles double quotes that may be found in the output. See <ulink url="http://en.wikipedia.org/wiki/Comma-separated_values">http://en.wikipedia.org/wiki/Comma-separated_values</ulink> for more information on the CSV format. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator. For example:</para><para><computeroutput> csv_decor[ stream &lt;&lt; attr&lt; std::string &gt;("MyAttr") ] </computeroutput></para><para>For wide-character formatting there is the similar <computeroutput>wcsv_decor</computeroutput> decorator generator object. </para></description></data-member>
  281. <data-member name="wcsv_decor"><type><emphasis>unspecified</emphasis></type></data-member>
  282. <function name="make_csv_decor"><type><emphasis>unspecified</emphasis></type><template>
  283. <template-type-parameter name="CharT"/>
  284. </template><description><para>The function creates an CSV-style decorator generator for arbitrary character type. </para></description></function>
  285. </namespace>
  286. </namespace>
  287. </namespace>
  288. </header>
  289. <header name="boost/log/expressions/formatters/date_time.hpp">
  290. <para><para>Andrey Semashev </para>
  291. <para>16.09.2012</para>
  292. The header contains a formatter function for date and time attribute values. </para><namespace name="boost">
  293. <namespace name="log">
  294. <namespace name="expressions">
  295. <class name="format_date_time_actor"><template>
  296. <template-type-parameter name="T"/>
  297. <template-type-parameter name="FallbackPolicyT"/>
  298. <template-type-parameter name="CharT"/>
  299. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  300. </template><inherit access="public">ActorT&lt; format_date_time_terminal&lt; T, FallbackPolicyT, CharT &gt; &gt;</inherit><description><para>Date and time formatter actor. </para></description><typedef name="value_type"><purpose>Attribute value type. </purpose><type>T</type></typedef>
  301. <typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  302. <typedef name="fallback_policy"><purpose>Fallback policy. </purpose><type>FallbackPolicyT</type></typedef>
  303. <typedef name="terminal_type"><purpose>Base terminal type. </purpose><type><classname>format_date_time_terminal</classname>&lt; value_type, fallback_policy, char_type &gt;</type></typedef>
  304. <typedef name="formatter_function_type"><purpose>Formatter function. </purpose><type>terminal_type::formatter_function_type</type></typedef>
  305. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  306. <method-group name="public member functions">
  307. <method name="get_name" cv="const"><type>attribute_name</type><description><para>
  308. </para></description><returns><para>The attribute name </para>
  309. </returns></method>
  310. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><description><para>
  311. </para></description><returns><para>Fallback policy </para>
  312. </returns></method>
  313. <method name="get_formatter_function" cv="const"><type>formatter_function_type const &amp;</type><description><para>
  314. </para></description><returns><para>Formatter function </para>
  315. </returns></method>
  316. </method-group>
  317. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  318. </class><class name="format_date_time_terminal"><template>
  319. <template-type-parameter name="T"/>
  320. <template-type-parameter name="FallbackPolicyT"/>
  321. <template-type-parameter name="CharT"/>
  322. </template><description><para>Date and time formatter terminal. </para></description><typedef name="value_type"><purpose>Attribute value type. </purpose><type>T</type></typedef>
  323. <typedef name="fallback_policy"><purpose>Fallback policy. </purpose><type>FallbackPolicyT</type></typedef>
  324. <typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  325. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  326. <typedef name="stream_type"><purpose>Formatting stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  327. <typedef name="formatter_function_type"><purpose>Formatter function. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  328. <typedef name="result_type"><purpose>Function result type. </purpose><type>string_type</type></typedef>
  329. <method-group name="public member functions">
  330. <method name="get_name" cv="const"><type>attribute_name</type><purpose>Returns attribute name. </purpose></method>
  331. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><purpose>Returns fallback policy. </purpose></method>
  332. <method name="get_formatter_function" cv="const"><type>formatter_function_type const &amp;</type><purpose>Retruns formatter function. </purpose></method>
  333. <method name="operator()"><type>result_type</type><template>
  334. <template-type-parameter name="ContextT"/>
  335. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  336. <method name="operator()" cv="const"><type>result_type</type><template>
  337. <template-type-parameter name="ContextT"/>
  338. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  339. </method-group>
  340. <constructor><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="fallback"><paramtype>fallback_policy const &amp;</paramtype></parameter><parameter name="format"><paramtype>string_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  341. <constructor><parameter name="that"><paramtype><classname>format_date_time_terminal</classname> const &amp;</paramtype></parameter><purpose>Copy constructor. </purpose></constructor>
  342. <constructor cv="= delete"/>
  343. </class>
  344. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; AttributeValueT, fallback_to_none, CharT &gt;</type><template>
  345. <template-type-parameter name="AttributeValueT"/>
  346. <template-type-parameter name="CharT"/>
  347. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="format"><paramtype>const CharT *</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  348. </para></description></function>
  349. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; AttributeValueT, fallback_to_none, CharT &gt;</type><template>
  350. <template-type-parameter name="AttributeValueT"/>
  351. <template-type-parameter name="CharT"/>
  352. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  353. </para></description></function>
  354. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; typename DescriptorT::value_type, fallback_to_none, CharT, ActorT &gt;</type><template>
  355. <template-type-parameter name="DescriptorT"/>
  356. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  357. <template-type-parameter name="CharT"/>
  358. </template><parameter name="keyword"><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype><description><para>Attribute keyword </para></description></parameter><parameter name="format"><paramtype>const CharT *</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  359. </para></description></function>
  360. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; typename DescriptorT::value_type, fallback_to_none, CharT, ActorT &gt;</type><template>
  361. <template-type-parameter name="DescriptorT"/>
  362. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  363. <template-type-parameter name="CharT"/>
  364. </template><parameter name="keyword"><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype><description><para>Attribute keyword </para></description></parameter><parameter name="format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  365. </para></description></function>
  366. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; T, FallbackPolicyT, CharT, ActorT &gt;</type><template>
  367. <template-type-parameter name="T"/>
  368. <template-type-parameter name="FallbackPolicyT"/>
  369. <template-type-parameter name="TagT"/>
  370. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  371. <template-type-parameter name="CharT"/>
  372. </template><parameter name="placeholder"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype><description><para>Attribute placeholder </para></description></parameter><parameter name="format"><paramtype>const CharT *</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  373. </para></description></function>
  374. <function name="format_date_time"><type><classname>format_date_time_actor</classname>&lt; T, FallbackPolicyT, CharT, ActorT &gt;</type><template>
  375. <template-type-parameter name="T"/>
  376. <template-type-parameter name="FallbackPolicyT"/>
  377. <template-type-parameter name="TagT"/>
  378. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  379. <template-type-parameter name="CharT"/>
  380. </template><parameter name="placeholder"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype><description><para>Attribute placeholder </para></description></parameter><parameter name="format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  381. </para></description></function>
  382. </namespace>
  383. </namespace>
  384. </namespace>
  385. </header>
  386. <header name="boost/log/expressions/formatters/format.hpp">
  387. <para><para>Andrey Semashev </para>
  388. <para>15.11.2012</para>
  389. The header contains a generic log record formatter function. </para><namespace name="boost">
  390. <namespace name="log">
  391. <namespace name="expressions">
  392. <class name="format_terminal"><template>
  393. <template-type-parameter name="CharT"/>
  394. </template><purpose>Template expressions terminal node with Boost.Format-like formatter. </purpose><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  395. <typedef name="format_type"><purpose>Boost.Format formatter type. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  396. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  397. <typedef name="result_type"><purpose>Terminal result type. </purpose><type>format_type::pump</type></typedef>
  398. <method-group name="public member functions">
  399. <method name="operator()" cv="const"><type>result_type</type><template>
  400. <template-type-parameter name="ContextT"/>
  401. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  402. </method-group>
  403. <constructor specifiers="explicit"><parameter name="format"><paramtype>const char_type *</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  404. <constructor cv="= delete"/>
  405. </class>
  406. <function name="format"><type>phoenix::actor&lt; <classname>format_terminal</classname>&lt; CharT &gt; &gt;</type><template>
  407. <template-type-parameter name="CharT"/>
  408. </template><parameter name="fmt"><paramtype>const CharT *</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will perform log record formatting according to the provided format string. </para></description></function>
  409. <function name="format"><type>phoenix::actor&lt; <classname>format_terminal</classname>&lt; CharT &gt; &gt;</type><template>
  410. <template-type-parameter name="CharT"/>
  411. <template-type-parameter name="TraitsT"/>
  412. <template-type-parameter name="AllocatorT"/>
  413. </template><parameter name="fmt"><paramtype>std::basic_string&lt; CharT, TraitsT, AllocatorT &gt; const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will perform log record formatting according to the provided format string. </para></description></function>
  414. </namespace>
  415. </namespace>
  416. </namespace>
  417. </header>
  418. <header name="boost/log/expressions/formatters/if.hpp">
  419. <para><para>Andrey Semashev </para>
  420. <para>17.11.2012</para>
  421. The header contains implementation of a conditional formatter. </para><namespace name="boost">
  422. <namespace name="log">
  423. <namespace name="expressions">
  424. <function name="if_"><type><emphasis>unspecified</emphasis></type><template>
  425. <template-type-parameter name="CondT"/>
  426. </template><parameter name="cond"><paramtype>CondT const &amp;</paramtype><description><para>A filter expression that will be used as the condition </para></description></parameter><description><para>The function returns a conditional formatter generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual formatter. The formatter must participate in a streaming expression.</para><para>
  427. </para></description></function>
  428. </namespace>
  429. </namespace>
  430. </namespace>
  431. </header>
  432. <header name="boost/log/expressions/formatters/max_size_decorator.hpp">
  433. <para><para>Andrey Semashev </para>
  434. <para>06.07.2016</para>
  435. The header contains implementation of a string length limiting decorator. </para><namespace name="boost">
  436. <namespace name="log">
  437. <namespace name="expressions">
  438. <class name="max_size_decorator_actor"><template>
  439. <template-type-parameter name="SubactorT"/>
  440. <template-type-parameter name="CharT"/>
  441. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  442. </template><inherit access="public">ActorT&lt; max_size_decorator_terminal&lt; SubactorT, CharT &gt; &gt;</inherit><description><para>Character decorator actor </para></description><typedef name="terminal_type"><purpose>Base terminal type. </purpose><type><classname>max_size_decorator_terminal</classname>&lt; SubactorT, CharT &gt;</type></typedef>
  443. <typedef name="char_type"><purpose>Character type. </purpose><type>terminal_type::char_type</type></typedef>
  444. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  445. <method-group name="public member functions">
  446. <method name="get_terminal" cv="const"><type>terminal_type const &amp;</type><purpose>Returns reference to the terminal. </purpose></method>
  447. </method-group>
  448. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  449. </class><class name="max_size_decorator_terminal"><template>
  450. <template-type-parameter name="SubactorT"/>
  451. <template-type-parameter name="CharT"/>
  452. </template><description><para>String size limiting decorator terminal class. This formatter allows to limit the maximum total length of the strings generated by other formatters.</para><para>The <computeroutput><classname alt="boost::log::expressions::max_size_decorator_terminal">max_size_decorator_terminal</classname></computeroutput> class aggregates the formatter being decorated, the maximum string length it can produce and an optional truncation marker string, which will be put at the end of the output if the limit is exceeded. Note that the marker length is included in the limit and as such must not exceed it. The <computeroutput><classname alt="boost::log::expressions::max_size_decorator_terminal">max_size_decorator_terminal</classname></computeroutput> class is a formatter itself, so it can be used to construct more complex formatters, including nesting decorators. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  453. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  454. <typedef name="size_type"><purpose>String size type. </purpose><type>std::size_t</type></typedef>
  455. <typedef name="stream_type"><purpose>Stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  456. <typedef name="subactor_type"><purpose>Adopted actor type. </purpose><type>SubactorT</type></typedef>
  457. <typedef name="result_type"><purpose>Result type definition. </purpose><type>string_type</type></typedef>
  458. <method-group name="public member functions">
  459. <method name="get_subactor" cv="const"><type>subactor_type const &amp;</type><description><para>
  460. </para></description><returns><para>Adopted subactor </para>
  461. </returns></method>
  462. <method name="get_max_size" cv="const"><type>size_type</type><description><para>
  463. </para></description><returns><para>Max string size limit </para>
  464. </returns></method>
  465. <method name="get_overflow_marker" cv="const"><type>string_type const &amp;</type><description><para>
  466. </para></description><returns><para>Max string size limit </para>
  467. </returns></method>
  468. <method name="operator()"><type>result_type</type><template>
  469. <template-type-parameter name="ContextT"/>
  470. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>Invokation operator </para></description></method>
  471. <method name="operator()" cv="const"><type>result_type</type><template>
  472. <template-type-parameter name="ContextT"/>
  473. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><description><para>Invokation operator </para></description></method>
  474. </method-group>
  475. <constructor><parameter name="sub"><paramtype>subactor_type const &amp;</paramtype></parameter><parameter name="max_size"><paramtype>size_type</paramtype></parameter><parameter name="overflow_marker"><paramtype>string_type const &amp;</paramtype><default>string_type()</default></parameter><description><para>Initializing constructor. </para></description></constructor>
  476. <constructor><parameter name="that"><paramtype><classname>max_size_decorator_terminal</classname> const &amp;</paramtype></parameter><description><para>Copy constructor </para></description></constructor>
  477. <constructor cv="= delete"/>
  478. </class>
  479. <function name="max_size_decor"><type><emphasis>unspecified</emphasis></type><template>
  480. <template-type-parameter name="CharT"/>
  481. </template><parameter name="max_size"><paramtype>std::size_t</paramtype><description><para>The maximum number of characters (i.e. string element objects) that the decorated formatter can produce. </para></description></parameter><description><para>The function returns a decorator generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator.</para><para>
  482. </para></description></function>
  483. <function name="max_size_decor"><type><emphasis>unspecified</emphasis></type><template>
  484. <template-type-parameter name="CharT"/>
  485. </template><parameter name="max_size"><paramtype>std::size_t</paramtype><description><para>The maximum number of characters (i.e. string element objects) that the decorated formatter can produce. </para></description></parameter><parameter name="overflow_marker"><paramtype>const CharT *</paramtype><description><para>The marker string which is appended to the output if the <emphasis>max_size</emphasis> limit is exceeded. Must be a non-null pointer to a zero-terminated string.</para></description></parameter><description><para>The function returns a decorator generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator.</para><para>
  486. </para></description><requires><para>The <emphasis>overflow_marker</emphasis> length must not exceed the <emphasis>max_size</emphasis> limit. </para>
  487. </requires></function>
  488. <function name="max_size_decor"><type><emphasis>unspecified</emphasis></type><template>
  489. <template-type-parameter name="CharT"/>
  490. </template><parameter name="max_size"><paramtype>std::size_t</paramtype><description><para>The maximum number of characters (i.e. string element objects) that the decorated formatter can produce. </para></description></parameter><parameter name="overflow_marker"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>The marker string which is appended to the output if the <emphasis>max_size</emphasis> limit is exceeded.</para></description></parameter><description><para>The function returns a decorator generator object. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator.</para><para>
  491. </para></description><requires><para>The <emphasis>overflow_marker</emphasis> length must not exceed the <emphasis>max_size</emphasis> limit. </para>
  492. </requires></function>
  493. </namespace>
  494. </namespace>
  495. </namespace>
  496. </header>
  497. <header name="boost/log/expressions/formatters/named_scope.hpp">
  498. <para><para>Andrey Semashev </para>
  499. <para>11.11.2012</para>
  500. The header contains a formatter function for named scope attribute values. </para><namespace name="boost">
  501. <namespace name="log">
  502. <namespace name="expressions">
  503. <class name="format_named_scope_actor"><template>
  504. <template-type-parameter name="FallbackPolicyT"/>
  505. <template-type-parameter name="CharT"/>
  506. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  507. </template><inherit access="public">ActorT&lt; format_named_scope_terminal&lt; FallbackPolicyT, CharT &gt; &gt;</inherit><description><para>Named scope formatter actor. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  508. <typedef name="fallback_policy"><purpose>Fallback policy. </purpose><type>FallbackPolicyT</type></typedef>
  509. <typedef name="terminal_type"><purpose>Base terminal type. </purpose><type><classname>format_named_scope_terminal</classname>&lt; fallback_policy, char_type &gt;</type></typedef>
  510. <typedef name="value_type"><purpose>Attribute value type. </purpose><type>terminal_type::value_type</type></typedef>
  511. <typedef name="formatter_function_type"><purpose>Formatter function. </purpose><type>terminal_type::formatter_function_type</type></typedef>
  512. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  513. <method-group name="public member functions">
  514. <method name="get_name" cv="const"><type>attribute_name</type><description><para>
  515. </para></description><returns><para>The attribute name </para>
  516. </returns></method>
  517. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><description><para>
  518. </para></description><returns><para>Fallback policy </para>
  519. </returns></method>
  520. <method name="get_formatter_function" cv="const"><type>formatter_function_type const &amp;</type><description><para>
  521. </para></description><returns><para>Formatter function </para>
  522. </returns></method>
  523. </method-group>
  524. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  525. </class><class name="format_named_scope_terminal"><template>
  526. <template-type-parameter name="FallbackPolicyT"/>
  527. <template-type-parameter name="CharT"/>
  528. </template><description><para>Named scope formatter terminal. </para></description><typedef name="value_type"><purpose>Attribute value type. </purpose><type>attributes::named_scope::value_type</type></typedef>
  529. <typedef name="fallback_policy"><purpose>Fallback policy. </purpose><type>FallbackPolicyT</type></typedef>
  530. <typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  531. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  532. <typedef name="stream_type"><purpose>Formatting stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  533. <typedef name="formatter_function_type"><purpose>Formatter function. </purpose><type><emphasis>unspecified</emphasis></type></typedef>
  534. <typedef name="result_type"><purpose>Function result type. </purpose><type>string_type</type></typedef>
  535. <method-group name="public member functions">
  536. <method name="get_name" cv="const"><type>attribute_name</type><purpose>Returns attribute name. </purpose></method>
  537. <method name="get_fallback_policy" cv="const"><type>fallback_policy const &amp;</type><purpose>Returns fallback policy. </purpose></method>
  538. <method name="get_formatter_function" cv="const"><type>formatter_function_type const &amp;</type><purpose>Retruns formatter function. </purpose></method>
  539. <method name="operator()"><type>result_type</type><template>
  540. <template-type-parameter name="ContextT"/>
  541. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  542. <method name="operator()" cv="const"><type>result_type</type><template>
  543. <template-type-parameter name="ContextT"/>
  544. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  545. </method-group>
  546. <constructor><template>
  547. <template-type-parameter name="FormatT"/>
  548. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="fallback"><paramtype>fallback_policy const &amp;</paramtype></parameter><parameter name="element_format"><paramtype>FormatT const &amp;</paramtype></parameter><parameter name="delimiter"><paramtype>string_type const &amp;</paramtype></parameter><parameter name="incomplete_marker"><paramtype>string_type const &amp;</paramtype></parameter><parameter name="empty_marker"><paramtype>string_type const &amp;</paramtype></parameter><parameter name="depth"><paramtype>value_type::size_type</paramtype></parameter><parameter name="direction"><paramtype>scope_iteration_direction</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  549. <constructor><parameter name="that"><paramtype><classname>format_named_scope_terminal</classname> const &amp;</paramtype></parameter><purpose>Copy constructor. </purpose></constructor>
  550. <constructor cv="= delete"/>
  551. </class><enum name="scope_iteration_direction"><enumvalue name="forward"><purpose>Iterate through scopes from outermost to innermost. </purpose></enumvalue><enumvalue name="reverse"><purpose>Iterate through scopes from innermost to outermost. </purpose></enumvalue><purpose>Scope iteration directions. </purpose></enum>
  552. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; fallback_to_none, CharT &gt;</type><template>
  553. <template-type-parameter name="CharT"/>
  554. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="element_format"><paramtype>const CharT *</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  555. </para></description></function>
  556. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; fallback_to_none, CharT &gt;</type><template>
  557. <template-type-parameter name="CharT"/>
  558. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="element_format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  559. </para></description></function>
  560. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; fallback_to_none, CharT, ActorT &gt;</type><template>
  561. <template-type-parameter name="DescriptorT"/>
  562. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  563. <template-type-parameter name="CharT"/>
  564. </template><parameter name="keyword"><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype><description><para>Attribute keyword </para></description></parameter><parameter name="element_format"><paramtype>const CharT *</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  565. </para></description></function>
  566. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; fallback_to_none, CharT, ActorT &gt;</type><template>
  567. <template-type-parameter name="DescriptorT"/>
  568. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  569. <template-type-parameter name="CharT"/>
  570. </template><parameter name="keyword"><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype><description><para>Attribute keyword </para></description></parameter><parameter name="element_format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  571. </para></description></function>
  572. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; FallbackPolicyT, CharT, ActorT &gt;</type><template>
  573. <template-type-parameter name="T"/>
  574. <template-type-parameter name="FallbackPolicyT"/>
  575. <template-type-parameter name="TagT"/>
  576. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  577. <template-type-parameter name="CharT"/>
  578. </template><parameter name="placeholder"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype><description><para>Attribute placeholder </para></description></parameter><parameter name="element_format"><paramtype>const CharT *</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  579. </para></description></function>
  580. <function name="format_named_scope"><type><classname>format_named_scope_actor</classname>&lt; FallbackPolicyT, CharT, ActorT &gt;</type><template>
  581. <template-type-parameter name="T"/>
  582. <template-type-parameter name="FallbackPolicyT"/>
  583. <template-type-parameter name="TagT"/>
  584. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  585. <template-type-parameter name="CharT"/>
  586. </template><parameter name="placeholder"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype><description><para>Attribute placeholder </para></description></parameter><parameter name="element_format"><paramtype>std::basic_string&lt; CharT &gt; const &amp;</paramtype><description><para>Format string for a single named scope </para></description></parameter><description><para>The function generates a manipulator node in a template expression. The manipulator must participate in a formatting expression (stream output or <computeroutput>format</computeroutput> placeholder filler).</para><para>
  587. </para></description></function>
  588. <overloaded-function name="format_named_scope"><signature><type>unspecified</type><template>
  589. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  590. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype><description><para>An set of named parameters. Supported parameters: <itemizedlist>
  591. <listitem><para><computeroutput>format</computeroutput> - A format string for named scopes. The string can contain "%n", "%f" and "%l" placeholders for the scope name, file and line number, respectively. This parameter is mandatory. </para>
  592. </listitem>
  593. <listitem><para><computeroutput>delimiter</computeroutput> - A string that is used to delimit the formatted scope names. Default: "-&gt;" or "&lt;-", depending on the iteration direction. </para>
  594. </listitem>
  595. <listitem><para><computeroutput>incomplete_marker</computeroutput> - A string that is used to indicate that the list was printed incomplete because of depth limitation. Default: "...". </para>
  596. </listitem>
  597. <listitem><para><computeroutput>empty_marker</computeroutput> - A string that is output in case if the scope list is empty. Default: "", i.e. nothing is output. </para>
  598. </listitem>
  599. <listitem><para><computeroutput>iteration</computeroutput> - Iteration direction, see <computeroutput>scope_iteration_direction</computeroutput> enumeration. Default: forward. </para>
  600. </listitem>
  601. <listitem><para><computeroutput>depth</computeroutput> - Iteration depth. Default: unlimited. </para>
  602. </listitem>
  603. </itemizedlist>
  604. </para></description></parameter></signature><signature><type>unspecified</type><template>
  605. <template-type-parameter name="DescriptorT"/>
  606. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  607. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  608. </template><parameter name="keyword"><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter></signature><signature><type>unspecified</type><template>
  609. <template-type-parameter name="T"/>
  610. <template-type-parameter name="FallbackPolicyT"/>
  611. <template-type-parameter name="TagT"/>
  612. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  613. <template-nontype-parameter name="ArgsT"><type>typename...</type></template-nontype-parameter>
  614. </template><parameter name="placeholder"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="args"><paramtype>ArgsT... const &amp;</paramtype></parameter></signature><description><para>Formatter generator. Construct the named scope formatter with the specified formatting parameters.</para><para>
  615. </para></description></overloaded-function>
  616. </namespace>
  617. </namespace>
  618. </namespace>
  619. </header>
  620. <header name="boost/log/expressions/formatters/stream.hpp">
  621. <para><para>Andrey Semashev </para>
  622. <para>24.07.2012</para>
  623. The header contains implementation of a stream placeholder in template expressions. </para><namespace name="boost">
  624. <namespace name="log">
  625. <namespace name="expressions">
  626. <typedef name="stream_type"><description><para>Stream placeholder type in formatter template expressions. </para></description><type>phoenix::expression::argument&lt; 2 &gt;::type</type></typedef>
  627. <data-member name="stream"><type>const stream_type</type><description><para>Stream placeholder in formatter template expressions. </para></description></data-member>
  628. </namespace>
  629. </namespace>
  630. </namespace>
  631. </header>
  632. <header name="boost/log/expressions/formatters/wrap_formatter.hpp">
  633. <para><para>Andrey Semashev </para>
  634. <para>24.11.2012</para>
  635. The header contains a formatter function wrapper that enables third-party functions to participate in formatting expressions. </para><namespace name="boost">
  636. <namespace name="log">
  637. <namespace name="expressions">
  638. <class name="wrapped_formatter_actor"><template>
  639. <template-type-parameter name="FunT"/>
  640. <template-type-parameter name="CharT"/>
  641. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  642. </template><inherit access="public">ActorT&lt; wrapped_formatter_terminal&lt; FunT, CharT &gt; &gt;</inherit><description><para>Wrapped formatter function actor. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  643. <typedef name="function_type"><purpose>Wrapped function type. </purpose><type>FunT</type></typedef>
  644. <typedef name="terminal_type"><purpose>Base terminal type. </purpose><type><classname>wrapped_formatter_terminal</classname>&lt; function_type, char_type &gt;</type></typedef>
  645. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  646. <method-group name="public member functions">
  647. <method name="get_function" cv="const"><type>function_type const &amp;</type><description><para>
  648. </para></description><returns><para>The wrapped function </para>
  649. </returns></method>
  650. </method-group>
  651. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  652. </class><class name="wrapped_formatter_terminal"><template>
  653. <template-type-parameter name="FunT"/>
  654. <template-type-parameter name="CharT"/>
  655. </template><description><para>Formatter function wrapper terminal. </para></description><typedef name="char_type"><purpose>Character type. </purpose><type>CharT</type></typedef>
  656. <typedef name="string_type"><purpose>String type. </purpose><type>std::basic_string&lt; char_type &gt;</type></typedef>
  657. <typedef name="stream_type"><purpose>Formatting stream type. </purpose><type>basic_formatting_ostream&lt; char_type &gt;</type></typedef>
  658. <typedef name="function_type"><purpose>Wrapped function type. </purpose><type>FunT</type></typedef>
  659. <typedef name="result_type"><purpose>Formatter result type. </purpose><type>string_type</type></typedef>
  660. <method-group name="public member functions">
  661. <method name="get_function" cv="const"><type>function_type const &amp;</type><purpose>Returns the wrapped function. </purpose></method>
  662. <method name="operator()"><type>result_type</type><template>
  663. <template-type-parameter name="ContextT"/>
  664. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  665. <method name="operator()" cv="const"><type>result_type</type><template>
  666. <template-type-parameter name="ContextT"/>
  667. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  668. </method-group>
  669. <constructor specifiers="explicit"><parameter name="fun"><paramtype>function_type const &amp;</paramtype></parameter><purpose>Initializing construction. </purpose></constructor>
  670. <constructor><parameter name="that"><paramtype><classname>wrapped_formatter_terminal</classname> const &amp;</paramtype></parameter><purpose>Copy constructor. </purpose></constructor>
  671. </class>
  672. <function name="wrap_formatter"><type><emphasis>unspecified</emphasis></type><template>
  673. <template-type-parameter name="FunT"/>
  674. </template><parameter name="fun"><paramtype>FunT const &amp;</paramtype></parameter><description><para>The function wraps a function object in order it to be able to participate in formatting expressions. The wrapped function object must be compatible with the following signature:</para><programlisting>
  675. void (record_view const&amp;, basic_formatting_ostream&lt; CharT &gt;&amp;)
  676. </programlisting><para>where <computeroutput>CharT</computeroutput> is the character type of the formatting expression. </para></description></function>
  677. <function name="wrap_formatter"><type><classname>wrapped_formatter_actor</classname>&lt; FunT, CharT &gt;</type><template>
  678. <template-type-parameter name="CharT"/>
  679. <template-type-parameter name="FunT"/>
  680. </template><parameter name="fun"><paramtype>FunT const &amp;</paramtype></parameter><description><para>The function wraps a function object in order it to be able to participate in formatting expressions. The wrapped function object must be compatible with the following signature:</para><programlisting>
  681. void (record_view const&amp;, basic_formatting_ostream&lt; CharT &gt;&amp;)
  682. </programlisting><para>where <computeroutput>CharT</computeroutput> is the character type of the formatting expression. </para></description></function>
  683. </namespace>
  684. </namespace>
  685. </namespace>
  686. </header>
  687. <header name="boost/log/expressions/formatters/xml_decorator.hpp">
  688. <para><para>Andrey Semashev </para>
  689. <para>18.11.2012</para>
  690. The header contains implementation of a XML-style character decorator. </para><namespace name="boost">
  691. <namespace name="log">
  692. <namespace name="expressions">
  693. <data-member name="xml_decor"><type><emphasis>unspecified</emphasis></type><description><para>XML-style decorator generator object. The decorator replaces characters that have special meaning in XML documents with the corresponding decorated counterparts. The generator provides <computeroutput>operator[]</computeroutput> that can be used to construct the actual decorator. For example:</para><para><computeroutput> xml_decor[ stream &lt;&lt; attr&lt; std::string &gt;("MyAttr") ] </computeroutput></para><para>For wide-character formatting there is the similar <computeroutput>wxml_decor</computeroutput> decorator generator object. </para></description></data-member>
  694. <data-member name="wxml_decor"><type><emphasis>unspecified</emphasis></type></data-member>
  695. <function name="make_xml_decor"><type><emphasis>unspecified</emphasis></type><template>
  696. <template-type-parameter name="CharT"/>
  697. </template><description><para>The function creates an XML-style decorator generator for arbitrary character type. </para></description></function>
  698. </namespace>
  699. </namespace>
  700. </namespace>
  701. </header>
  702. <header name="boost/log/expressions/is_keyword_descriptor.hpp">
  703. <para><para>Andrey Semashev </para>
  704. <para>14.07.2012</para>
  705. The header contains attribute keyword descriptor detection trait. </para><namespace name="boost">
  706. <namespace name="log">
  707. <namespace name="expressions">
  708. <struct name="is_keyword_descriptor"><template>
  709. <template-type-parameter name="T"/>
  710. <template-type-parameter name="VoidT"><default>void</default></template-type-parameter>
  711. </template><inherit access="public">false_</inherit><description><para>The metafunction detects if the type <computeroutput>T</computeroutput> is a keyword descriptor </para></description></struct><struct name="keyword_descriptor"><description><para>Base class for keyword descriptors. All keyword descriptors must derive from this class to support the <computeroutput><classname alt="boost::log::expressions::is_keyword_descriptor">is_keyword_descriptor</classname></computeroutput> trait. </para></description></struct>
  712. </namespace>
  713. </namespace>
  714. </namespace>
  715. </header>
  716. <header name="boost/log/expressions/keyword.hpp">
  717. <para><para>Andrey Semashev </para>
  718. <para>29.01.2012</para>
  719. The header contains attribute keyword declaration. </para><namespace name="boost">
  720. <namespace name="log">
  721. <namespace name="expressions">
  722. </namespace>
  723. </namespace>
  724. </namespace>
  725. <macro name="BOOST_LOG_ATTRIBUTE_KEYWORD_TYPE" kind="functionlike"><macro-parameter name="keyword_"><description><para>Keyword name </para></description></macro-parameter><macro-parameter name="name_"><description><para>Attribute name string </para></description></macro-parameter><macro-parameter name="value_type_"><description><para>Attribute value type </para></description></macro-parameter><purpose>The macro declares an attribute keyword type. </purpose><description><para>The macro should be used at a namespace scope. It expands into an attribute keyword type definition, including the <computeroutput>tag</computeroutput> namespace and the keyword tag type within which has the following layout:</para><para><programlisting language="c++">namespace tag
  726. {
  727. struct keyword_ :
  728. public boost::log::expressions::keyword_descriptor
  729. {
  730. typedef value_type_ value_type;
  731. static boost::log::attribute_name get_name();
  732. };
  733. }
  734. typedef boost::log::expressions::attribute_keyword&lt; tag::keyword_ &gt; keyword_type;
  735. </programlisting></para><para>The <computeroutput>get_name</computeroutput> method returns the attribute name.</para><para><note><para>This macro only defines the type of the keyword. To also define the keyword object, use the <computeroutput>BOOST_LOG_ATTRIBUTE_KEYWORD</computeroutput> macro instead.</para>
  736. </note>
  737. </para></description></macro>
  738. <macro name="BOOST_LOG_ATTRIBUTE_KEYWORD" kind="functionlike"><macro-parameter name="keyword_"><description><para>Keyword name </para></description></macro-parameter><macro-parameter name="name_"><description><para>Attribute name string </para></description></macro-parameter><macro-parameter name="value_type_"><description><para>Attribute value type </para></description></macro-parameter><purpose>The macro declares an attribute keyword. </purpose><description><para>The macro provides definitions similar to <computeroutput>BOOST_LOG_ATTRIBUTE_KEYWORD_TYPE</computeroutput> and additionally defines the keyword object.</para><para>
  739. </para></description></macro>
  740. </header>
  741. <header name="boost/log/expressions/keyword_fwd.hpp">
  742. <para><para>Andrey Semashev </para>
  743. <para>29.01.2012</para>
  744. The header contains attribute keyword forward declaration. </para><namespace name="boost">
  745. <namespace name="log">
  746. <namespace name="expressions">
  747. <struct name="attribute_keyword"><template>
  748. <template-type-parameter name="DescriptorT"/>
  749. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  750. </template><purpose>This class implements an expression template keyword. </purpose><description><para>This class implements an expression template keyword. It is used to start template expressions involving attribute values. </para></description><method-group name="public static functions">
  751. <method name="get_name" specifiers="static"><type>attribute_name</type><purpose>Returns attribute name. </purpose></method>
  752. <method name="or_none" specifiers="static"><type>or_none_result_type</type><purpose>Generates an expression that extracts the attribute value or a default value. </purpose></method>
  753. <method name="or_throw" specifiers="static"><type>or_throw_result_type</type><purpose>Generates an expression that extracts the attribute value or throws an exception. </purpose></method>
  754. <method name="or_default" specifiers="static"><type><classname>attribute_actor</classname>&lt; value_type, fallback_to_default&lt; DefaultT &gt;, descriptor_type, ActorT &gt;</type><template>
  755. <template-type-parameter name="DefaultT"/>
  756. </template><parameter name="def_val"><paramtype>DefaultT const &amp;</paramtype></parameter><purpose>Generates an expression that extracts the attribute value or a default value. </purpose></method>
  757. </method-group>
  758. </struct>
  759. </namespace>
  760. </namespace>
  761. </namespace>
  762. </header>
  763. <header name="boost/log/expressions/message.hpp">
  764. <para><para>Andrey Semashev </para>
  765. <para>13.07.2012</para>
  766. The header contains log message keyword declaration. </para><namespace name="boost">
  767. <namespace name="log">
  768. <namespace name="expressions">
  769. <namespace name="tag">
  770. <struct name="message"><inherit access="public">keyword_descriptor</inherit><description><para>Generic log message attribute descriptor. </para></description><typedef name="attribute_type"><type>void</type></typedef>
  771. <typedef name="value_type"><type>mpl::vector2&lt; std::string, std::wstring &gt;</type></typedef>
  772. <method-group name="public static functions">
  773. <method name="get_name" specifiers="static"><type>attribute_name</type></method>
  774. </method-group>
  775. </struct><struct name="smessage"><inherit access="public">keyword_descriptor</inherit><description><para>Narrow character log message attribute descriptor. </para></description><typedef name="attribute_type"><type>void</type></typedef>
  776. <typedef name="value_type"><type>std::string</type></typedef>
  777. <method-group name="public static functions">
  778. <method name="get_name" specifiers="static"><type>attribute_name</type></method>
  779. </method-group>
  780. </struct><struct name="wmessage"><inherit access="public">keyword_descriptor</inherit><description><para>Wide character log message attribute descriptor. </para></description><typedef name="attribute_type"><type>void</type></typedef>
  781. <typedef name="value_type"><type>std::wstring</type></typedef>
  782. <method-group name="public static functions">
  783. <method name="get_name" specifiers="static"><type>attribute_name</type></method>
  784. </method-group>
  785. </struct></namespace>
  786. <typedef name="message_type"><description><para>Generic message keyword type. </para></description><type><classname>attribute_keyword</classname>&lt; <classname>tag::message</classname> &gt;</type></typedef>
  787. <typedef name="smessage_type"><description><para>Narrow message keyword type. </para></description><type><classname>attribute_keyword</classname>&lt; <classname>tag::smessage</classname> &gt;</type></typedef>
  788. <typedef name="wmessage_type"><description><para>Wide message keyword type. </para></description><type><classname>attribute_keyword</classname>&lt; <classname>tag::wmessage</classname> &gt;</type></typedef>
  789. <data-member name="message"><type>const message_type</type><description><para>Generic message keyword. </para></description></data-member>
  790. <data-member name="smessage"><type>const smessage_type</type><description><para>Narrow message keyword. </para></description></data-member>
  791. <data-member name="wmessage"><type>const wmessage_type</type><description><para>Wide message keyword. </para></description></data-member>
  792. </namespace>
  793. </namespace>
  794. </namespace>
  795. </header>
  796. <header name="boost/log/expressions/predicates.hpp">
  797. <para><para>Andrey Semashev </para>
  798. <para>29.01.2012</para>
  799. The header includes all template expression predicates. </para></header>
  800. <header name="boost/log/expressions/predicates/begins_with.hpp">
  801. <para><para>Andrey Semashev </para>
  802. <para>02.09.2012</para>
  803. The header contains implementation of a <computeroutput>begins_with</computeroutput> predicate in template expressions. </para><namespace name="boost">
  804. <namespace name="log">
  805. <namespace name="expressions">
  806. <typedef name="attribute_begins_with"><description><para>The predicate checks if the attribute value begins with a substring. The attribute value is assumed to be of a string type. </para></description><type><emphasis>unspecified</emphasis></type></typedef>
  807. <function name="begins_with"><type><emphasis>unspecified</emphasis></type><template>
  808. <template-type-parameter name="T"/>
  809. <template-type-parameter name="FallbackPolicyT"/>
  810. <template-type-parameter name="TagT"/>
  811. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  812. <template-type-parameter name="SubstringT"/>
  813. </template><parameter name="attr"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, begins with the specified substring. </para></description></function>
  814. <function name="begins_with"><type><emphasis>unspecified</emphasis></type><template>
  815. <template-type-parameter name="DescriptorT"/>
  816. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  817. <template-type-parameter name="SubstringT"/>
  818. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, begins with the specified substring. </para></description></function>
  819. <function name="begins_with"><type><emphasis>unspecified</emphasis></type><template>
  820. <template-type-parameter name="T"/>
  821. <template-type-parameter name="SubstringT"/>
  822. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, begins with the specified substring. </para></description></function>
  823. </namespace>
  824. </namespace>
  825. </namespace>
  826. </header>
  827. <header name="boost/log/expressions/predicates/channel_severity_filter.hpp">
  828. <para><para>Andrey Semashev </para>
  829. <para>25.11.2012</para>
  830. The header contains implementation of a minimal severity per channel filter. </para><namespace name="boost">
  831. <namespace name="log">
  832. <namespace name="expressions">
  833. <class name="channel_severity_filter_actor"><template>
  834. <template-type-parameter name="ChannelT"/>
  835. <template-type-parameter name="SeverityT"/>
  836. <template-type-parameter name="ChannelFallbackT"><default>fallback_to_none</default></template-type-parameter>
  837. <template-type-parameter name="SeverityFallbackT"><default>fallback_to_none</default></template-type-parameter>
  838. <template-type-parameter name="ChannelOrderT"><default>less</default></template-type-parameter>
  839. <template-type-parameter name="SeverityCompareT"><default>greater_equal</default></template-type-parameter>
  840. <template-type-parameter name="AllocatorT"><default>std::allocator&lt; void &gt;</default></template-type-parameter>
  841. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type><default>phoenix::actor</default></template-nontype-parameter>
  842. </template><inherit access="public">ActorT&lt; channel_severity_filter_terminal&lt; ChannelT, SeverityT, ChannelFallbackT, SeverityFallbackT, ChannelOrderT, SeverityCompareT, AllocatorT &gt; &gt;</inherit><class name="subscript_result"><purpose>An auxiliary pseudo-reference to implement insertion through subscript operator. </purpose><method-group name="public member functions">
  843. </method-group>
  844. <constructor><parameter name="owner"><paramtype>channel_severity_filter_actor &amp;</paramtype></parameter><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter></constructor>
  845. <copy-assignment><type>void</type><parameter name="severity"><paramtype>severity_value_type const &amp;</paramtype></parameter></copy-assignment>
  846. </class><typedef name="terminal_type"><purpose>Terminal type. </purpose><type>channel_severity_filter_terminal&lt; ChannelT, SeverityT, ChannelFallbackT, SeverityFallbackT, ChannelOrderT, SeverityCompareT, AllocatorT &gt;</type></typedef>
  847. <typedef name="base_type"><purpose>Base actor type. </purpose><type>ActorT&lt; terminal_type &gt;</type></typedef>
  848. <typedef name="channel_value_type"><purpose>Channel attribute value type. </purpose><type>terminal_type::channel_value_type</type></typedef>
  849. <typedef name="channel_fallback_policy"><purpose>Channel fallback policy. </purpose><type>terminal_type::channel_fallback_policy</type></typedef>
  850. <typedef name="severity_value_type"><purpose>Severity level attribute value type. </purpose><type>terminal_type::severity_value_type</type></typedef>
  851. <typedef name="severity_fallback_policy"><purpose>Severity level fallback policy. </purpose><type>terminal_type::severity_fallback_policy</type></typedef>
  852. <method-group name="public member functions">
  853. <method name="set_default"><type>this_type &amp;</type><parameter name="def"><paramtype>bool</paramtype></parameter><purpose>Sets the default function result. </purpose></method>
  854. <method name="add"><type>this_type &amp;</type><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter><parameter name="severity"><paramtype>severity_value_type const &amp;</paramtype></parameter><purpose>Adds a new element to the mapping. </purpose></method>
  855. <method name="operator[]"><type>subscript_result</type><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter><purpose>Alternative interface for adding a new element to the mapping. </purpose></method>
  856. </method-group>
  857. <constructor specifiers="explicit"><parameter name="act"><paramtype>base_type const &amp;</paramtype></parameter><purpose>Initializing constructor. </purpose></constructor>
  858. <constructor><parameter name="that"><paramtype>channel_severity_filter_actor const &amp;</paramtype></parameter><purpose>Copy constructor. </purpose></constructor>
  859. </class><class name="channel_severity_filter_terminal"><template>
  860. <template-type-parameter name="ChannelT"/>
  861. <template-type-parameter name="SeverityT"/>
  862. <template-type-parameter name="ChannelFallbackT"><default>fallback_to_none</default></template-type-parameter>
  863. <template-type-parameter name="SeverityFallbackT"><default>fallback_to_none</default></template-type-parameter>
  864. <template-type-parameter name="ChannelOrderT"><default>less</default></template-type-parameter>
  865. <template-type-parameter name="SeverityCompareT"><default>greater_equal</default></template-type-parameter>
  866. <template-type-parameter name="AllocatorT"><default>std::allocator&lt; void &gt;</default></template-type-parameter>
  867. </template><struct name="channel_visitor"><template>
  868. <template-type-parameter name="ArgT"/>
  869. </template><purpose>Channel visitor. </purpose><typedef name="result_type"><type>void</type></typedef>
  870. <method-group name="public member functions">
  871. <method name="operator()" cv="const"><type>result_type</type><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter></method>
  872. </method-group>
  873. <constructor><parameter name="self"><paramtype>channel_severity_filter_terminal const &amp;</paramtype></parameter><parameter name="arg"><paramtype>ArgT</paramtype></parameter><parameter name="res"><paramtype>bool &amp;</paramtype></parameter></constructor>
  874. </struct><struct name="severity_visitor"><purpose>Severity level visitor. </purpose><typedef name="result_type"><type>void</type></typedef>
  875. <method-group name="public member functions">
  876. <method name="operator()" cv="const"><type>result_type</type><parameter name="severity"><paramtype>severity_value_type const &amp;</paramtype></parameter></method>
  877. </method-group>
  878. <constructor><parameter name="self"><paramtype>channel_severity_filter_terminal const &amp;</paramtype></parameter><parameter name="severity"><paramtype>severity_value_type const &amp;</paramtype></parameter><parameter name="res"><paramtype>bool &amp;</paramtype></parameter></constructor>
  879. </struct><typedef name="result_type"><purpose>Function result type. </purpose><type>bool</type></typedef>
  880. <typedef name="channel_value_type"><purpose>Channel attribute value type. </purpose><type>ChannelT</type></typedef>
  881. <typedef name="channel_fallback_policy"><purpose>Channel fallback policy. </purpose><type>ChannelFallbackT</type></typedef>
  882. <typedef name="severity_value_type"><purpose>Severity level attribute value type. </purpose><type>SeverityT</type></typedef>
  883. <typedef name="severity_fallback_policy"><purpose>Severity level fallback policy. </purpose><type>SeverityFallbackT</type></typedef>
  884. <method-group name="public member functions">
  885. <method name="add"><type>void</type><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter><parameter name="severity"><paramtype>severity_value_type const &amp;</paramtype></parameter><purpose>Adds a new element to the mapping. </purpose></method>
  886. <method name="set_default"><type>void</type><parameter name="def"><paramtype>bool</paramtype></parameter><purpose>Sets the default result of the predicate. </purpose></method>
  887. <method name="operator()" cv="const"><type>result_type</type><template>
  888. <template-type-parameter name="ContextT"/>
  889. </template><parameter name="ctx"><paramtype>ContextT const &amp;</paramtype></parameter><purpose>Invokation operator. </purpose></method>
  890. </method-group>
  891. <constructor><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="channel_fallback"><paramtype>channel_fallback_policy const &amp;</paramtype><default>channel_fallback_policy()</default></parameter><parameter name="severity_fallback"><paramtype>severity_fallback_policy const &amp;</paramtype><default>severity_fallback_policy()</default></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype><default>ChannelOrderT()</default></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype><default>SeverityCompareT()</default></parameter><purpose>Initializing constructor. </purpose></constructor>
  892. <method-group name="private member functions">
  893. <method name="visit_channel" cv="const"><type>void</type><template>
  894. <template-type-parameter name="ArgT"/>
  895. </template><parameter name="channel"><paramtype>channel_value_type const &amp;</paramtype></parameter><parameter name="arg"><paramtype>ArgT const &amp;</paramtype></parameter><parameter name="res"><paramtype>bool &amp;</paramtype></parameter><purpose>Visits channel name. </purpose></method>
  896. <method name="visit_severity" cv="const"><type>void</type><parameter name="left"><paramtype>severity_value_type const &amp;</paramtype></parameter><parameter name="right"><paramtype>severity_value_type const &amp;</paramtype></parameter><parameter name="res"><paramtype>bool &amp;</paramtype></parameter><purpose>Visits severity level. </purpose></method>
  897. </method-group>
  898. </class>
  899. <overloaded-function name="channel_severity_filter"><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT &gt;</type><template>
  900. <template-type-parameter name="ChannelT"/>
  901. <template-type-parameter name="SeverityT"/>
  902. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, SeverityT, fallback_to_none, fallback_to_none, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  903. <template-type-parameter name="SeverityT"/>
  904. <template-type-parameter name="ChannelDescriptorT"/>
  905. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  906. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  907. <template-type-parameter name="ChannelT"/>
  908. <template-type-parameter name="SeverityDescriptorT"/>
  909. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  910. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  911. <template-type-parameter name="ChannelDescriptorT"/>
  912. <template-type-parameter name="SeverityDescriptorT"/>
  913. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  914. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, fallback_to_none, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  915. <template-type-parameter name="SeverityT"/>
  916. <template-type-parameter name="ChannelT"/>
  917. <template-type-parameter name="ChannelFallbackT"/>
  918. <template-type-parameter name="ChannelTagT"/>
  919. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  920. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, fallback_to_none, SeverityFallbackT, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  921. <template-type-parameter name="ChannelT"/>
  922. <template-type-parameter name="SeverityT"/>
  923. <template-type-parameter name="SeverityFallbackT"/>
  924. <template-type-parameter name="SeverityTagT"/>
  925. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  926. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, SeverityFallbackT, less, greater_equal, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  927. <template-type-parameter name="ChannelT"/>
  928. <template-type-parameter name="ChannelFallbackT"/>
  929. <template-type-parameter name="ChannelTagT"/>
  930. <template-type-parameter name="SeverityT"/>
  931. <template-type-parameter name="SeverityFallbackT"/>
  932. <template-type-parameter name="SeverityTagT"/>
  933. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  934. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, fallback_to_none, fallback_to_none, less, SeverityCompareT &gt;</type><template>
  935. <template-type-parameter name="ChannelT"/>
  936. <template-type-parameter name="SeverityT"/>
  937. <template-type-parameter name="SeverityCompareT"/>
  938. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, SeverityT, fallback_to_none, fallback_to_none, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  939. <template-type-parameter name="SeverityT"/>
  940. <template-type-parameter name="ChannelDescriptorT"/>
  941. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  942. <template-type-parameter name="SeverityCompareT"/>
  943. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  944. <template-type-parameter name="ChannelT"/>
  945. <template-type-parameter name="SeverityDescriptorT"/>
  946. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  947. <template-type-parameter name="SeverityCompareT"/>
  948. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  949. <template-type-parameter name="ChannelDescriptorT"/>
  950. <template-type-parameter name="SeverityDescriptorT"/>
  951. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  952. <template-type-parameter name="SeverityCompareT"/>
  953. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, fallback_to_none, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  954. <template-type-parameter name="SeverityT"/>
  955. <template-type-parameter name="ChannelT"/>
  956. <template-type-parameter name="ChannelFallbackT"/>
  957. <template-type-parameter name="ChannelTagT"/>
  958. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  959. <template-type-parameter name="SeverityCompareT"/>
  960. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, fallback_to_none, SeverityFallbackT, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  961. <template-type-parameter name="ChannelT"/>
  962. <template-type-parameter name="SeverityT"/>
  963. <template-type-parameter name="SeverityFallbackT"/>
  964. <template-type-parameter name="SeverityTagT"/>
  965. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  966. <template-type-parameter name="SeverityCompareT"/>
  967. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, SeverityFallbackT, less, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  968. <template-type-parameter name="ChannelT"/>
  969. <template-type-parameter name="ChannelFallbackT"/>
  970. <template-type-parameter name="ChannelTagT"/>
  971. <template-type-parameter name="SeverityT"/>
  972. <template-type-parameter name="SeverityFallbackT"/>
  973. <template-type-parameter name="SeverityTagT"/>
  974. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  975. <template-type-parameter name="SeverityCompareT"/>
  976. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, fallback_to_none, fallback_to_none, ChannelOrderT, SeverityCompareT &gt;</type><template>
  977. <template-type-parameter name="ChannelT"/>
  978. <template-type-parameter name="SeverityT"/>
  979. <template-type-parameter name="SeverityCompareT"/>
  980. <template-type-parameter name="ChannelOrderT"/>
  981. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, SeverityT, fallback_to_none, fallback_to_none, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  982. <template-type-parameter name="SeverityT"/>
  983. <template-type-parameter name="ChannelDescriptorT"/>
  984. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  985. <template-type-parameter name="SeverityCompareT"/>
  986. <template-type-parameter name="ChannelOrderT"/>
  987. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  988. <template-type-parameter name="ChannelT"/>
  989. <template-type-parameter name="SeverityDescriptorT"/>
  990. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  991. <template-type-parameter name="SeverityCompareT"/>
  992. <template-type-parameter name="ChannelOrderT"/>
  993. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; typename ChannelDescriptorT::value_type, typename SeverityDescriptorT::value_type, fallback_to_none, fallback_to_none, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  994. <template-type-parameter name="ChannelDescriptorT"/>
  995. <template-type-parameter name="SeverityDescriptorT"/>
  996. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  997. <template-type-parameter name="SeverityCompareT"/>
  998. <template-type-parameter name="ChannelOrderT"/>
  999. </template><parameter name="channel_keyword"><paramtype><classname>attribute_keyword</classname>&lt; ChannelDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_keyword"><paramtype><classname>attribute_keyword</classname>&lt; SeverityDescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, fallback_to_none, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  1000. <template-type-parameter name="SeverityT"/>
  1001. <template-type-parameter name="ChannelT"/>
  1002. <template-type-parameter name="ChannelFallbackT"/>
  1003. <template-type-parameter name="ChannelTagT"/>
  1004. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1005. <template-type-parameter name="SeverityCompareT"/>
  1006. <template-type-parameter name="ChannelOrderT"/>
  1007. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, fallback_to_none, SeverityFallbackT, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  1008. <template-type-parameter name="ChannelT"/>
  1009. <template-type-parameter name="SeverityT"/>
  1010. <template-type-parameter name="SeverityFallbackT"/>
  1011. <template-type-parameter name="SeverityTagT"/>
  1012. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1013. <template-type-parameter name="SeverityCompareT"/>
  1014. <template-type-parameter name="ChannelOrderT"/>
  1015. </template><parameter name="channel_name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><signature><type>channel_severity_filter_actor&lt; ChannelT, SeverityT, ChannelFallbackT, SeverityFallbackT, ChannelOrderT, SeverityCompareT, std::allocator&lt; void &gt;, ActorT &gt;</type><template>
  1016. <template-type-parameter name="ChannelT"/>
  1017. <template-type-parameter name="ChannelFallbackT"/>
  1018. <template-type-parameter name="ChannelTagT"/>
  1019. <template-type-parameter name="SeverityT"/>
  1020. <template-type-parameter name="SeverityFallbackT"/>
  1021. <template-type-parameter name="SeverityTagT"/>
  1022. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1023. <template-type-parameter name="SeverityCompareT"/>
  1024. <template-type-parameter name="ChannelOrderT"/>
  1025. </template><parameter name="channel_placeholder"><paramtype><classname>attribute_actor</classname>&lt; ChannelT, ChannelFallbackT, ChannelTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_placeholder"><paramtype><classname>attribute_actor</classname>&lt; SeverityT, SeverityFallbackT, SeverityTagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="severity_compare"><paramtype>SeverityCompareT const &amp;</paramtype></parameter><parameter name="channel_order"><paramtype>ChannelOrderT const &amp;</paramtype></parameter></signature><description><para>The function generates a filtering predicate that checks the severity levels of log records in different channels. The predicate will return <computeroutput>true</computeroutput> if the record severity level is not less than the threshold for the channel the record belongs to. </para></description></overloaded-function>
  1026. </namespace>
  1027. </namespace>
  1028. </namespace>
  1029. </header>
  1030. <header name="boost/log/expressions/predicates/contains.hpp">
  1031. <para><para>Andrey Semashev </para>
  1032. <para>02.09.2012</para>
  1033. The header contains implementation of a <computeroutput>contains</computeroutput> predicate in template expressions. </para><namespace name="boost">
  1034. <namespace name="log">
  1035. <namespace name="expressions">
  1036. <typedef name="attribute_contains"><description><para>The predicate checks if the attribute value contains a substring. The attribute value is assumed to be of a string type. </para></description><type><emphasis>unspecified</emphasis></type></typedef>
  1037. <function name="contains"><type><emphasis>unspecified</emphasis></type><template>
  1038. <template-type-parameter name="T"/>
  1039. <template-type-parameter name="FallbackPolicyT"/>
  1040. <template-type-parameter name="TagT"/>
  1041. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1042. <template-type-parameter name="SubstringT"/>
  1043. </template><parameter name="attr"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, contains the specified substring. </para></description></function>
  1044. <function name="contains"><type><emphasis>unspecified</emphasis></type><template>
  1045. <template-type-parameter name="DescriptorT"/>
  1046. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1047. <template-type-parameter name="SubstringT"/>
  1048. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, contains the specified substring. </para></description></function>
  1049. <function name="contains"><type><emphasis>unspecified</emphasis></type><template>
  1050. <template-type-parameter name="T"/>
  1051. <template-type-parameter name="SubstringT"/>
  1052. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, contains the specified substring. </para></description></function>
  1053. </namespace>
  1054. </namespace>
  1055. </namespace>
  1056. </header>
  1057. <header name="boost/log/expressions/predicates/ends_with.hpp">
  1058. <para><para>Andrey Semashev </para>
  1059. <para>02.09.2012</para>
  1060. The header contains implementation of a <computeroutput>ends_with</computeroutput> predicate in template expressions. </para><namespace name="boost">
  1061. <namespace name="log">
  1062. <namespace name="expressions">
  1063. <typedef name="attribute_ends_with"><description><para>The predicate checks if the attribute value ends with a substring. The attribute value is assumed to be of a string type. </para></description><type><emphasis>unspecified</emphasis></type></typedef>
  1064. <function name="ends_with"><type><emphasis>unspecified</emphasis></type><template>
  1065. <template-type-parameter name="T"/>
  1066. <template-type-parameter name="FallbackPolicyT"/>
  1067. <template-type-parameter name="TagT"/>
  1068. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1069. <template-type-parameter name="SubstringT"/>
  1070. </template><parameter name="attr"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, ends with the specified substring. </para></description></function>
  1071. <function name="ends_with"><type><emphasis>unspecified</emphasis></type><template>
  1072. <template-type-parameter name="DescriptorT"/>
  1073. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1074. <template-type-parameter name="SubstringT"/>
  1075. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, ends with the specified substring. </para></description></function>
  1076. <function name="ends_with"><type><emphasis>unspecified</emphasis></type><template>
  1077. <template-type-parameter name="T"/>
  1078. <template-type-parameter name="SubstringT"/>
  1079. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="substring"><paramtype>SubstringT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, ends with the specified substring. </para></description></function>
  1080. </namespace>
  1081. </namespace>
  1082. </namespace>
  1083. </header>
  1084. <header name="boost/log/expressions/predicates/has_attr.hpp">
  1085. <para><para>Andrey Semashev </para>
  1086. <para>23.07.2012</para>
  1087. The header contains implementation of a generic attribute presence checker in template expressions. </para><namespace name="boost">
  1088. <namespace name="log">
  1089. <namespace name="expressions">
  1090. <class name="has_attribute"><template>
  1091. <template-type-parameter name="T"/>
  1092. </template><description><para>An attribute value presence checker. </para></description><typedef name="result_type"><purpose>Function result_type. </purpose><type>bool</type></typedef>
  1093. <typedef name="value_type"><purpose>Expected attribute value type. </purpose><type>T</type></typedef>
  1094. <method-group name="public member functions">
  1095. <method name="operator()" cv="const"><type>result_type</type><template>
  1096. <template-type-parameter name="ArgT"/>
  1097. </template><parameter name="arg"><paramtype>ArgT const &amp;</paramtype><description><para>A set of attribute values or a log record </para></description></parameter><description><para>Checking operator</para><para>
  1098. </para></description><returns><para><computeroutput>true</computeroutput> if the log record contains the sought attribute value, <computeroutput>false</computeroutput> otherwise </para>
  1099. </returns></method>
  1100. </method-group>
  1101. <constructor specifiers="explicit"><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><description><para>Initializing constructor</para><para>
  1102. </para></description></constructor>
  1103. </class><class-specialization name="has_attribute"><template>
  1104. </template><specialization><template-arg>void</template-arg></specialization><description><para>An attribute value presence checker. This specialization does not check the type of the attribute value. </para></description><typedef name="result_type"><purpose>Function result_type. </purpose><type>bool</type></typedef>
  1105. <typedef name="value_type"><purpose>Expected attribute value type. </purpose><type>void</type></typedef>
  1106. <method-group name="public member functions">
  1107. <method name="operator()" cv="const"><type>result_type</type><parameter name="attrs"><paramtype>attribute_value_set const &amp;</paramtype><description><para>A set of attribute values </para></description></parameter><description><para>Checking operator</para><para>
  1108. </para></description><returns><para><computeroutput>true</computeroutput> if the log record contains the sought attribute value, <computeroutput>false</computeroutput> otherwise </para>
  1109. </returns></method>
  1110. <method name="operator()" cv="const"><type>result_type</type><parameter name="rec"><paramtype>boost::log::record_view const &amp;</paramtype><description><para>A log record </para></description></parameter><description><para>Checking operator</para><para>
  1111. </para></description><returns><para><computeroutput>true</computeroutput> if the log record contains the sought attribute value, <computeroutput>false</computeroutput> otherwise </para>
  1112. </returns></method>
  1113. </method-group>
  1114. <constructor specifiers="explicit"><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><description><para>Initializing constructor</para><para>
  1115. </para></description></constructor>
  1116. </class-specialization>
  1117. <function name="has_attr"><type><emphasis>unspecified</emphasis></type><template>
  1118. <template-type-parameter name="AttributeValueT"/>
  1119. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check for the attribute value presence in a log record. The node will also check that the attribute value has the specified type, if present.</para><para>The function generates a terminal node in a template expression. The node will check for the attribute value presence in a log record. </para></description></function>
  1120. <function name="has_attr"><type><emphasis>unspecified</emphasis></type><template>
  1121. <template-type-parameter name="DescriptorT"/>
  1122. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1123. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check for the attribute value presence in a log record. The node will also check that the attribute value has the specified type, if present. </para></description></function>
  1124. </namespace>
  1125. </namespace>
  1126. </namespace>
  1127. </header>
  1128. <header name="boost/log/expressions/predicates/is_debugger_present.hpp">
  1129. <para><para>Andrey Semashev </para>
  1130. <para>05.12.2012</para>
  1131. The header contains implementation of the <computeroutput>is_debugger_present</computeroutput> predicate in template expressions. </para></header>
  1132. <header name="boost/log/expressions/predicates/is_in_range.hpp">
  1133. <para><para>Andrey Semashev </para>
  1134. <para>02.09.2012</para>
  1135. The header contains implementation of an <computeroutput>is_in_range</computeroutput> predicate in template expressions. </para><namespace name="boost">
  1136. <namespace name="log">
  1137. <namespace name="expressions">
  1138. <typedef name="attribute_is_in_range"><description><para>The predicate checks if the attribute value contains a substring. The attribute value is assumed to be of a string type. </para></description><type><emphasis>unspecified</emphasis></type></typedef>
  1139. <function name="is_in_range"><type><emphasis>unspecified</emphasis></type><template>
  1140. <template-type-parameter name="T"/>
  1141. <template-type-parameter name="FallbackPolicyT"/>
  1142. <template-type-parameter name="TagT"/>
  1143. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1144. <template-type-parameter name="BoundaryT"/>
  1145. </template><parameter name="attr"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="least"><paramtype>BoundaryT const &amp;</paramtype></parameter><parameter name="most"><paramtype>BoundaryT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value is in the specified range. The range must be half-open, that is the predicate will be equivalent to <computeroutput>least &lt;= attr &lt; most</computeroutput>. </para></description></function>
  1146. <function name="is_in_range"><type><emphasis>unspecified</emphasis></type><template>
  1147. <template-type-parameter name="DescriptorT"/>
  1148. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1149. <template-type-parameter name="BoundaryT"/>
  1150. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="least"><paramtype>BoundaryT const &amp;</paramtype></parameter><parameter name="most"><paramtype>BoundaryT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value is in the specified range. The range must be half-open, that is the predicate will be equivalent to <computeroutput>least &lt;= attr &lt; most</computeroutput>. </para></description></function>
  1151. <function name="is_in_range"><type><emphasis>unspecified</emphasis></type><template>
  1152. <template-type-parameter name="T"/>
  1153. <template-type-parameter name="BoundaryT"/>
  1154. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="least"><paramtype>BoundaryT const &amp;</paramtype></parameter><parameter name="most"><paramtype>BoundaryT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value is in the specified range. The range must be half-open, that is the predicate will be equivalent to <computeroutput>least &lt;= attr &lt; most</computeroutput>. </para></description></function>
  1155. </namespace>
  1156. </namespace>
  1157. </namespace>
  1158. </header>
  1159. <header name="boost/log/expressions/predicates/matches.hpp">
  1160. <para><para>Andrey Semashev </para>
  1161. <para>02.09.2012</para>
  1162. The header contains implementation of a <computeroutput>matches</computeroutput> predicate in template expressions. </para><namespace name="boost">
  1163. <namespace name="log">
  1164. <namespace name="expressions">
  1165. <class name="attribute_matches"><template>
  1166. <template-type-parameter name="T"/>
  1167. <template-type-parameter name="RegexT"/>
  1168. <template-type-parameter name="FallbackPolicyT"><default>fallback_to_none</default></template-type-parameter>
  1169. </template><description><para>The predicate checks if the attribute value matches a regular expression. The attribute value is assumed to be of a string type. </para></description><method-group name="public member functions">
  1170. </method-group>
  1171. <constructor><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="rex"><paramtype>RegexT const &amp;</paramtype><description><para>The regular expression to match the attribute value against </para></description></parameter><description><para>Initializing constructor</para><para>
  1172. </para></description></constructor>
  1173. <constructor><template>
  1174. <template-type-parameter name="U"/>
  1175. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype><description><para>Attribute name </para></description></parameter><parameter name="rex"><paramtype>RegexT const &amp;</paramtype><description><para>The regular expression to match the attribute value against </para></description></parameter><parameter name="arg"><paramtype>U const &amp;</paramtype><description><para>Additional parameter for the fallback policy </para></description></parameter><description><para>Initializing constructor</para><para>
  1176. </para></description></constructor>
  1177. </class>
  1178. <function name="matches"><type><emphasis>unspecified</emphasis></type><template>
  1179. <template-type-parameter name="T"/>
  1180. <template-type-parameter name="FallbackPolicyT"/>
  1181. <template-type-parameter name="TagT"/>
  1182. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1183. <template-type-parameter name="RegexT"/>
  1184. </template><parameter name="attr"><paramtype><classname>attribute_actor</classname>&lt; T, FallbackPolicyT, TagT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="rex"><paramtype>RegexT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, matches the specified regular expression. </para></description></function>
  1185. <function name="matches"><type><emphasis>unspecified</emphasis></type><template>
  1186. <template-type-parameter name="DescriptorT"/>
  1187. <template-nontype-parameter name="ActorT"><type>template&lt; typename &gt; class</type></template-nontype-parameter>
  1188. <template-type-parameter name="RegexT"/>
  1189. </template><parameter name=""><paramtype><classname>attribute_keyword</classname>&lt; DescriptorT, ActorT &gt; const &amp;</paramtype></parameter><parameter name="rex"><paramtype>RegexT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, matches the specified regular expression. </para></description></function>
  1190. <function name="matches"><type><emphasis>unspecified</emphasis></type><template>
  1191. <template-type-parameter name="T"/>
  1192. <template-type-parameter name="RegexT"/>
  1193. </template><parameter name="name"><paramtype>attribute_name const &amp;</paramtype></parameter><parameter name="rex"><paramtype>RegexT const &amp;</paramtype></parameter><description><para>The function generates a terminal node in a template expression. The node will check if the attribute value, which is assumed to be a string, matches the specified regular expression. </para></description></function>
  1194. </namespace>
  1195. </namespace>
  1196. </namespace>
  1197. </header>
  1198. <header name="boost/log/expressions/record.hpp">
  1199. <para><para>Andrey Semashev </para>
  1200. <para>25.07.2012</para>
  1201. The header contains implementation of a log record placeholder in template expressions. </para><namespace name="boost">
  1202. <namespace name="log">
  1203. <namespace name="expressions">
  1204. <typedef name="record_type"><description><para>Log record placeholder type in formatter template expressions. </para></description><type>phoenix::expression::argument&lt; 1 &gt;::type</type></typedef>
  1205. <data-member name="record"><type>const record_type</type><description><para>Log record placeholder in formatter template expressions. </para></description></data-member>
  1206. </namespace>
  1207. </namespace>
  1208. </namespace>
  1209. </header>
  1210. </library-reference>