pipable.html 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Pipable</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../boost.css">
  6. <LINK REL="stylesheet" HREF="../theme/iostreams.css">
  7. </HEAD>
  8. <BODY>
  9. <!-- Begin Banner -->
  10. <H1 CLASS="title">Pipable</H1>
  11. <HR CLASS="banner">
  12. <!-- End Banner -->
  13. <H2>Description</H2>
  14. <P>
  15. A Pipable Filter can appear as a component of a <A HREF="../guide/pipelines.html">pipline</A>.
  16. </P>
  17. <P>
  18. Certian overloads of <CODE>operator|</CODE> must be defined to make a Filter Pipable; this is achieved by invoking the macro <A HREF="../guide/pipelines.html#boost_iostreams_pipable"><CODE>BOOST_IOSTREAMS_PIPABLE</CODE></A>.
  19. </P>
  20. <H2>Refinement of</H2>
  21. <A HREF="filter.html">Filter</A>.
  22. <A NAME="types"></A>
  23. <H2>Associated Types</H2>
  24. Same as <A HREF="filter.html">Filter</A>.
  25. <H2>Notation</H2>
  26. <TABLE CELLPADDING="2">
  27. <TR><TD><CODE>P</CODE></TD><TD>-</TD><TD>A type which is a model of Pipable</TD></TR>
  28. <TR><TD><CODE>C</CODE></TD><TD>-</TD><TD>A type which is a model of <A HREF="filter.html">Filter</A> or <A HREF="device.html">Device</A> and which is <A HREF="../../../../doc/html/CopyConstructible.html" TARGET="_top">CopyConstructible</A><A CLASS='footnote_ref' NAME='note_1_ref' HREF="#note_1"><SUP>[1]</A></SUP></TD></TR>
  29. <TR><TD><CODE>p</CODE></TD><TD>-</TD><TD>Object of type <CODE>P</CODE></TD></TR>
  30. <TR><TD><CODE>c</CODE></TD><TD>-</TD><TD>Object of type <CODE>C</CODE></TD></TR>
  31. </TABLE>
  32. <H2>Valid Expressions / Semantics</H2>
  33. <TABLE CELLPADDING="5" BORDER="1">
  34. <TR><TH>Expression</TH><TH>Expression Type</TH><TH>Semantics</TH></TR>
  35. <TR>
  36. <TD>
  37. <PRE CLASS="plain_code"><CODE>f | c</CODE></PRE>
  38. </TD>
  39. <TD><I>implementation-defined</I></TD>
  40. <TD>
  41. Returns a pipeline corresponding to the sequence <CODE>f</CODE>, <CODE>c</CODE>
  42. </TD>
  43. </TR>
  44. </TABLE>
  45. <H2>Exceptions</H2>
  46. <P>
  47. None.
  48. </P>
  49. <H2>Models</H2>
  50. <UL>
  51. <LI>All the Filters provided by the Iostreams library.
  52. </UL>
  53. <!-- Begin Footnotes -->
  54. <HR>
  55. <P>
  56. <A CLASS="footnote_ref" NAME="note_1" HREF="#note_1_ref"><SUP>[1]</SUP></A>This requirement prevents streams and stream buffers from appearing in pipelines without the use of <A HREF="../../../../doc/html/ref.html">reference wrappers</A>. This restriction may be removed in a future version of the Iostreams library.
  57. </P>
  58. <!-- End Footnotes -->
  59. <!-- Begin Footer -->
  60. <HR>
  61. <P CLASS="copyright">&copy; Copyright 2008 <a href="http://www.coderage.com/" target="_top">CodeRage, LLC</a><br/>&copy; Copyright 2004-2007 <a href="https://www.boost.org/users/people/jonathan_turkanis.html" target="_top">Jonathan Turkanis</a></P>
  62. <P CLASS="copyright">
  63. Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at <A HREF="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)
  64. </P>
  65. <!-- End Footer -->
  66. </BODY>