Get Files Count¶

This operation returns the number of files and optionally directories located in the specified path. Additional options include:

pattern filtering - counts files and directories which match the pattern.
recursive counting - when enabled, counts all matching files and directories while recursively traversing the directory structure.

Objective-CSwift

- (void)getFileCountWithResponseHandler:^(NSNumber * _Nonnull)responseHandler errorHandler:^(Fault * _Nonnull)errorHandler;

- (void)getFileCountWithPath:(NSString * _Nonnull)path responseHandler:^(NSNumber * _Nonnull)responseHandler errorHandler:^(Fault * _Nonnull)errorHandler;

- (void)getFileCountWithPath:(NSString * _Nonnull)path pattern:(NSString * _Nonnull)pattern responseHandler:^(NSNumber * _Nonnull)responseHandler errorHandler:^(Fault * _Nonnull)errorHandler;

- (void)getFileCountWithPath:(NSString * _Nonnull)path pattern:(NSString * _Nonnull)pattern recursive:(BOOL)recursive responseHandler:^(NSNumber * _Nonnull)responseHandler errorHandler:^(Fault * _Nonnull)errorHandler;

- (void)getFileCountWithPath:(NSString * _Nonnull)path pattern:(NSString * _Nonnull)pattern recursive:(BOOL)recursive countDirectories:(BOOL)countDirectories responseHandler:^(NSNumber * _Nonnull)responseHandler errorHandler:^(Fault * _Nonnull)errorHandler;

func getFileCount(responseHandler: ((NSNumber) -> Void)!, errorHandler: ((Fault) -> Void)!)

func getFileCount(path: String, responseHandler: ((NSNumber) -> Void)!, errorHandler: ((Fault) -> Void)!)

func getFileCount(path: String, pattern: String, responseHandler: ((NSNumber) -> Void)!, errorHandler: ((Fault) -> Void)!)

func getFileCount(path: String, pattern: String, recursive: Bool, responseHandler: ((NSNumber) -> Void)!, errorHandler: ((Fault) -> Void)!)

func getFileCount(path: String, pattern: String, recursive: Bool, countDirectories: Bool, responseHandler: ((NSNumber) -> Void)!, errorHandler: ((Fault) -> Void)!)

where:

Argument	Description
`path`	Path of a directory in the Backendless files storage starting with /
`pattern`	A pattern which the counted files and optionally directories (if the recursive parameter is set to `true`) must match. Backendless supports two formats for pattern: glob and regular expressions. You can specify the pattern matching format to use with a prefix as shown below: `glob:profilepic*.png` or `regex:pic[0-9]\.png`. If the prefix format is not specified, Backendless treats the pattern as glob.
`recursive`	If set to true, recursively count matching files in all subdirectories.
`countDirectories`	If set to true, count directories in addition to files.

Example¶

Objective-CSwift

[Backendless.shared.file getFileCountWithPath:@"web" pattern:@"*html" recursive:YES countDirectories:YES responseHandler:^(NSNumber *filesCount) {
    NSLog(@"Files count = %@", filesCount);
} errorHandler:^(Fault *fault) {
    NSLog(@"Error: %@", fault.message);
}];

Backendless.shared.file.getFileCount(path: "web", pattern: "*html", recursive: true, countDirectories: true, responseHandler: { filesCount in
    print("Files count = \(filesCount)")
}, errorHandler: { fault in
    print("Error: \(fault.message ?? "")")
})

Codeless Reference¶

files_api_get_files_count_1

where:

Argument	Description
`path`	A path identifying a directory where files and folders must be counted. The path must start with the root directory of the remote file storage.
`pattern`	A pattern which the counted files and optionally directories (if the recursive parameter is set to `true`) must match. Backendless supports two formats for pattern: glob and regular expressions. You can specify the pattern matching format to use with a prefix as shown below: `glob:profilepic*.png` or `regex:pic[0-9]\.png`. If the prefix format is not specified, Backendless treats the pattern as glob.
`recursive`	If set to `true`, recursively counts files in all subdirectories.
`count directories`	If set to `true`, counts directories in addition to files.

Returns the number of files and/or directories in the specified path.

Consider the following files stored in the days directory:

files_api_get_files_count_2

The example below counts the number of files in the "days" directory.

files_api_get_files_count_3

The result of this operation will look as shown below after the Codeless logic runs:

files_api_get_files_count_4