Introduction

FileOperations is a very special class that ease you the heavy task of system file handling.

With this class, you can perform the most common file operations tasks with just a single call very close to the standard shell's commands.

Main features are:

• Ease of use: all functions closely resemble shell's functions

• Configurability: using afc_fileops_set_tags() and afc_fileops_set_tag() you can change class behaviour in special situations.

• Power: function like afc_fileops_copy() or afc_fileops_del() are recursive, moving whole dir trees with a single function call.

To create a FileOperations instance, simply call afc_fileops_new() and delete it when you have finished using afc_fileops_delete() Since the task of creating and disposing this class is somewhat demaninding, please consider the opportunity of keeping an already allocated instance around if you think you could need it later.

Once you have a FileOperations instance working, you can do a lot of things. For example you can:

• Check whether a file/dir already exists with afc_fileops_exists() or afc_fileops_exists_full()

• Delete a file/dir with afc_fileops_del()

• Copy a file/dir with afc_fileops_copy()

• Move or rename a file/dir with afc_fileops_move()

• Create symlinks with afc_fileops_link()

• Alter file/dir permissions with afc_fileops_chmod()

• Alter file/dir user and group ids with afc_fileops_chown()

• Alter file/dir times with afc_fileops_utime()

There are some things you can configure, like whether to return or not an error code in case an afc_fileops_chmod() fails: see afc_fileops_set_tags() and afc_fileops_set_tag() for more info.