Funzione Storage_GetAbsolutePathInImagePackage

  • Articolo

Intestazione: #include <applicazioni/storage.h>

Ottiene una stringa terminata da null che contiene il percorso assoluto di una posizione all'interno del pacchetto di immagini dell'applicazione in esecuzione, dato un percorso relativo all'interno del pacchetto di immagini.

La posizione del pacchetto di immagini e il percorso restituito da questa funzione non cambieranno durante l'esecuzione di un'applicazione. Tuttavia, la posizione può cambiare tra le esecuzioni di un'applicazione.

Questa funzione alloca memoria per la stringa restituita, che deve essere liberata dal chiamante utilizzando free().

Questa funzione non controlla se il percorso esiste nel pacchetto di immagini. Il percorso non può iniziare con '/' o '.' e non può contenere '.'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parametri

  • relativePath Percorso relativo dalla radice del pacchetto di immagini. Questo valore non deve iniziare con il carattere separatore di directory '/'.

Errori

Restituisce NULL se si verifica un errore e imposta errno il valore di errore.

  • EINVAL: relativePath inizia con '/' o '.', oppure contiene '.'.

  • EFAULT: relativePath è NULL.

  • ENOMEM: memoria esaurita.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce il percorso assoluto che include la radice del pacchetto di immagini o NULL all'errore, nel qual caso errno è impostato sul valore di errore.

Concetti ed esempi