Udostępnij za pośrednictwem

Funkcja Storage_GetAbsolutePathInImagePackage

  • Artykuł

Nagłówek: #include <applibs/storage.h>

Pobiera ciąg zakończony wartością null, który zawiera ścieżkę bezwzględną do lokalizacji w pakiecie obrazów uruchomionej aplikacji, mając względną ścieżkę wewnątrz pakietu obrazów.

Lokalizacja pakietu obrazów i ścieżka zwrócona przez tę funkcję nie zmienią się, gdy aplikacja jest uruchomiona. Jednak lokalizacja może się zmienić między wykonywaniami aplikacji.

Ta funkcja przydziela pamięć zwracanego ciągu, który powinien zostać uwolniony przez wywołującego za pomocą funkcji free().

Ta funkcja nie sprawdza, czy ścieżka istnieje w pakiecie obrazów. Ścieżka nie może zaczynać się od ciągu "/" lub "." i nie może zawierać ciągu ".".

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parametry

  • relativePath Względna ścieżka od katalogu głównego pakietu obrazów. Ta wartość nie może zaczynać się od znaku separatora katalogu "/".

Błędy

Zwraca wartość NULL, jeśli wystąpi błąd i ustawia errno wartość błędu.

  • EINVAL: relativePath zaczyna się od litery "/" lub "." lub zawiera ciąg ".".

  • EFAULT: relativePath is NULL.

  • ENOMEM: Brak pamięci.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca ścieżkę bezwzględną zawierającą główny adres główny pakietu obrazów lub wartość NULL dla błędu, w którym to przypadku errno jest ustawiona wartość błędu.

Pojęcia i próbki