# NNS_FndGetArchiveFileByName

## Syntax

      #include <nnsys/fnd.h>

      void* NNS_FndGetArchiveFileByName(const char* path);

## Arguments

`path` | Path name inside the archive file.

## Return Values

The address where the file is stored. If the file cannot be found, returns `NULL`.

## Description

Uses the file system to search for the file with the path name specified by `path` and then get the storage address of the file that corresponds to this path name.

The pointer obtained with this function points to the content of the archive binary loaded in memory. To copy from this archive binary, read it using the file system's API.

This function can only be used to access files stored in a TWL-System archive, and not files stored anywhere else.

        extern void* archiveBinary;

        NNSFndArchive archive;

        if (NNS_FndMountArchive(&archive, "ARC", archiveBinary))
        {
            void* data = NNS_FndGetArchiveFileByName("ARC:/Data/Scene1.dat");

            ......
            ......
        }

## See Also

`NNS_FndGetArchiveFileByIndex`

## Revision History

2008/06/20 Revised the name of NITRO-System (from NITRO-System to TWL-System).
2004/05/14 Initial version.

CONFIDENTIAL