1 package nom.tam.util;
2
3 /*
4 * #%L
5 * nom.tam FITS library
6 * %%
7 * Copyright (C) 1996 - 2024 nom-tam-fits
8 * %%
9 * This is free and unencumbered software released into the public domain.
10 *
11 * Anyone is free to copy, modify, publish, use, compile, sell, or
12 * distribute this software, either in source code form or as a compiled
13 * binary, for any purpose, commercial or non-commercial, and by any
14 * means.
15 *
16 * In jurisdictions that recognize copyright laws, the author or authors
17 * of this software dedicate any and all copyright interest in the
18 * software to the public domain. We make this dedication for the benefit
19 * of the public at large and to the detriment of our heirs and
20 * successors. We intend this dedication to be an overt act of
21 * relinquishment in perpetuity of all present and future rights to this
22 * software under copyright law.
23 *
24 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
27 * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
28 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
29 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
30 * OTHER DEALINGS IN THE SOFTWARE.
31 * #L%
32 */
33
34 import java.io.IOException;
35 import java.io.OutputStream;
36
37 /**
38 * Interface for basic binary output writing functionality.
39 *
40 * @author Attila Kovacs
41 * @since 1.16
42 * @see InputReader
43 */
44 public interface OutputWriter {
45
46 /**
47 * Writes a byte. See the general contract of
48 * {@link java.io.DataOutputStream#write(int)}.
49 *
50 * @param b
51 * the (unsigned) byte value to write.
52 * @throws IOException
53 * if there was an underlying IO error
54 * @see java.io.DataOutputStream#write(int)
55 */
56 void write(int b) throws IOException;
57
58 /**
59 * Writes up to the specified number of bytes from a buffer to the stream.
60 * See the general contract of
61 * {@link java.io.DataOutputStream#write(byte[], int, int)}.
62 *
63 * @param b
64 * the buffer
65 * @param from
66 * the starting buffer index
67 * @param length
68 * the number of bytes to write.
69 * @throws IOException
70 * if there was an underlying IO error
71 * @see java.io.DataOutputStream#write(byte[], int, int)
72 */
73 void write(byte[] b, int from, int length) throws IOException;
74
75 /**
76 * Wraps an output stream with this interface.
77 *
78 * @param o
79 * any output stream
80 * @return the stream wrapped to this interface
81 */
82 static OutputWriter from(final OutputStream o) {
83 return new OutputWriter() {
84
85 @Override
86 public void write(int b) throws IOException {
87 o.write(b);
88 }
89
90 @Override
91 public void write(byte[] b, int from, int length) throws IOException {
92 o.write(b, from, length);
93 }
94 };
95 }
96 }