SUBSTR

A fun????o SUBSTR atua sobre uma express??o cadeia de caracteres ou uma express??o cadeia de bits. No primeiro caso o tipo do resultado ?? VARCHAR, e no segundo caso ?? VARCHAR FOR BIT DATA. O comprimento do resultado ?? o comprimento m??ximo do tipo de origem.

Sintaxe

SUBSTR({ Express??oCaractere },
   Posi????oInicial [, ComprimentoCadeia ] )

A Posi????oInicial e o par??metro opcional ComprimentoCadeia s??o ambos express??es inteiras (O primeiro caractere ou bit possui Posi????oInicial igual a 1; se for especificado 0, o Derby assume que ?? 1).

A Express??oCaractere ?? do tipo de dado CHAR, VARCHAR ou LONG VARCHAR, ou de qualquer tipo de dado nativo que seja convertido implicitamente em uma cadeia (exceto a express??o de bit).

Para as express??es caractere, tanto Posi????oInicial quanto ComprimentoCadeia se referem a caracteres. Para express??es de bit, tanto Posi????oInicial quanto ComprimentoCadeia se referem a bits.

SUBSTR retorna NULL se for especificado ComprimentoCadeia, e este for menor que zero.

Se Posi????oInicial for positiva, ent??o se refere a posi????o a partir do in??cio da express??o de origem (contando o primeiro caractere como 1). Se Posi????oInicial for negativa, ent??o ?? a posi????o a partir do fim da origem.

Se n??o for especificado ComprimentoCadeia, ent??o SUBSTR retornar?? a subcadeia da express??o desde a Posi????oInicial at?? o fim da express??o de origem. Se for especificado ComprimentoCadeia, ent??o SUBSTR retornar?? um VARCHAR ou VARBIT com comprimento ComprimentoCadeia a partir da Posi????oInicial.