Scopo
Ritorna il prossimo token non ancora letto dalla stringa precedentemente impostata con la procedura SetString. Solitamente questa funzione si usa all'interno di un ciclo While per leggere tutti i token della stringa, oppure come chiamate successive se si conosce il formato esatto dei campi nella stringa.
Sintassi
string ProssimoToken = "" // Leggo il prossimo token
//
ProssimoToken := StringTokenizer.NextToken()
//
ProssimoToken := StringTokenizer.NextToken()
Argomenti
Questa funzione non ha argomenti.Valore di ritorno
Ritorna una stringa che contiene il primo token non ancora letto dalla stringa precedentemente impostata tramite la procedura SetString.
Esempio di codice
// ****************************************************************************
// Suddivide la stringa in tutte le sue sottoparti mediante il componente
// String Tokenizer
// ****************************************************************************
public void StringTokenizer.Suddividi()
{
StringTokenizer stk = new() //
//
// Svuoto l'elenco dei token trovati
Tokenizer.TokensTokenizer := Empty String
//
// Assegno la stringa al componente
stk.SetString(Tokenizer.StringTokenizer, Tokenizer.
DelimiterTokenizer, Tokenizer.QuoteTokenizer)
//
// Finché ci sono sottoparti le scrivo nell'elenco dei token
while stk.HasNextToken()
{
Tokenizer.TokensTokenizer := Tokenizer.TokensTokenizer +c stk.
NextToken() +c Acapo
}
}
// Suddivide la stringa in tutte le sue sottoparti mediante il componente
// String Tokenizer
// ****************************************************************************
public void StringTokenizer.Suddividi()
{
StringTokenizer stk = new() //
//
// Svuoto l'elenco dei token trovati
Tokenizer.TokensTokenizer := Empty String
//
// Assegno la stringa al componente
stk.SetString(Tokenizer.StringTokenizer, Tokenizer.
DelimiterTokenizer, Tokenizer.QuoteTokenizer)
//
// Finché ci sono sottoparti le scrivo nell'elenco dei token
while stk.HasNextToken()
{
Tokenizer.TokensTokenizer := Tokenizer.TokensTokenizer +c stk.
NextToken() +c Acapo
}
}
- Se non ci sono più token disponibili la funzione ritorna Null String.
- Il valore ritornato potrebbe essere una stringa vuota anche se ci sono token disponibili. Se ad esempio la stringa contiene due carattere delimitatori in sequenza, allora il token tornato è stringa vuota (costante Empty String).
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680