TOKEN (espressione SSIS)TOKEN (SSIS Expression)

Restituisce un token (sottostringa) da una stringa in base ai delimitatori specificati che separano i token nella stringa e al numero del token che indica quale token deve essere restituito.Returns a token (substring) from a string based on the specified delimiters that separate tokens in the string and the number of the token that denotes which token to be returned.

SintassiSyntax

TOKEN(character_expression, delimiter_string, occurrence)  

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.

occurrenceoccurrence
Intero con segno o senza segno che specifica il token da restituire.A signed or unsigned integer that specifies the token to be returned. Ad esempio, se si specifica 3 come valore per questo parametro, viene restituito il terzo token nella stringa.For example, if you specify 3 as a value for this parameter, the third token in the string is returned.

Tipi restituitiResult Types

DT_WSTRDT_WSTR

OsservazioniRemarks

Questa funzione divide la stringa < character_expression > in un set di token separati dai delimitatori specificati nella < delimiter_string > e restituito il n token dove N è il numero di occorrenze del token specificato per il <occorrenza > parametro.This function splits up the string into a set of tokens separated by the delimiters specified in the and then returns the Nth token where N is the number of occurrence of the token specified by the <occurrence> parameter. Per utilizzi di esempio di questa funzione, vedere la sezione Esempi.See Examples section for sample usages of this function.

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.

  • Se il valore di <occorrenza > parametro è maggiore del numero totale di token nella stringa, la funzione restituisce NULL.If the value of <occurrence> parameter is higher than the total number of tokens in the string, the function returns NULL.

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

  • La funzione TOKEN può essere utilizzata solo con il tipo di dati DT_WSTR.TOKEN 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.

  • TOKEN restituisce un risultato Null se character_expression è Null.TOKEN returns a null result if the character_expression is null.

  • È possibile utilizzare variabili e colonne come valori di tutti gli argomenti dell'espressione.You can use variables and columns as values of all arguments in the expression.

Esempi di espressioneExpression Examples

Nell'esempio seguente la funzione TOKEN restituisce "a".In the following example, the TOKEN function returns "a". La stringa "a little white dog" presenta 4 token "a", "little", "white", "dog" separati dal delimitatore " " (spazio).The string “a little white dog” has 4 tokens “a”, “little”, “white”, “dog” separated by the delimiter " " (space character). Il secondo argomento, una stringa delimitatore, specifica il solo delimitatore, lo spazio, da utilizzare per suddividere la stringa di input in token.The second argument, a delimiter string, specifies only one delimiter, the space character, to be used in splitting the input string into tokens. L'ultimo argomento, 1, specifica che deve essere restituito il primo token.The last argument, 1, specifies that the first token to be returned. In questa stringa di esempio il primo token è "a".The first token is “a” in this sample string.

TOKEN("a little white dog"," ",1)  

Nell'esempio seguente la funzione TOKEN restituisce "dog".In the following example, the TOKEN function returns "dog". 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”.

TOKEN("a:little|white dog","| ,.:",4)  

Nell'esempio seguente la funzione TOKEN restituisce"" (una stringa vuota) perché non ci sono 99 token nella stringa.In the following example, the TOKEN function returns "" (an empty string) because there are no 99 tokens in the string.

TOKEN("a little white dog"," ",99)  

Nell'esempio seguente la funzione TOKEN restituisce l'intera stringa.In the following example, the TOKEN function returns the full string. 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.

TOKEN("a little white dog","|",1)  

Nell'esempio seguente la funzione TOKEN restituisce "a".In the following example, the TOKEN function returns “a”. Tutti gli spazi iniziali vengono ignorati.It ignores all the leading space characters.

TOKEN("        a little white dog", " ", 1)  

Nell'esempio seguente la funzione TOKEN restituisce l'anno da una stringa di data.In the following example, the TOKEN function returns the year from a date string.

TOKEN("2009/01/01", "/"), 1  

Nell'esempio seguente la funzione TOKEN restituisce il nome file dal percorso specificato.In the following example, the TOKEN function returns the file name from the specified path. Ad esempio, se il valore di User::Path è "c:\programmi\data\myfile.txt", la funzione TOKEN restituisce "myfile.txt".For example, if the value of User::Path is “c:\program files\data\myfile.txt”, the TOKEN function returns “myfile.txt”. La funzione TOKENCOUNT restituisce 4, mentre la funzione TOKEN restituisce il quarto token, "myfile.txt".The TOKENCOUNT function returns 4 and the TOKEN function return the 4th token, “myfile.txt”.

TOKEN(@[User::Path], "\\", TOKENCOUNT(@[User::Path], "\\"))  

Vedere ancheSee Also

Funzioni ( Espressione SSIS )Functions (SSIS Expression)