DSUBSTR(inlength, source_string, start, end, sublength, output)
onde:
- inlength
Inteiro
É o tamanho da string fonte em bytes ou um campo que contém o tamanho. A string pode ter uma combinação de caracteres DBCS e SBCS. Portanto, o número de bytes representa o número máximo de caracteres possíveis na string de fonte.
- source_string
Alfanumérico
É a string da qual se extrai uma substring entre aspas simples (') ou o campo que contém a string pai.
- iniciar
Inteiro
É a posição inicial (em número de caracteres) da substring na string fonte. Se este argumento for inferior a um ou superior a end, a função retornará espaços.
- terminar
Inteiro
É a posição final (em número de caracteres) da substring. Se este argumento for inferior a start ou superior ao inlength, a função retornará espaços.
- sublength
Inteiro
É o comprimento da substring em caracteres (normalmente end - start + 1). Se a sublength for maior do que end - start +1, a substring será preenchida com espaços à direita. Se for mais curta, a substring será truncada. Este valor deve ser o comprimento declarado de output. Somente caracteres de sublength serão processados.
- saída
Alfanumérico
É o campo que contém o resultado ou o formato do valor de saída posto entre aspas simples(').
O exemplo a seguir extrai a substring de três caracteres nas posições de 4 a 6 de uma string de caracteres de 15 bytes:
