SCAN

Syntaxe

Paramètres

Description

Cette instruction sélectionne un mot dans une expression de caractères.

Remarques

• Définition de «Délimiteur» et «Mot» : Un délimiteur est l'un des nombreux caractères utilisés pour séparer les mots. Vous pouvez spécifier les délimiteurs dans les paramètres charlist et modifier. Si vous spécifiez le modificateur Q, les délimiteurs à l'intérieur des sous-chaînes de caractères entre guillemets sont ignorés. Dans la fonction SCAN, «mot» fait référence à une sous-chaîne de caractères présentant toutes ces caractéristiques : est délimité à gauche par un délimiteur ou le début de la chaîne de caractères, est délimité à droite par un délimiteur ou la fin de la chaîne de caractères et ne contient aucun délimiteur. Un mot peut avoir une longueur de zéro s'il y a des délimiteurs au début ou à la fin de la chaîne de caractères, ou si la chaîne de caractères contient deux ou plusieurs délimiteurs consécutifs. Cependant, la fonction SCAN ignore les mots ayant une longueur de zéro, sauf si vous spécifiez le modificateur M.
• La définition de «mot» est la même dans les fonctions SCAN et COUNTW.
• Utilisation des délimiteurs par défaut dans les environnements ASCII et EBCDIC : Si vous utilisez la fonction SCAN avec seulement deux paramètres, les délimiteurs par défaut varient selon que votre ordinateur utilise des caractères ASCII ou EBCDIC. Si votre ordinateur utilise des caractères ASCII, les délimiteurs par défaut sont les suivants :

espace ! $ % & ( ) * + , - . / ; < ^ |

Dans les environnements ASCII ne contenant pas le caractère ^, la fonction SCAN utilise le caractère ~ à la place. Si votre ordinateur utilise des caractères EBCDIC, les délimiteurs par défaut sont les suivants :

espace ! $ % & ( ) * + , - . / ; < | ??

Si vous utilisez le paramètre modificateur sans spécifier de caractères comme délimiteurs, les seuls délimiteurs utilisés sont les délimiteurs définis par le paramètre modifier. Dans ce cas, les listes de délimiteurs par défaut pour les environnements ASCII et EBCDIC ne sont pas utilisées. En d'autres termes, les modificateurs s'ajoutent à la liste des délimiteurs explicitement spécifiés par le paramètre charlist. Les modificateurs ne s'ajoutent pas à la liste des modificateurs par défaut.

• La longueur du résultat : Dans une étape DATA, la plupart des variables ont une longueur fixe. Si le mot renvoyé par la fonction SCAN est affecté à une variable dont la longueur fixe est supérieure à la longueur du mot renvoyé, la valeur de cette variable est complétée par des blancs. Les variables macro ont des longueurs variables et ne sont pas remplies d'espaces. La longueur maximale du mot renvoyé par la fonction SCAN dépend de l'environnement à partir duquel elle est appelée : Dans une étape DATA, si la fonction SCAN renvoie une valeur à une variable n'ayant pas encore reçu de longueur, cette variable reçoit la longueur du premier paramètre. Ce comportement est différent de celui des versions précédentes à 9 de SAS. Dans les versions précédentes, le code créant une variable d'une longueur de 200 pouvait avoir produit une variable d'une longueur supérieure à celle attendue. Si vous avez besoin de la fonction SCAN pour affecter une variable avec une valeur différente de la longueur du premier paramètre, utilisez une instruction LENGTH. Si vous utilisez la fonction SCAN dans une expression contenant des opérateurs ou d'autres fonctions, un mot renvoyé par la fonction SCAN peut comporter jusqu'à 32 767 caractères, sauf dans une clause WHERE. Dans ce cas, la longueur maximale est de 200 caractères. Dans la procédure SQL ou dans une clause WHERE de toute procédure, la longueur maximale d'un mot renvoyé par la fonction SCAN est de 200 caractères. Dans le macroprocesseur, la longueur maximale d'un mot renvoyé par la fonction SCAN est de 65 534 caractères. La longueur minimale du mot renvoyé par la fonction SCAN dépend de la spécification du modificateur M.
• Utilisation de la fonction SCAN avec le modificateur M:  Si vous spécifiez le modificateur M, le nombre de mots dans une chaîne de caractères est défini comme un plus le nombre de délimiteurs dans la chaîne de caractères. Cependant, si vous spécifiez le modificateur Q, les délimiteurs se trouvant entre guillemets sont ignorés. Si vous spécifiez le modificateur M, la fonction SCAN renvoie un mot de longueur zéro si l'une de ces conditions est vraie : la chaîne de caractères commence par un délimiteur et vous demandez le premier mot, la chaîne de caractères se termine par un délimiteur et vous demandez le dernier mot, la chaîne de caractères contient deux délimiteurs consécutifs et vous demandez le mot se trouvant entre les deux délimiteurs.
• Utilisation de la fonction SCAN sans le modificateur M : Si vous ne spécifiez pas le modificateur M, le nombre de mots dans une chaîne de caractères est défini comme le nombre de sous-chaînes de caractères maximales de non-délimiteurs consécutifs. Cependant, si vous spécifiez le modificateur Q, les délimiteurs se trouvant entre guillemets sont ignorés. Si vous ne spécifiez pas le modificateur M, la fonction SCAN se comporte de la manière suivante : ignore les délimiteurs au début ou à la fin de la chaîne de caractères, traite deux ou plusieurs délimiteurs consécutifs comme s'il s'agissait d'un seul délimiteur, si la chaîne ne contient aucun caractère autre que des délimiteurs, ou si vous spécifiez un nombre supérieur en valeur absolue au nombre de mots de la chaîne de caractères, la fonction SCAN renvoie l'un des éléments suivants : un seul blanc lorsque vous appelez la fonction SCAN à partir d'une étape DATA, une chaîne de caractères avec une longueur de zéro lorsque vous appelez la fonction SCAN à partir du processeur de macro.
• Utilisation de paramètres nuls  La fonction SCAN permet aux paramètres de caractères d'être nuls. Les paramètres nuls sont traités comme des chaînes de caractères de longueur zéro. Les paramètres numériques ne peuvent pas être nuls.
• Traitement des données SBCS et DBCS : La fonction SCAN est conçue pour traiter les données SBCS, mais elle peut également traiter les données DBCS. Voici les critères : Si la chaîne de caractères n'est pas déclarée comme varchar et que vous traitez des données à un octet, SCAN traite SBCS. Si la chaîne de caractères est déclarée comme varchar et que vous traitez des données multi-octets, SCAN traite DBCS.