21.10.2013 Views

Firebird 2.1 Language Reference Update

Firebird 2.1 Language Reference Update

Firebird 2.1 Language Reference Update

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Result type: (VAR)CHAR or BLOB<br />

Syntax:<br />

Example:<br />

LOWER (str)<br />

Important<br />

Internal functions<br />

If the external function LOWER is declared in your database, it will override the internal function. To make the<br />

internal function available, DROP or ALTER the external function (UDF).<br />

select Sheriff from Towns<br />

where lower(Name) = 'cooper''s valley'<br />

See also: UPPER<br />

Available in: DSQL, PSQL<br />

Added in: <strong>2.1</strong><br />

LPAD()<br />

Description: Left-pads a string with spaces or with a user-supplied string until a given length is reached.<br />

Result type: VARCHAR(32765) or BLOB<br />

Syntax:<br />

LPAD (str, endlen [, padstr])<br />

• This function fully supports text BLOBs of any length and character set.<br />

• If str is a BLOB, the result is a BLOB. Otherwise, the result is a VARCHAR(32765).<br />

• If padstr is given and equals '' (empty string), no padding takes place.<br />

• If endlen is less than the current string length, the string is truncated to endlen, even if padstr<br />

is the empty string.<br />

Important<br />

If the external function LPAD is declared in your database, it will override the internal function. To make the<br />

internal function available, DROP or ALTER the external function (UDF).<br />

Tip<br />

With (VAR)CHARs, it is generally wise to CAST the result to a smaller size. The default result length of 32765<br />

may, in combination with other output columns, lead to a “block size exceeds implementation restriction” error.<br />

144

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!