# NNS_FndGetArchiveFileByName

## C Specification

      #include <nnsys/fnd.h>

      void* NNS_FndGetArchiveFileByName(const char* path);

## Arguments

`path` | The path name inside the archive file.

## Return Values

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

## Description

This function 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 access files stored in a NITRO-System archive, and not any 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

05/14/2004 Initial version.