1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

package Torello.Java.Additional;

/**
 * This class is used to shunt text-output sent to a Java <CODE>Appendable</CODE>; note that this
 * <CODE>Appendable</CODE> <I>can be tapped,</I> allowing for saving text-output, without printing
 * it.
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=NOPRINT>
 */
@Torello.JavaDoc.JDHeaderBackgroundImg(EmbedTagFileID={"APPENDABLE_EXTENSION", "NOPRINT_JDHBI"})
public class NOPRINT implements Appendable
{
    /**
     * This is the externalized, singleton instance of this class.  This class does not have any
     * {@code public} constructors.
     */
    public static final NOPRINT np = new NOPRINT();

    protected NOPRINT() { }

    /**
     * Does nothing.  Returns {@code 'this'} instance.
     * @param cs Dummy input.  Ignored, completely.
     * @param start Dummy input.  Ignored, completely.
     * @param end dummy input. Ignored, completely.
     * @return {@code 'this'} instance is returned.
     */
    public Appendable append(CharSequence cs, int start, int end)
    { return this; }

    /**
     * Does nothing.  Return {@code 'this'} instance.
     * @param cs dummy input.  Ignored.
     * @return {@code 'this'} instance is returned.
     */
    public Appendable append(CharSequence cs)
    { return this; }

    /**
     * Does nothing.  Returns {@code 'this'} instance.
     * @param c Dummy input.  Ignored, completely.
     * @return {@code 'this'} instance is returned.
     */
    public Appendable append(char c)
    { return this; }
}