Infile reading structed files

## Infile reading structed files Infile reading structed files |

## Synopsis

                        GsfInfile;
    int                 gsf_infile_num_children             (GsfInfile *infile);
    GsfInput *          gsf_infile_child_by_index           (GsfInfile *infile,
                                                             int i);
    GsfInput *          gsf_infile_child_by_name            (GsfInfile *infile,
                                                             char const *name);
    GsfInput *          gsf_infile_child_by_vname           (GsfInfile *infile,
                                                             ...);
    GsfInput *          gsf_infile_child_by_aname           (GsfInfile *infile,
                                                             char const *names[]);
    GsfInput *          gsf_infile_child_by_vaname          (GsfInfile *infile,
                                                             va_list names);
    char const *        gsf_infile_name_by_index            (GsfInfile *infile,
                                                             int i);

## Object Hierarchy

      GObject
       +----GsfInput
             +----GsfInfile
                   +----GsfInfileMSOle
                   +----GsfInfileStdio
                   +----GsfInfileZip
                   +----GsfStructuredBlob

## Description

## Details

### GsfInfile

    typedef struct _GsfInfile GsfInfile;

### gsf_infile_num_children ()

    int                 gsf_infile_num_children             (GsfInfile *infile);

`infile` : | the structured storage
Returns : | the number of children the storage has, or -1 if the storage can not have children.

### gsf_infile_child_by_index ()

    GsfInput *          gsf_infile_child_by_index           (GsfInfile *infile,
                                                             int i);

TODO : For 2.0 api will change to include a GError.

`infile` : | GsfInfile
`i` : | target index
Returns : | a newly created child which must be unrefed.

### gsf_infile_child_by_name ()

    GsfInput *          gsf_infile_child_by_name            (GsfInfile *infile,
                                                             char const *name);

TODO : For 2.0 api will change to include a GError.

`infile` : | GsfInfile
`name` : | target name
Returns : | a newly created child which must be unrefed.

### gsf_infile_child_by_vname ()

    GsfInput *          gsf_infile_child_by_vname           (GsfInfile *infile,
                                                             ...);

`...` : | A `NULL` terminated list of names
Returns : | a newly created child which must be unrefed.

### gsf_infile_child_by_aname ()

    GsfInput *          gsf_infile_child_by_aname           (GsfInfile *infile,
                                                             char const *names[]);

New in 1.14.9.

`infile` : | GsfInfile
`names` : | A `NULL` terminated array of names (e.g. from g_strsplit)
Returns : | a newly created child which must be unrefed.

### gsf_infile_child_by_vaname ()

    GsfInput *          gsf_infile_child_by_vaname          (GsfInfile *infile,
                                                             va_list names);

New in 1.14.9.

`infile` : | GsfInfile
`names` : | A `NULL` terminated array of names (e.g. from g_strsplit)
Returns : | a newly created child which must be unrefed.

### gsf_infile_name_by_index ()

    char const *        gsf_infile_name_by_index            (GsfInfile *infile,
                                                             int i);

Returns : | the utf8 encoded name of the `i`-th child DO NOT FREE THE STRING.