- (void) setReadOnly:(BOOL)value;

The function setReadOnly() forces the library to open files in read-only mode. It is useful if you do not want to modify your file accidenatly.
The function isReadOnly() allows you to get current mode.
You have to call setReadOnly before openning a file.

- (BOOL) isReadOnly;

    cdbfapi *dbf = [cdbfapi new];
    [dbf setReadOnly:YES];
    if ([dbf openDBFFile:@"./example.dbf"])
        // your code
        [dbf closeDBFFile];
    dbf = nil;