Package net.sf.saxon.expr

Class StringLiteral

java.lang.Object

net.sf.saxon.expr.Expression

net.sf.saxon.expr.Literal

net.sf.saxon.expr.StringLiteral

All Implemented Interfaces:

ExportAgent, Locatable, IdentityComparable, Traceable

public class StringLiteral
extends Literal

Subclass of Literal used specifically for string literals, as this is a common case

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.saxon.expr.Literal

Literal.LiteralElaborator

Field Summary

Fields inherited from class net.sf.saxon.expr.Expression

EFFECTIVE_BOOLEAN_VALUE, EVALUATE_METHOD, ITEM_FEED_METHOD, ITERATE_METHOD, MAX_COST, MAX_SEQUENCE_LENGTH, MAX_STRING_LENGTH, PROCESS_METHOD, staticProperties, UNBOUNDED_LOWER, UNBOUNDED_UPPER, UPDATE_METHOD, WATCH_METHOD

Constructor Summary

Constructors

Constructor	Description
StringLiteral(String value)	Create a StringLiteral that wraps a String
StringLiteral(UnicodeString value)	Create a StringLiteral that wraps any UnicodeString
StringLiteral(StringValue value)	Create a StringLiteral that wraps a StringValue

Method Summary

Modifier and Type	Method	Description
Expression	copy(RebindingMap rebindings)	Copy an expression.
StringValue	getGroundedValue()	Get the value represented by this Literal
UnicodeString	getString()	Get the string represented by this StringLiteral, as a UnicodeString
String	stringify()	Get the string represented by this StringLiteral, as a String

Methods inherited from class net.sf.saxon.expr.Literal

addToPathMap, computeCardinality, computeHashCode, computeSpecialProperties, effectiveBooleanValue, equals, evaluateAsString, evaluateItem, export, exportAtomicValue, exportValue, getDependencies, getElaborator, getExpressionName, getImplementationMethod, getIntegerBounds, getItemType, getNetCost, getStaticUType, getStreamerName, hasEffectiveBooleanValue, isAtomic, isConstantBoolean, isConstantOne, isConstantZero, isEmptySequence, isInstance, isSubtreeExpression, isVacuousExpression, iterate, iterate, makeEmptySequence, makeLiteral, makeLiteral, optimize, process, supportsLazyEvaluation, toPattern, toShortString, toString, typeCheck

Methods inherited from class net.sf.saxon.expr.Expression

adoptChildExpression, allowExtractingCommonSubexpressions, checkedOperands, checkForUpdatingSubexpressions, checkPermittedContents, computeDependencies, computeStaticProperties, dispatchTailCall, dynamicError, explain, getCardinality, getConfiguration, getCost, getEvaluationMethod, getExtraProperty, getIntrinsicDependencies, getLocalRetainedStaticContext, getLocation, getObjectName, getPackageData, getParentExpression, getProperties, getProperty, getRetainedStaticContext, getScopingExpression, getSlotsUsed, getSpecialProperties, getStaticBaseURI, getStaticBaseURIString, getStaticType, getTracingTag, hasCompatibleStaticContext, hashCode, hasSpecialProperty, hasVariableBinding, identityHashCode, implementsStaticTypeCheck, isCallOn, isEqual, isIdentical, isInstruction, isLiftable, isMultiThreaded, isStaticPropertiesKnown, isUpdatingExpression, makeElaborator, markTailFunctionCalls, operandList, operands, operandSparseList, optimizeChildren, prepareForStreaming, resetLocalStaticProperties, restoreParentPointers, setEvaluationMethod, setExtraProperty, setFiltered, setFlattened, setLocation, setParentExpression, setRetainedStaticContext, setRetainedStaticContextLocally, setRetainedStaticContextThoroughly, setStaticProperty, simplify, simplifyChildren, staticTypeCheck, suppressValidation, typeCheckChildren, typeError, unordered, verifyParentPointers, withLocation

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sf.saxon.trace.Traceable

gatherProperties

Constructor Details

StringLiteral

public StringLiteral(StringValue value)

Create a StringLiteral that wraps a StringValue

Parameters:

value - the StringValue

StringLiteral

public StringLiteral(UnicodeString value)

Create a StringLiteral that wraps any UnicodeString

Parameters:

value - the UnicodeString to be wrapped

StringLiteral

public StringLiteral(String value)

Create a StringLiteral that wraps a String

Parameters:

value - the String to be wrapped

Method Details

getGroundedValue

public StringValue getGroundedValue()

Get the value represented by this Literal

Overrides:

getGroundedValue in class Literal

Returns:

the constant value

getString

public UnicodeString getString()

Get the string represented by this StringLiteral, as a UnicodeString

Returns:

the underlying string

stringify

public String stringify()

Get the string represented by this StringLiteral, as a String

Returns:

the underlying string

copy

public Expression copy(RebindingMap rebindings)

Description copied from class: Literal

Copy an expression. This makes a deep copy.

Overrides:

copy in class Literal

Parameters:

rebindings - variables that need to be re-bound

Returns:

a copy of the original literal. Note that the underlying value is not copied; the code relies on the caller treating the underlying value as immutable.