Bagikan melalui

Fungsi Storage_GetAbsolutePathInImagePackage

  • Artikel

Header: #include <applibs/storage.h>

Mendapatkan string null-terminated yang berisi jalur absolut ke lokasi dalam paket gambar aplikasi yang berjalan, mengingat jalur relatif di dalam paket gambar.

Lokasi paket gambar dan jalur yang dikembalikan oleh fungsi ini tidak akan berubah saat aplikasi sedang berjalan. Namun, lokasi mungkin berubah di antara eksekusi aplikasi.

Fungsi ini mengalokasikan memori untuk string yang dikembalikan, yang harus dibebaskan oleh penelepon menggunakan free().

Fungsi ini tidak memeriksa apakah jalur ada dalam paket gambar. Jalur tidak dapat dimulai dengan '/' atau '.', dan tidak bisa memuat '..'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parameter

  • relativePath Jalur relatif dari akar paket gambar. Nilai ini tidak boleh dimulai dengan karakter pemisah direktori '/'.

Kesalahan

Mengembalikan NULL jika terjadi kesalahan dan diatur errno ke nilai kesalahan.

  • EINVAL: relativePath dimulai dengan '/' atau '.', atau berisi '..'.

  • EFAULT: relativePath adalah NULL.

  • Kehabisan memori.

Kesalahan lainnya errno mungkin juga ditentukan; kesalahan tersebut tidak deterministik dan perilaku yang sama mungkin tidak dipertahankan melalui pembaruan sistem.

Mengembalikan nilai

Mengembalikan jalur absolut yang menyertakan akar paket gambar, atau NULL pada kesalahan, dalam hal errno ini diatur ke nilai kesalahan.

Konsep dan sampel