isrename(S) 6 January 1993 isrename(S) Name isrename - rename an ISAM file Syntax cc . . . -lisam isrename(oldname, newname) char *oldname; char *newname; Description The isrename function renames both the data and index files, specified by oldname to newname. You can use the following arguments with this rou- tine: _________________________________________________________________________ Argument Description _________________________________________________________________________ oldname Null-terminated string identifying the existing ISAM file that is to be renamed. newname Null-terminated string that is the new name of the file. When you use isrename, both the old and new filenames must be specified without any extensions and both files must be in the same directory. Otherwise, the operation can not succeed. If the file with the oldname does not exist or if the file with newname already exists, the operation can not succeed. On success, isrename returns a positive integer. Otherwise, it returns -1 and sets iserrno to indicate the error. Example This example changes the name of the books file to titles: isrename( "books", "titles" ) ; Standards conformance isrename is not part of any currently supported standard; it is an exten- sion of AT&T System V provided by the Santa Cruz Operation.