Dela via


funktionen Storage_GetAbsolutePathInImagePackage

Sidhuvud: #include <applibs/storage.h>

Hämtar en null-avslutad sträng som innehåller den absoluta sökvägen till en plats i avbildningspaketet i det program som körs, givet en relativ sökväg i avbildningspaketet.

Avbildningspaketets plats och sökvägen som returneras av den här funktionen ändras inte när ett program körs. Platsen kan dock ändras mellan körningar av ett program.

Den här funktionen allokerar minne för den returnerade strängen, som ska frigöras av uppringaren med hjälp av free().

Den här funktionen kontrollerar inte om sökvägen finns i avbildningspaketet. Sökvägen kan inte börja med '/' eller '.' och får inte innehålla '.'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parametrar

  • relativePath En relativ sökväg från avbildningspaketets rot. Det här värdet får inte börja med katalogavgränsartecknet '/'.

Fel

Returnerar NULL om ett fel påträffas och anger errno felvärdet.

  • EINVAL: relativePath börjar med '/' eller '.' eller innehåller '.'.

  • EFAULT: relativePath är NULL.

  • Slut på minne.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar den absoluta sökväg som innehåller avbildningspaketroten, eller NULL vid fel, i vilket fall errno felvärdet är inställt.

Koncept och exempel