Out.php 3.4KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  1. <?php
  2. /**
  3. * Hoa
  4. *
  5. *
  6. * @license
  7. *
  8. * New BSD License
  9. *
  10. * Copyright © 2007-2017, Hoa community. All rights reserved.
  11. *
  12. * Redistribution and use in source and binary forms, with or without
  13. * modification, are permitted provided that the following conditions are met:
  14. * * Redistributions of source code must retain the above copyright
  15. * notice, this list of conditions and the following disclaimer.
  16. * * Redistributions in binary form must reproduce the above copyright
  17. * notice, this list of conditions and the following disclaimer in the
  18. * documentation and/or other materials provided with the distribution.
  19. * * Neither the name of the Hoa nor the names of its contributors may be
  20. * used to endorse or promote products derived from this software without
  21. * specific prior written permission.
  22. *
  23. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  24. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE
  27. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  28. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  29. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  30. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  31. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  32. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  33. * POSSIBILITY OF SUCH DAMAGE.
  34. */
  35. namespace Hoa\Stream\IStream;
  36. /**
  37. * Interface \Hoa\Stream\IStream\Out.
  38. *
  39. * Interface for output.
  40. *
  41. * @copyright Copyright © 2007-2017 Hoa community
  42. * @license New BSD License
  43. */
  44. interface Out extends Stream
  45. {
  46. /**
  47. * Write n characters.
  48. *
  49. * @param string $string String.
  50. * @param int $length Length.
  51. * @return mixed
  52. */
  53. public function write($string, $length);
  54. /**
  55. * Write a string.
  56. *
  57. * @param string $string String.
  58. * @return mixed
  59. */
  60. public function writeString($string);
  61. /**
  62. * Write a character.
  63. *
  64. * @param string $character Character.
  65. * @return mixed
  66. */
  67. public function writeCharacter($character);
  68. /**
  69. * Write a boolean.
  70. *
  71. * @param bool $boolean Boolean.
  72. * @return mixed
  73. */
  74. public function writeBoolean($boolean);
  75. /**
  76. * Write an integer.
  77. *
  78. * @param int $integer Integer.
  79. * @return mixed
  80. */
  81. public function writeInteger($integer);
  82. /**
  83. * Write a float.
  84. *
  85. * @param float $float Float.
  86. * @return mixed
  87. */
  88. public function writeFloat($float);
  89. /**
  90. * Write an array.
  91. *
  92. * @param array $array Array.
  93. * @return mixed
  94. */
  95. public function writeArray(array $array);
  96. /**
  97. * Write a line.
  98. *
  99. * @param string $line Line.
  100. * @return mixed
  101. */
  102. public function writeLine($line);
  103. /**
  104. * Write all, i.e. as much as possible.
  105. *
  106. * @param string $string String.
  107. * @return mixed
  108. */
  109. public function writeAll($string);
  110. /**
  111. * Truncate a stream to a given length.
  112. *
  113. * @param int $size Size.
  114. * @return bool
  115. */
  116. public function truncate($size);
  117. }