DSUBSTR(inlength, source_string, start, end, sublength, output)
où :
- inlength
Entier
est la longueur d'une chaîne source en octets, ou le champ contenant celle-ci. La chaîne peut mixer des caractères DBCS et SBCS. Ainsi, le nombre d'octets représente le nombre maximum de caractères possibles dans la chaîne source.
- source_string
Alphanumérique
est la chaîne à partir de laquelle sera extraite une sous-chaîne encadrée par des guillemets simples, ou le champ contenant la chaîne parente.
- start
Entier
est la position de départ (en nombre de caractères) de la sous-chaîne dans la chaîne source. Si cet argument est inférieur à ou supérieur à inlength, la fonction renvoie les espaces.
- end
Entier
est la position de fin (en nombre de caractères) de la sous-chaîne. Si cet argument est inférieur à start ou supérieur à inlength, la fonction renvoie les espaces.
- sublength
Entier
est la longueur d'une sous-chaîne (normalement end- start + 1). Si sublength est plus longue queend-,start+1, la sous-chaîne est remplie avec des espaces rampants. Si c'est plus court, la sous-chaîne est tronquée. Cette valeur devrait être la longueur déclarée dans output. Seuls les caractères sublength seront traités.
- output
Alphanumérique
est le champ qui contient le résultat, ou le format de la valeur de sortie entre guillemets simples (').
L'exemple suivant extrait la sous-chaîne de trois caractères dans les positions 4 à 6 dans une chaîne de caractères de 15 octets :
