/*
 *  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
 *
 *      https://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 org.apache.tools.ant.taskdefs.optional.depend.constantpool;

import java.io.DataInputStream;
import java.io.IOException;

A String Constant Pool Entry. The String info contains an index into the
constant pool where a UTF8 string is stored.
/**
 * A String Constant Pool Entry. The String info contains an index into the
 * constant pool where a UTF8 string is stored.
 *
 */
public class StringCPInfo extends ConstantCPInfo {
    
the index into the constant pool containing the string's content /** the index into the constant pool containing the string's content */
    private int index;

    
Constructor.  /** Constructor.  */
    public StringCPInfo() {
        super(CONSTANT_STRING, 1);
    }

    
read a constant pool entry from a class stream.
Params:
cpStream – the DataInputStream which contains the constant pool
     entry to be read.
Throws:
IOException – if there is a problem reading the entry from
     the stream./**
     * read a constant pool entry from a class stream.
     *
     * @param cpStream the DataInputStream which contains the constant pool
     *      entry to be read.
     * @exception IOException if there is a problem reading the entry from
     *      the stream.
     */
    @Override
    public void read(DataInputStream cpStream) throws IOException {
        index = cpStream.readUnsignedShort();
        setValue("unresolved");
    }

    
Print a readable version of the constant pool entry.
Returns:
the string representation of this constant pool entry./**
     * Print a readable version of the constant pool entry.
     *
     * @return the string representation of this constant pool entry.
     */
    @Override
    public String toString() {
        return "String Constant Pool Entry for "
            + getValue() + "[" + index + "]";
    }

    
Resolve this constant pool entry with respect to its dependents in
the constant pool.
Params:
constantPool – the constant pool of which this entry is a member
     and against which this entry is to be resolved./**
     * Resolve this constant pool entry with respect to its dependents in
     * the constant pool.
     *
     * @param constantPool the constant pool of which this entry is a member
     *      and against which this entry is to be resolved.
     */
    @Override
    public void resolve(ConstantPool constantPool) {
        setValue(((Utf8CPInfo) constantPool.getEntry(index)).getValue());
        super.resolve(constantPool);
    }

}