htmlparser/jericho/StringOutputSegment.java

// Jericho HTML Parser - Java based library for analysing and manipulating HTML
// Version 3.2
// Copyright (C) 2004-2009 Martin Jericho
// http://jericho.htmlparser.net/
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of either one of the following licences:
//
// 1. The Eclipse Public License (EPL) version 1.0,
// included in this distribution in the file licence-epl-1.0.html
// or available at http://www.eclipse.org/legal/epl-v10.html
//
// 2. The GNU Lesser General Public License (LGPL) version 2.1 or later,
// included in this distribution in the file licence-lgpl-2.1.txt
// or available at http://www.gnu.org/licenses/lgpl.txt
//
// This library is distributed on an "AS IS" basis,
// WITHOUT WARRANTY OF ANY KIND, either express or implied.
// See the individual licence texts for more details.

package net.htmlparser.jericho;

import java.io.*;

/**
 * Implements an {@link OutputSegment} whose content is a <code>CharSequence</code>.
 * <p>
 * This class has been removed from the pulic API and the functionality replaced with the
 * {@link OutputDocument#replace(Segment, CharSequence text)} method.
 */
final class StringOutputSegment implements OutputSegment {
        private final int begin;
        private final int end;
        private final CharSequence text;

        /**
         * Constructs a new <code>StringOutputSegment</code> with the specified begin and end positions and the specified content.
         * <p>
         * Specifying a <code>null</code> argument to the <code>text</code> parameter is exactly equivalent to specifying an empty string,
         * and results in the segment being completely removed from the output document.
         *
         * @param begin  the position in the <code>OutputDocument</code> where this output segment begins.
         * @param end  the position in the <code>OutputDocument</code> where this output segment ends.
         * @param text  the textual content of the new output segment, or <code>null</code> if no content.
         */
        public StringOutputSegment(final int begin, final int end, final CharSequence text) {
                this.begin=begin;
                this.end=end;
                this.text=(text==null ? "" : text);
        }

        /**
         * Constructs a new StringOutputSegment</code> with the same span as the specified {@link Segment}.
         * <p>
         * Specifying a <code>null</code> argument to the <code>text</code> parameter is exactly equivalent to specifying an empty string,
         * and results in the segment being completely removed from the output document.
         *
         * @param segment  a segment defining the beginning and ending positions of the new output segment.
         * @param text  the textual content of the new output segment, or <code>null</code> if no content.
         */
        public StringOutputSegment(final Segment segment, final CharSequence text) {
                this(segment.begin,segment.end,text);
        }

        public int getBegin() {
                return begin;
        }

        public int getEnd() {
                return end;
        }

        public void writeTo(final Writer writer) throws IOException {
                appendTo(writer);
        }

        public void appendTo(final Appendable appendable) throws IOException {
                appendable.append(text);
        }

        public long getEstimatedMaximumOutputLength() {
                return text.length();
        }

        public String toString() {
                return text.toString();
        }

        public String getDebugInfo() {
                return "Replace: (p"+begin+"-p"+end+") "+text;
        }

        public void output(final Writer writer) throws IOException {
                writeTo(writer);
        }
}
1	// Jericho HTML Parser - Java based library for analysing and manipulating HTML
2	// Version 3.2
3	// Copyright (C) 2004-2009 Martin Jericho
4	// http://jericho.htmlparser.net/
5	//
6	// This library is free software; you can redistribute it and/or
7	// modify it under the terms of either one of the following licences:
8	//
9	// 1. The Eclipse Public License (EPL) version 1.0,
10	// included in this distribution in the file licence-epl-1.0.html
11	// or available at http://www.eclipse.org/legal/epl-v10.html
12	//
13	// 2. The GNU Lesser General Public License (LGPL) version 2.1 or later,
14	// included in this distribution in the file licence-lgpl-2.1.txt
15	// or available at http://www.gnu.org/licenses/lgpl.txt
16	//
17	// This library is distributed on an "AS IS" basis,
18	// WITHOUT WARRANTY OF ANY KIND, either express or implied.
19	// See the individual licence texts for more details.
20
21	package net.htmlparser.jericho;
22
23	import java.io.*;
24
25	/**
26	* Implements an {@link OutputSegment} whose content is a <code>CharSequence</code>.
27	* <p>
28	* This class has been removed from the pulic API and the functionality replaced with the
29	* {@link OutputDocument#replace(Segment, CharSequence text)} method.
30	*/
31	final class StringOutputSegment implements OutputSegment {
32	private final int begin;
33	private final int end;
34	private final CharSequence text;
35
36	/**
37	* Constructs a new <code>StringOutputSegment</code> with the specified begin and end positions and the specified content.
38	* <p>
39	* Specifying a <code>null</code> argument to the <code>text</code> parameter is exactly equivalent to specifying an empty string,
40	* and results in the segment being completely removed from the output document.
41	*
42	* @param begin the position in the <code>OutputDocument</code> where this output segment begins.
43	* @param end the position in the <code>OutputDocument</code> where this output segment ends.
44	* @param text the textual content of the new output segment, or <code>null</code> if no content.
45	*/
46	public StringOutputSegment(final int begin, final int end, final CharSequence text) {
47	this.begin=begin;
48	this.end=end;
49	this.text=(text==null ? "" : text);
50	}
51
52	/**
53	* Constructs a new StringOutputSegment</code> with the same span as the specified {@link Segment}.
54	* <p>
55	* Specifying a <code>null</code> argument to the <code>text</code> parameter is exactly equivalent to specifying an empty string,
56	* and results in the segment being completely removed from the output document.
57	*
58	* @param segment a segment defining the beginning and ending positions of the new output segment.
59	* @param text the textual content of the new output segment, or <code>null</code> if no content.
60	*/
61	public StringOutputSegment(final Segment segment, final CharSequence text) {
62	this(segment.begin,segment.end,text);
63	}
64
65	public int getBegin() {
66	return begin;
67	}
68
69	public int getEnd() {
70	return end;
71	}
72
73	public void writeTo(final Writer writer) throws IOException {
74	appendTo(writer);
75	}
76
77	public void appendTo(final Appendable appendable) throws IOException {
78	appendable.append(text);
79	}
80
81	public long getEstimatedMaximumOutputLength() {
82	return text.length();
83	}
84
85	public String toString() {
86	return text.toString();
87	}
88
89	public String getDebugInfo() {
90	return "Replace: (p"+begin+"-p"+end+") "+text;
91	}
92
93	public void output(final Writer writer) throws IOException {
94	writeTo(writer);
95	}
96	}