TOKENCOUNT (espressione SSIS)TOKENCOUNT (SSIS Expression)

Restituisce il numero di token in una stringa che contiene token separati dai delimitatori specificati.Returns the number of tokens in a string that contains tokens separated by the specified delimiters.

SintassiSyntax

TOKENCOUNT(character_expression, delimiter_string)  

ArgomentiArguments

character_expressioncharacter_expression
Stringa che contiene token separati da delimitatori.A string that contains tokens separated by delimiters.

delimiter_stringdelimiter_string
Stringa che contiene caratteri delimitatori.A string that contains delimiter characters. Ad esempio, "; ,” contiene i caratteri delimitatori punto e virgola, spazio e virgola.For example, "; ,” contains three delimiter characters semi-colon, a blank space, and a comma.

Tipi restituitiResult Types

DT_I4DT_I4

OsservazioniRemarks

Le osservazioni seguenti riguardano la funzione TOKEN:The following remarks apply to the TOKEN function:

  • La stringa di delimitazione può contenere uno o più caratteri delimitatori.The delimiter string can contain one or more delimiter characters.

  • I delimitatori iniziali vengono ignorati.Leading delimiters are skipped.

  • TOKENCOUNT funziona unicamente con il tipo di dati DT_WSTR.TOKENCOUNT works only with the DT_WSTR data type. Se l'argomento character_expression è un valore letterale stringa o una colonna di dati con tipo di dati DT_STR, prima di eseguire l'operazione prevista da TOKEN verrà eseguito il cast implicito al tipo di dati DT_WSTR.A character_expression argument that is a string literal or a data column with the DT_STR data type is implicitly cast to the DT_WSTR data type before TOKEN performs its operation. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR.Other data types must be explicitly cast to the DT_WSTR data type.

  • TOKENCOUNT restituisce 0 (zero) se character_expression è Null.TOKENCOUNT returns 0 (zero) if the character_expression is null.

  • È possibile utilizzare variabili e colonne come argomenti di questa espressione.You can use variables and columns as arguments for this expression.

Esempi di espressioneExpression Examples

Nell'esempio seguente, la funzione TOKENCOUNT restituisce 3 perché la stringa contiene tre token: "01", "12", "2011".In the following example, the TOKENCOUNT function returns 3 because the string contains three tokens: “01”, “12”, “2011”.

TOKENCOUNT("01/12/2011", "/")  

Nell'esempio seguente la funzione TOKENCOUNT restituisce 4 perché la stringa contiene quattro token ("a", "little", "white", "dog").In the following example, the TOKENCOUNT function returns 4 because there are four tokens (“a”, “little”, “white”, “dog”).

TOKENCOUNT("a little white dog"," ")  

Nell'esempio seguente la funzione TOKENCOUNT restituisce 1.In the following example, the TOKENCOUNT function returns 1. La funziona cerca i delimitatori nella stringa di input e poiché non ve ne sono, aggiunge l'intera stringa come primo token.The function parses the input string for delimiters and since there are none in the string, it just adds the entire string as the first token.

TOKENCOUNT("a little white dog","|")  

Nell'esempio seguente la funzione TOKENCOUNT restituisce 4.In the following example, the TOKENCOUNT function returns 4. In questo esempio la stringa di delimitazione contiene 5 delimitatori.The delimiter string in this example contains 5 delimiters. La stringa di input contiene 4 token: "a", "little", "white", "dog".The input string contains 4 tokens: “a”, “little”, “white”, “dog”.

TOKENCOUNT("a:little|white dog","| ,.:")  

Nell'esempio seguente la funzione TOKENCOUNT restituisce 4.In the following example, the TOKENCOUNT function returns 4. Tutti gli spazi iniziali vengono ignorati.It ignores all the leading space characters.

TOKENCOUNT("        a little white dog", " ")  

Vedere ancheSee Also

Funzioni ( Espressione SSIS )Functions (SSIS Expression)