Back to index...

	/*
	* reserved comment block
	* DO NOT REMOVE OR ALTER!
	*/
	/*
	* Licensed to the Apache Software Foundation (ASF) under one or more
	* contributor license agreements. See the NOTICE file distributed with
	* this work for additional information regarding copyright ownership.
	* The ASF licenses this file to You under the Apache License, Version 2.0
	* (the "License"); you may not use this file except in compliance with
	* the License. You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package com.sun.org.apache.xpath.internal.objects;

	import com.sun.org.apache.xalan.internal.res.XSLMessages;
	import com.sun.org.apache.xml.internal.utils.FastStringBuffer;
	import com.sun.org.apache.xpath.internal.res.XPATHErrorResources;


	/**
	* This class will wrap a FastStringBuffer and allow for
	*/
	public class XStringForChars extends XString
	{
	static final long serialVersionUID = -2235248887220850467L;
	/** The start position in the fsb. */
	int m_start;

	/** The length of the string. */
	int m_length;

	protected String m_strCache = null;

	/**
	* Construct a XNodeSet object.
	*
	* @param val FastStringBuffer object this will wrap, must be non-null.
	* @param start The start position in the array.
	* @param length The number of characters to read from the array.
	*/
	public XStringForChars(char[] val, int start, int length)
	{
	super(val);
	m_start = start;
	m_length = length;
	if(null == val)
	throw new IllegalArgumentException(
	XSLMessages.createXPATHMessage(XPATHErrorResources.ER_FASTSTRINGBUFFER_CANNOT_BE_NULL, null)); //"The FastStringBuffer argument can not be null!!");
	}


	/**
	* Construct a XNodeSet object.
	*
	* @param val String object this will wrap.
	*/
	private XStringForChars(String val)
	{
	super(val);
	throw new IllegalArgumentException(
	XSLMessages.createXPATHMessage(XPATHErrorResources.ER_XSTRINGFORCHARS_CANNOT_TAKE_STRING, null)); //"XStringForChars can not take a string for an argument!");
	}

	/**
	* Cast result object to a string.
	*
	* @return The string this wraps or the empty string if null
	*/
	public FastStringBuffer fsb()
	{
	throw new RuntimeException(XSLMessages.createXPATHMessage(XPATHErrorResources.ER_FSB_NOT_SUPPORTED_XSTRINGFORCHARS, null)); //"fsb() not supported for XStringForChars!");
	}

	/**
	* Cast result object to a string.
	*
	* @return The string this wraps or the empty string if null
	*/
	public void appendToFsb(com.sun.org.apache.xml.internal.utils.FastStringBuffer fsb)
	{
	fsb.append((char[])m_obj, m_start, m_length);
	}


	/**
	* Tell if this object contains a java String object.
	*
	* @return true if this XMLString can return a string without creating one.
	*/
	public boolean hasString()
	{
	return (null != m_strCache);
	}


	/**
	* Cast result object to a string.
	*
	* @return The string this wraps or the empty string if null
	*/
	public String str()
	{
	if(null == m_strCache)
	m_strCache = new String((char[])m_obj, m_start, m_length);

	return m_strCache;
	}


	/**
	* Since this object is incomplete without the length and the offset, we
	* have to convert to a string when this function is called.
	*
	* @return The java String representation of this object.
	*/
	public Object object()
	{
	return str();
	}

	/**
	* Directly call the
	* characters method on the passed ContentHandler for the
	* string-value. Multiple calls to the
	* ContentHandler's characters methods may well occur for a single call to
	* this method.
	*
	* @param ch A non-null reference to a ContentHandler.
	*
	* @throws org.xml.sax.SAXException
	*/
	public void dispatchCharactersEvents(org.xml.sax.ContentHandler ch)
	throws org.xml.sax.SAXException
	{
	ch.characters((char[])m_obj, m_start, m_length);
	}

	/**
	* Directly call the
	* comment method on the passed LexicalHandler for the
	* string-value.
	*
	* @param lh A non-null reference to a LexicalHandler.
	*
	* @throws org.xml.sax.SAXException
	*/
	public void dispatchAsComment(org.xml.sax.ext.LexicalHandler lh)
	throws org.xml.sax.SAXException
	{
	lh.comment((char[])m_obj, m_start, m_length);
	}

	/**
	* Returns the length of this string.
	*
	* @return the length of the sequence of characters represented by this
	* object.
	*/
	public int length()
	{
	return m_length;
	}

	/**
	* Returns the character at the specified index. An index ranges
	* from <code>0</code> to <code>length() - 1</code>. The first character
	* of the sequence is at index <code>0</code>, the next at index
	* <code>1</code>, and so on, as for array indexing.
	*
	* @param index the index of the character.
	* @return the character at the specified index of this string.
	* The first character is at index <code>0</code>.
	* @exception IndexOutOfBoundsException if the <code>index</code>
	* argument is negative or not less than the length of this
	* string.
	*/
	public char charAt(int index)
	{
	return ((char[])m_obj)[index+m_start];
	}

	/**
	* Copies characters from this string into the destination character
	* array.
	*
	* @param srcBegin index of the first character in the string
	* to copy.
	* @param srcEnd index after the last character in the string
	* to copy.
	* @param dst the destination array.
	* @param dstBegin the start offset in the destination array.
	* @exception IndexOutOfBoundsException If any of the following
	* is true:
	* <ul><li><code>srcBegin</code> is negative.
	* <li><code>srcBegin</code> is greater than <code>srcEnd</code>
	* <li><code>srcEnd</code> is greater than the length of this
	* string
	* <li><code>dstBegin</code> is negative
	* <li><code>dstBegin+(srcEnd-srcBegin)</code> is larger than
	* <code>dst.length</code></ul>
	* @exception NullPointerException if <code>dst</code> is <code>null</code>
	*/
	public void getChars(int srcBegin, int srcEnd, char dst[], int dstBegin)
	{
	System.arraycopy((char[])m_obj, m_start+srcBegin, dst, dstBegin, srcEnd);
	}

	}

Back to index...