Funzione Seq.cache<'T> (F#)

Restituisce una sequenza che corrisponde a una versione memorizzata nella cache della sequenza di input.

Percorso spazio dei nomi/modulo: Microsoft.FSharp.Collections.Seq

Assembly: FSharp.Core (in FSharp.Core.dll)

// Signature:
Seq.cache : seq<'T> -> seq<'T>

// Usage:
Seq.cache source

Parametri

• source
  Tipo: seq<'T>

  Sequenza di input.

Eccezioni

Eccezione	Condizione
ArgumentNullException	Generata quando la sequenza di input è Null.

Valore restituito

Sequenza risultante.

Note

La sequenza risultante conterrà gli stessi elementi della sequenza di input. È possibile enumerare il risultato più volte. La sequenza di input viene enumerata al massimo una volta ed esclusivamente se necessario. L'operazione di memorizzazione nella cache di una sequenza è in genere utile se la valutazione ripetuta degli elementi nella sequenza originale risulta onerosa a livello di calcolo oppure se l'iterazione della sequenza provoca effetti collaterali che l'utente non desidera siano ripetuti più volte. Una volta avviata l'enumerazione della sequenza di input, questo oggetto manterrà attivo il relativo enumeratore finché l'enumerazione non è stata completata. A quel punto, l'enumeratore verrà eliminato. È possibile eliminare l'enumeratore e liberare la memoria occupata nella cache sottostante convertendo l'oggetto sequenza restituito nel tipo IDisposable e richiamando il metodo Dispose su tale oggetto. Sarà quindi possibile enumerare nuovamente l'oggetto sequenza per cui verrà utilizzato un enumeratore aggiornato.

Questa funzione è denominata Cache negli assembly compilati. Utilizzare questo nome se si accede alla funzione da un linguaggio diverso da F# o tramite reflection.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare Seq.cache per evitare di ricalcolare gli elementi di una sequenza.

// Recursive isprime function.
let isPrime n =
    let rec check i =
        i > n/2 || (n % i <> 0 && check (i + 1))
    check 2

let seqPrimes = seq { for n in 2 .. 10000 do if isPrime n then yield n }
// Cache the sequence to avoid recomputing the sequence elements.
let cachedSeq = Seq.cache seqPrimes
for index in 1..5 do
    printfn "%d is prime." (Seq.nth (Seq.length cachedSeq - index) cachedSeq)

Output

Thread safety

L'enumerazione della sequenza risultante è thread-safe nel senso che è possibile utilizzare contemporaneamente più valori IEnumerator indipendenti da diversi thread (gli accessi alla tabella lookaside interna sono thread-safe). In genere un singolo IEnumerator non è thread-safe e non è consentito accedervi contemporaneamente da più thread.

Piattaforme

Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2.

Informazioni sulla versione

F# Runtime

Supportato in: 2.0, 4.0

Silverlight

Supportato in: 3

Vedere anche

Riferimenti

Modulo Collections.Seq (F#)

Spazio dei nomi Microsoft.FSharp.Collections (F#)

Cronologia delle modifiche

Data	Cronologia	Motivo
Agosto 2010	Aggiunto esempio di codice.	Miglioramento delle informazioni.