|
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ |
|
2 /* This Source Code Form is subject to the terms of the Mozilla Public |
|
3 * License, v. 2.0. If a copy of the MPL was not distributed with this |
|
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
|
5 |
|
6 #include "nsIInputStream.idl" |
|
7 |
|
8 /** |
|
9 * The multiplex stream concatenates a list of input streams into a single |
|
10 * stream. |
|
11 */ |
|
12 |
|
13 [scriptable, uuid(a076fd12-1dd1-11b2-b19a-d53b5dffaade)] |
|
14 interface nsIMultiplexInputStream : nsIInputStream |
|
15 { |
|
16 /** |
|
17 * Number of streams in this multiplex-stream |
|
18 */ |
|
19 readonly attribute unsigned long count; |
|
20 |
|
21 /** |
|
22 * Appends a stream to the end of the streams. The cursor of the stream |
|
23 * should be located at the beginning of the stream if the implementation |
|
24 * of this nsIMultiplexInputStream also is used as an nsISeekableStream. |
|
25 * @param stream stream to append |
|
26 */ |
|
27 void appendStream(in nsIInputStream stream); |
|
28 |
|
29 /** |
|
30 * Insert a stream at specified index. If the cursor of this stream is at |
|
31 * the beginning of the stream at index, the cursor will be placed at the |
|
32 * beginning of the inserted stream instead. |
|
33 * The cursor of the new stream should be located at the beginning of the |
|
34 * stream if the implementation of this nsIMultiplexInputStream also is |
|
35 * used as an nsISeekableStream. |
|
36 * @param stream stream to insert |
|
37 * @param index index to insert stream at, must be <= count |
|
38 */ |
|
39 void insertStream(in nsIInputStream stream, in unsigned long index); |
|
40 |
|
41 /** |
|
42 * Remove stream at specified index. If this stream is the one currently |
|
43 * being read the readcursor is moved to the beginning of the next |
|
44 * stream |
|
45 * @param index remove stream at this index, must be < count |
|
46 */ |
|
47 void removeStream(in unsigned long index); |
|
48 |
|
49 /** |
|
50 * Get stream at specified index. |
|
51 * @param index return stream at this index, must be < count |
|
52 * @return stream at specified index |
|
53 */ |
|
54 nsIInputStream getStream(in unsigned long index); |
|
55 }; |