Escaped scalar functions

The JDBC specification defines functions with an escape call syntax : {fn function_name(arguments)}. The following tables show which functions are supported by the PostgresSQL™ driver. The driver supports the nesting and the mixing of escaped functions and escaped values. The appendix C of the JDBC specification describes the functions.

Some functions in the following tables are translated but not reported as supported because they are duplicating or changing ther order of the arguments. While this is harmless for literal values or columns, it will cause problems when using prepared statements. For example "{fn right(?,?)}" will be translated to "substring(? from (length(?)+1-?))". As you can see the translated SQL requires more parameters than before the translation but the driver will not automatically handle this.

Table 8.1. Supported escaped numeric functions

function reported as supported translation comments
abs(arg1) yes abs(arg1)  
acos(arg1) yes acos(arg1)  
asin(arg1) yes asin(arg1)  
atan(arg1) yes atan(arg1)  
atan2(arg1,arg2) yes atan2(arg1,arg2)  
ceiling(arg1) yes ceil(arg1)  
cos(arg1) yes cos(arg1)  
cot(arg1) yes cot(arg1)  
degrees(arg1) yes degrees(arg1)  
exp(arg1) yes exp(arg1)  
floor(arg1) yes floor(arg1)  
log(arg1) yes ln(arg1)  
log10(arg1) yes log(arg1)  
mod(arg1,arg2) yes mod(arg1,arg2)  
pi(arg1) yes pi(arg1)  
power(arg1,arg2) yes pow(arg1,arg2)  
radians(arg1) yes radians(arg1)  
rand() yes random()  
rand(arg1) yes setseed(arg1)*0+random() The seed is initialized with the given argument and a new randow value is returned.
round(arg1,arg2) yes round(arg1,arg2)  
sign(arg1) yes sign(arg1)  
sin(arg1) yes sin(arg1)  
sqrt(arg1) yes sqrt(arg1)  
tan(arg1) yes tan(arg1)  
truncate(arg1,arg2) yes trunc(arg1,arg2)  

Table 8.2. Supported escaped string functions

function reported as supported translation comments
ascii(arg1) yes ascii(arg1)  
char(arg1) yes chr(arg1)  
concat(arg1,arg2...) yes (arg1||arg2...) The JDBC specification only require the two arguments version, but supporting more arguments was so easy...
insert(arg1,arg2,arg3,arg4) no overlay(arg1 placing arg4 from arg2 for arg3) This function is not reported as supported since it changes the order of the arguments which can be a problem (for prepared statements by example).
lcase(arg1) yes lower(arg1)  
left(arg1,arg2) yes substring(arg1 for arg2)  
length(arg1) yes length(trim(trailing from arg1))  
locate(arg1,arg2) no position(arg1 in arg2)  
locate(arg1,arg2,arg3) no (arg2*sign(position(arg1 in substring(arg2 from arg3)+position(arg1 in substring(arg2 from arg3)) Not reported as supported since the three arguments version duplicate and change the order of the arguments.
ltrim(arg1) yes trim(leading from arg1)  
repeat(arg1,arg2) yes repeat(arg1,arg2)  
replace(arg1,arg2,arg3) yes replace(arg1,arg2,arg3) Only reported as supported by 7.3 and above servers.
right(arg1,arg2) no substring(arg1 from (length(arg1)+1-arg2)) Not reported as supported since arg2 is duplicated.
rtrim(arg1) yes trim(trailing from arg1)  
space(arg1) yes repeat(' ',arg1)  
substring(arg1,arg2) yes substr(arg1,arg2)  
substring(arg1,arg2,arg3) yes substr(arg1,arg2,arg3)  
ucase(arg1) yes upper(arg1)  
soundex(arg1) no soundex(arg1) Not reported as supported since it requires the fuzzystrmatch contrib module.
difference(arg1,arg2) no difference(arg1,arg2) Not reported as supported since it requires the fuzzystrmatch contrib module.

Table 8.3. Supported escaped date/time functions

function reported as supported translation comments
curdate() yes current_date  
curtime() yes current_time  
dayname(arg1) yes to_char(arg1,'Day')  
dayofmonth(arg1) yes extract(day from arg1)  
dayofweek(arg1) yes extract(dow from arg1)+1 We must add 1 to be in the expected 1-7 range.
dayofyear(arg1) yes extract(doy from arg1)  
hour(arg1) yes extract(hour from arg1)  
minute(arg1) yes extract(minute from arg1)  
month(arg1) yes extract(month from arg1)  
monthname(arg1) yes to_char(arg1,'Month')  
now() yes now()  
quarter(arg1) yes extract(quarter from arg1)  
second(arg1) yes extract(second from arg1)  
week(arg1) yes extract(week from arg1)  
year(arg1) yes extract(year from arg1)  
timestampadd(argIntervalType,argCount,argTimeStamp) yes ('(interval according to argIntervalType and argCount)'+argTimeStamp) an argIntervalType value of SQL_TSI_FRAC_SECOND is not implemented since backend does not support it
timestampdiff(argIntervalType,argTimeStamp1,argTimeStamp2) not extract((interval according to argIntervalType) from argTimeStamp2-argTimeStamp1 ) only an argIntervalType value of SQL_TSI_FRAC_SECOND, SQL_TSI_FRAC_MINUTE, SQL_TSI_FRAC_HOUR or SQL_TSI_FRAC_DAY is supported

Table 8.4. Supported escaped misc functions

function reported as supported translation comments
database() yes current_database() Only reported as supported by 7.3 and above servers.
ifnull(arg1,arg2) yes coalesce(arg1,arg2)  
user() yes user  
Privacy Policy | About PostgreSQL
Copyright © 1996-2013 The PostgreSQL Global Development Group