Procedura guidata Nuovo file di definizione dei messaggi, opzione file di intestazione C, materiale di riferimento per la selezione della serie di messaggi di destinazione.
File di intestazione C
Quando si utilizza l'opzione file di intestazione C nella procedura guidata Nuovo file di definizione dei messaggi per creare una definizione del messaggio, verranno visualizzati i pannelli riportati di seguito.
Proprietà del pannello
- Piattaforma di origine
- Tale proprietà imposta i valori predefiniti per la code page, il formato a virgola mobile e l'ordine byte.
- (Non specificato)
- Msvc
- icc
- AIXgcc
- AIXxlc
- OS390
- Codepage
- Si tratta dell'impostazione predefinita dei valori configurati utilizzando la proprietà Piattaforma di origine. Non modificarla.
- Formato a virgola mobile
- Si tratta dell'impostazione predefinita dei valori configurati utilizzando la proprietà Piattaforma di origine. Non modificarla.
- IEEE Extended INTEL
- IEEE Extended AIX
- IEEE Extended OS/390
- IEEE Non-Extended
- IBM 390 Hexadecimal
Layout memorizzazione
- Dimensione indirizzo
- Specificare la dimensione dell'indirizzo nativo del componente hardware per il quale è progettato il file di intestazione C. Ciò interessa:
- la lunghezza CWF di un puntatore importato (4|8 byte)
- la lunghezza CWF di un "Long" (4|8 byte)
Selezionare la dimensione corrispondente a quella del programma che produce o utilizza messaggi CWF.
- 32 bit - impostazione predefinita
- 64 bit
- Dimensione per long double
- Si tratta dell'impostazione predefinita dei valori configurati utilizzando la proprietà Piattaforma di origine. Non modificarla.
- 64 bit - impostazione predefinita
- 128 bit
- Ordine byte
- Little Endian - impostazione predefinita
- Big Endian
- Livello pacchetto
- Interessa i valori dell'allineamento dei byte CWF e del Numero di elementi iniziali e finali ignorati degli elementi assegnati. Un programma di importazione C allinea normalmente una variabile su un limite pari alla propria dimensione (un numero intero di 4 byte allinea su un limite di 4 byte). Per consentire tale operazione, il compilatore aggiunge spazio di tolleranza tra variabili in una struttura.
Le impostazioni del pacchetto forniscono un valore di allineamento massimo per una variabile. Se nei messaggi è contenuto uno spazio di tolleranza, selezionare il livello del pacchetto corrispondente a quello del programma che produce o utilizza messaggi CWF. Selezionare "1" se non si desidera spazio di tolleranza. Ad esempio:
/* Test data alignment
* Struct containing an int (naturally aligns on word boundary)
*
* +---------------------------------------------------
* | a,b,c = a byte of the element
* | _ = a byte of padding
* |---------------------------------------------------
* | 111 |
* | pack | 1234 5678 9012 | Total structure size
* | ----------+----------------+----------------------
* | 1-byte | abbb bc | 6 bytes
* | 2-byte | a_bb bbc_ | 8 bytes
* | 4-byte | a___ bbbb c___ | 12 bytes
* | 8-byte | a___ bbbb c___ | 12 bytes
* +---------------------------------------------------
*****************************************************/
struct _align01 {
char align_01_a;
int align_01_b;
char align_01_c;
};
- 1
- 2
- 3
- 8 - impostazione predefinita
- 16
- Dimensione enum
- Dimensione (in byte) di enum. Questa proprietà è correlata in modo diretto alla proprietà Conteggio lunghezza del CWF.
Se si seleziona il valore Compatto, verrà impostata la dimensione minima in cui è contenuto il valore maggiore nella numerazione. Selezionare la dimensione corrispondente a quella del programma che produce o utilizza messaggi CWF.
- 1
- 2
- 4
- Compatto - impostazione predefinita
- Codifica String
- Terminazione nulla. Quando viene selezionata la proprietà Terminazione nulla, viene importato un array di caratteri C di dimensione n come un elemento di tipo xsd:string e con un facet maxLength di n-1.
Se per la serie di messaggi è definito un formato fisico CWF, il tipo fisico CWF dell'elemento è Stringa terminata con valore nullo.
- Lunghezza fissa. Quando viene selezionata la proprietà Lunghezza fissa (impostazione predefinita), viene importato un array di caratteri C di
dimensione n come un elemento di tipo xsd:string e con un facet maxLength di n. Se per la serie di messaggi è definito un formato fisico CWF, il
tipo fisico CWF dell'elemento è Stringa a lunghezza fissa con un Conteggio lunghezza di n.
Tale opzione è valida solo per array di caratteri importati correntemente come xsd:string. Ad esempio, non include "unsigned char[2]" o "signed
char[2]", importati come restrizioni di xsd:integer.
- Carattere di riempimento per String
- Immettere il carattere di riempimento da utilizzare durante l'importazione del file di intestazione C. Selezionare una delle voci predefinite tra quelle elencate o immetterne una nel campo. Il valore deve essere risolto in un carattere singolo.
Impostare il carattere effettuando una delle procedure riportate di seguito:
- Selezionare NUL (valore predefinito), SPACE o "0" nell'elenco a discesa.
- Immettere un carattere tra apici, ad esempio "c" o 'c', dove
c rappresenta un carattere alfanumerico qualsiasi.
- Immettere un codice di carattere esadecimale nel formato 0xYY dove YY rappresenta un valore esadecimale.
- Immettere un codice di carattere decimale nel formato YY dove YY rappresenta un valore decimale.
- Immettere un valore Unicode nel formato U+xxxx dove xxxx rappresenta un valore Unicode specificato in esadecimali.
Tale opzione non è selezionabile se l'opzione Codifica String è diversa da Lunghezza fissa.