get_ordered_filename_array()

`get_ordered_filename_array()`#

Retrieves an ordered list of filenames from a specified directory, optionally filtered by a pattern and search options.

C

Prototype

char **get_ordered_filename_array(
    hgobj gobj,
    const char *root_dir,
    const char *pattern,
    wd_option opt,
    int *size
);

Parameters

Key	Type	Description
`gobj`	`hgobj`	A handle to the GObj instance, used for logging and error reporting.
`root_dir`	`const char *`	The root directory from which to retrieve filenames.
`pattern`	`const char *`	A regex pattern to filter filenames. If NULL, all files are included.
`opt`	`wd_option`	Options for directory traversal, such as recursion and file type filtering.
`size`	`int *`	Pointer to an integer that will be set to the number of files found.

Return Value

Returns a dynamically allocated array of strings containing the ordered filenames. The caller must free the array using free_ordered_filename_array().

Notes

This function uses qsort() to sort the filenames. The returned array must be freed properly to avoid memory leaks.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

get_ordered_filename_array()

get_ordered_filename_array()#

`get_ordered_filename_array()`#