Package org.apache.calcite.sql

Class SqlCharStringLiteral

java.lang.Object

org.apache.calcite.sql.SqlNode

org.apache.calcite.sql.SqlLiteral

org.apache.calcite.sql.SqlCharStringLiteral

All Implemented Interfaces:

Cloneable

public class SqlCharStringLiteral
extends SqlLiteral

A character string literal.

Its SqlLiteral.value field is an NlsString and typeName is SqlTypeName.CHAR.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.calcite.sql.SqlLiteral

SqlLiteral.SqlSymbol

Field Summary

Fields inherited from class org.apache.calcite.sql.SqlLiteral

value

Fields inherited from class org.apache.calcite.sql.SqlNode

EMPTY_ARRAY, pos

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SqlCharStringLiteral(NlsString val, SqlParserPos pos)

Method Summary

Modifier and Type	Method	Description
SqlCharStringLiteral	clone(SqlParserPos pos)	Clones a SqlNode with a different position.
protected org.apache.calcite.sql.SqlAbstractStringLiteral	concat1(List<SqlLiteral> literals)	Helper routine for SqlUtil.concatenateLiterals(java.util.List<org.apache.calcite.sql.SqlLiteral>).
@Nullable SqlCollation	getCollation()	Returns the collation.
NlsString	getNlsString()	Deprecated. Use getValueAs(NlsString.class)
void	unparse(SqlWriter writer, int leftPrec, int rightPrec)	Writes a SQL representation of this node to a writer.

Methods inherited from class org.apache.calcite.sql.SqlLiteral

accept, bigDecimalValue, booleanValue, createApproxNumeric, createBinaryString, createBinaryString, createBoolean, createCharString, createCharString, createDate, createDate, createExactNumeric, createInterval, createNegative, createNull, createSample, createSqlType, createSymbol, createTime, createTime, createTime, createTimestamp, createTimestamp, createTimestamp, createTimestamp, createUnknown, createUnknown, createUuid, equals, equalsDeep, getKind, getMonotonicity, getStringValue, getTypeName, getValue, getValueAs, hashCode, intValue, longValue, sampleValue, signum, stringValue, symbolValue, symbolValue_, toValue, unchain, unescapeUnicode, validate, value, valueMatchesType

Methods inherited from class org.apache.calcite.sql.SqlNode

clone, clone, cloneArray, equalDeep, equalDeep, equalsDeep, findValidOptions, getParserPosition, isA, toList, toList, toSqlString, toSqlString, toSqlString, toString, unparseWithParentheses, validateExpr

Methods inherited from class java.lang.Object

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

Constructor Details

SqlCharStringLiteral

protected SqlCharStringLiteral(NlsString val,
 SqlParserPos pos)

Method Details

getNlsString

@Deprecated
public NlsString getNlsString()

Deprecated.

Use getValueAs(NlsString.class)

Returns the underlying NlsString.

getCollation

public @Nullable SqlCollation getCollation()

Returns the collation.

clone

public SqlCharStringLiteral clone(SqlParserPos pos)

Description copied from class: SqlNode

Clones a SqlNode with a different position.

Overrides:

clone in class SqlLiteral

unparse

public void unparse(SqlWriter writer,
 int leftPrec,
 int rightPrec)

Description copied from class: SqlNode

Writes a SQL representation of this node to a writer.

The leftPrec and rightPrec parameters give us enough context to decide whether we need to enclose the expression in parentheses. For example, we need parentheses around "2 + 3" if preceded by "5 *". This is because the precedence of the "*" operator is greater than the precedence of the "+" operator.

The algorithm handles left- and right-associative operators by giving them slightly different left- and right-precedence.

If SqlWriter.isAlwaysUseParentheses() is true, we use parentheses even when they are not required by the precedence rules.

For the details of this algorithm, see SqlCall.unparse(org.apache.calcite.sql.SqlWriter, int, int).

Overrides:

unparse in class SqlLiteral

Parameters:

writer - Target writer

leftPrec - The precedence of the SqlNode immediately preceding this node in a depth-first scan of the parse tree

rightPrec - The precedence of the SqlNode immediately

concat1

protected org.apache.calcite.sql.SqlAbstractStringLiteral concat1(List<SqlLiteral> literals)

Helper routine for SqlUtil.concatenateLiterals(java.util.List<org.apache.calcite.sql.SqlLiteral>).

Parameters:

literals - homogeneous StringLiteral args

Returns:

StringLiteral with concatenated value. this == lits[0], used only for method dispatch.