software.amazon.ion.IonSymbol Maven / Gradle / Ivy
Show all versions of ion-java Show documentation
/*
* Copyright 2007-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at:
*
* http://aws.amazon.com/apache2.0/
*
* or in the "license" file accompanying this file. This file 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 software.amazon.ion;
/**
* An Ion symbol value.
*
* WARNING: This interface should not be implemented or extended by
* code outside of this library.
*/
public interface IonSymbol
extends IonText
{
/**
* Gets the text content of this symbol.
*
* @return the text of the symbol, or null if this is
* null.symbol.
*
* @throws UnknownSymbolException if this symbol has unknown text.
*/
public String stringValue()
throws UnknownSymbolException;
/**
* Returns this value as a symbol token (text + ID).
*
* @return null if {@link #isNullValue()}
*
*/
public SymbolToken symbolValue();
/**
* Changes the value of this element.
*
* @param value the new value of this symbol;
* may be null to make this null.symbol.
*
*/
public void setValue(String value);
public IonSymbol clone()
throws UnknownSymbolException;
}