Condividi tramite

Platform::WriteOnlyArray (classe)

  • Articolo

Rappresenta una matrice unidimensionale usata come parametro di input quando il chiamante passa una matrice che verrà riempita dal metodo.

Questa classe di riferimento viene dichiarata come privata in vccorlib.h, di conseguenza non viene generata nei metadati ed è supportata solo da C++. Questa classe è destinata a essere usata solo come parametro di input che riceve una matrice allocata dal chiamante. Non può essere costruita dal codice utente. Consente al metodo C++ di scrivere direttamente in una matrice, un modello noto come FillArray . Per altre informazioni, vedere Array e WriteOnlyArray.

Sintassi

private ref class WriteOnlyArray<T, 1>

Membri

Metodi pubblici

Questi metodi presentano accessibilità interna, ovvero sono accessibili solo all'interno dell'app o del componente C++.

Nome Descrizione
WriteOnlyArray::begin Iteratore che punta al primo elemento della matrice
WriteOnlyArray::D ata Puntatore al buffer di dati.
WriteOnlyArray::end Iteratore che punta all'elemento dopo l'ultimo elemento nella matrice.
WriteOnlyArray::FastPass Indica se la matrice può utilizzare il meccanismo FastPass, ovvero un'ottimizzazione eseguita in modo trasparente dal sistema. Non usarlo nel codice
WriteOnlyArray::Length Restituisce il numero di elementi nella matrice.
WriteOnlyArray::set Imposta l'elemento specificato sul valore specificato.

Gerarchia di ereditarietà

WriteOnlyArray

Requisiti

Opzione del compilatore: /ZW

Metadati: Platform.winmd

Spazio dei nomi: Platform

Metodo WriteOnlyArray::begin

Restituisce un puntatore al primo elemento della matrice.

Sintassi

T* begin() const;

Valore restituito

Puntatore al primo elemento della matrice.

Osservazioni:

Questo iteratore può essere usato con algoritmi STL quali std::sort per intervenire sugli elementi della matrice.

Proprietà WriteOnlyArray::Data

Puntatore al buffer di dati.

Sintassi

property T* Data{
   T* get() const;
}

Valore restituito

Puntatore ai byte di matrice non elaborati.

Metodo WriteOnlyArray::end

Restituisce un puntatore oltre l'ultimo elemento della matrice.

Sintassi

T* end() const;

Valore restituito

Iteratore di un puntatore oltre l'ultimo elemento della matrice.

Osservazioni:

Questo iteratore può essere usato con algoritmi STL per eseguire operazioni quali std::sort sugli elementi della matrice.

Proprietà WriteOnlyArray::FastPass

Indica se l'ottimizzazione FastPass interna può essere eseguita. Non è destinata all'uso da parte del codice utente.

Sintassi

property bool FastPass{
   bool get() const;
}

Valore restituito

Valore booleano che indica se la matrice è FastPass.

Metodo WriteOnlyArray::get

Restituisce l'elemento in corrispondenza dell'indice specificato.

Sintassi

T& get(unsigned int indexArg) const;

Parametri

indexArg
Indice da utilizzare.

Valore restituito

Proprietà WriteOnlyArray::Length

Restituisce il numero di elementi nella matrice allocata dal chiamante.

Sintassi

property unsigned int Length{
   unsigned int get() const;
}

Valore restituito

Numero di elementi nella matrice.

Funzione WriteOnlyArray::set

Imposta il valore specificato in corrispondenza dell'indice specificato nella matrice.

Sintassi

T& set(
   unsigned int indexArg,
   T valueArg);

Parametri

indexArg
Indice dell'elemento da impostare.

valueArg
Valore da impostare in corrispondenza di indexArg.

Valore restituito

Riferimento all'elemento appena impostato.

Osservazioni:

Per altre informazioni su come interpretare il valore HRESULT, vedere Struttura dei codici di errore COM.

Vedi anche

Spazio dei nomi della piattaforma
Creazione di componenti Windows Runtime in C++