ObitFile.c File Reference

ObitFile class function definitions. More...

#include <sys/stat.h>
#include <sys/types.h>
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include "ObitFile.h"

Functions
void	ObitFileInit (gpointer in)
	Private: Initialize newly instantiated object.
void	ObitFileClear (gpointer in)
	Private: Deallocate members.
ObitFile *	newObitFile (gchar *name)
	Public: Constructor.
gconstpointer	ObitFileGetClass (void)
	Public: ClassInfo pointer.
ObitFile *	ObitFileZap (ObitFile *in, ObitErr *err)
	Public: destroy.
void	ObitFileRename (gchar *oldName, gchar *newName, ObitErr *err)
	Public: rename.
ObitFile *	ObitFileCopy (ObitFile *in, ObitFile *out, ObitErr *err)
	Public: Copy constructor.
gboolean	ObitFileExist (gchar *fileName, ObitErr *err)
	Public: Does a given file exist?
ObitFilePos	ObitFileSize (gchar *fileName, ObitErr *err)
	Public: What is the current size of a file.
gchar *	ObitFileName (gchar *fileName)
	Public: What is the name (without path) if a file.
ObitIOCode	ObitFileOpen (ObitFile *in, gchar *fileName, ObitIOAccess access, ObitIOType type, glong blockSize, ObitErr *err)
	Public: Open.
ObitIOCode	ObitFileClose (ObitFile *in, ObitErr *err)
	Public: Close.
ObitIOCode	ObitFileSetPos (ObitFile *in, ObitFilePos filePos, ObitErr *err)
	Public: Position file.
ObitIOCode	ObitFileEnd (ObitFile *in, ObitErr *err)
	Public: Position at end of file.
ObitIOCode	ObitFileRead (ObitFile *in, ObitFilePos filePos, glong size, gchar *buffer, ObitErr *err)
	Public: Read.
ObitIOCode	ObitFileReadLine (ObitFile *in, gchar *line, gint lineMax, ObitErr *err)
	Public: Read next line of text file.
ObitIOCode	ObitFileWrite (ObitFile *in, ObitFilePos filePos, glong size, gchar *buffer, ObitErr *err)
	Public: Write.
ObitIOCode	ObitFileWriteLine (ObitFile *in, gchar *line, ObitErr *err)
	Public: Write next line to text file.
ObitIOCode	ObitFilePad (ObitFile *in, glong padTo, gchar *buffer, glong bsize, ObitErr *err)
	Public: Pad remainder of a block.
ObitIOCode	ObitFilePadFile (ObitFile *in, glong blksize, ObitErr *err)
	Public: Pad end of file to an integral of a given size.
ObitIOCode	ObitFileFlush (ObitFile *in, ObitErr *err)
	Public: Flush Buffer.
gboolean	ObitFileErrMsg (ObitErr *err)
	Public: Utility, Error message for errno.
void	ObitFileClassInit (void)
	Public: Class initializer.

---

Detailed Description

ObitFile class function definitions.

This Class allows access to the underlying file system.

---

Function Documentation

ObitFile* newObitFile (  gchar *  name  )

Public: Constructor. Initializes class if needed on first call. Returns: the new object.

void ObitFileClassInit (  void   )

Public: Class initializer.

void ObitFileClear (  gpointer  inn  )

Private: Deallocate members. Does (recursive) deallocation of parent class members. Parameters: inn  Pointer to the object to deallocate.

ObitIOCode ObitFileClose (  ObitFile *  in, ObitErr *  err )

Public: Close. Parameters: in  Pointer to object to be closed. err  ObitErr for reporting errors. Returns: error code, 0=> OK

ObitFile* ObitFileCopy (  ObitFile *  in, ObitFile *  out, ObitErr *  err )

Public: Copy constructor. The result will have pointers to the more complex members. Parent class members are included but any derived class info is ignored. The contents of any files are not modified. Parameters: in  The object to copy out  An existing object pointer for output or NULL if none exists. err  Obit error stack object. Returns: pointer to the new object.

ObitIOCode ObitFileEnd (  ObitFile *  in, ObitErr *  err )

Public: Position at end of file. Parameters: in  Pointer to object to be positioned. err  ObitErr for reporting errors. Returns: error code, 0=> OK

gboolean ObitFileErrMsg (  ObitErr *  err  )

Public: Utility, Error message for errno. errno is reset to 0. Parameters: err  ObitErr for reporting errors. Returns: True if error

gboolean ObitFileExist (  gchar *  fileName, ObitErr *  err )

Public: Does a given file exist? Parameters: fileName  Name of file to test. err  ObitErr for reporting errors. Returns: TRUE if exists, else FALSE.

ObitIOCode ObitFileFlush (  ObitFile *  in, ObitErr *  err )

Public: Flush Buffer. Note: this is done automatically on Close. Parameters: in  Pointer to object to flush. err  ObitErr for reporting errors. Returns: return code, 0=> OK

gconstpointer ObitFileGetClass (  void   )

Public: ClassInfo pointer. Initializes class if needed on first call. Returns: pointer to the class structure.

void ObitFileInit (  gpointer  inn  )

Private: Initialize newly instantiated object. Does (recursive) initialization of base class members before this class. Parameters: inn  Pointer to the object to initialize.

gchar* ObitFileName (  gchar *  fileName  )

Public: What is the name (without path) if a file. Parameters: fileName  Name of file Returns: File size in bytes, g_free when done

ObitIOCode ObitFileOpen (  ObitFile *  in, gchar *  fileName, ObitIOAccess  access, ObitIOType  type, glong  blockSize, ObitErr *  err )

Public: Open. The file will be positioned at the beginning. Parameters: in  Pointer to object to be opened. fileName  Name of file to open. access  access (OBIT_IO_ReadOnly,OBIT_IO_ReadWrite) type  type of file (OBIT_IO_Binary, OBIT_IO_Text). blockSize  Size of any blocking (used for AIPS files) 0->none. err  ObitErr for reporting errors. Returns: return code, OBIT_IO_OK => OK

ObitIOCode ObitFilePad (  ObitFile *  in, glong  padTo, gchar *  buffer, glong  bsize, ObitErr *  err )

Public: Pad remainder of a block. This is mostly useful for AIPS files for which ancient concepts of file blocking are enforced. Parameters: in  Pointer to object to be written. padTo  Final (0-rel) file position to be written. buffer  buffer whose contents are to be used to pad the file. bsize  Size in bytes of buffer. err  ObitErr for reporting errors. Returns: return code, 0=> OK

ObitIOCode ObitFilePadFile (  ObitFile *  in, glong  blksize, ObitErr *  err )

Public: Pad end of file to an integral of a given size. Any unwritten bytes are zero filled. This is mostly useful for AIPS files for which ancient concepts of file blocking are enforced. Parameters: in  Pointer to object to be padded. blksize  Size in bytes of blocking size. err  ObitErr for reporting errors. Returns: return code, 0=> OK

ObitIOCode ObitFileRead (  ObitFile *  in, ObitFilePos  filePos, glong  size, gchar *  buffer, ObitErr *  err )

Public: Read. Parameters: in  Pointer to object to be read. filePos  File position in bytes of beginning of read <0 => start at current position. size  number of bytes to read. buffer  pointer to buffer to accept results. err  ObitErr for reporting errors. Returns: return code, 0=> OK

ObitIOCode ObitFileReadLine (  ObitFile *  in, gchar *  line, gint  lineMax, ObitErr *  err )

Public: Read next line of text file. Parameters: in  Pointer to object to be read. line  pointer to memory to accept the text may be newline terminated. lineMax  size in characters of line err  ObitErr for reporting errors. Returns: return code, OBIT_IO_OK => OK

void ObitFileRename (  gchar *  oldName, gchar *  newName, ObitErr *  err )

Public: rename. Parameters: oldName  Current name for file newName  New name for file err  ObitErr for reporting errors.

ObitIOCode ObitFileSetPos (  ObitFile *  in, ObitFilePos  filePos, ObitErr *  err )

Public: Position file. Parameters: in  Pointer to object to be positioned. filePos  File position in bytes of beginning of file err  ObitErr for reporting errors. Returns: error code, 0=> OK

ObitFilePos ObitFileSize (  gchar *  fileName, ObitErr *  err )

Public: What is the current size of a file. Parameters: fileName  Name of file to test. err  ObitErr for reporting errors. Returns: File size in bytes

ObitIOCode ObitFileWrite (  ObitFile *  in, ObitFilePos  filePos, glong  size, gchar *  buffer, ObitErr *  err )

Public: Write. Parameters: in  Pointer to object to be written. filePos  File position in bytes of beginning of write <0 => start at current position. size  number of bytes to write. buffer  Pointer to buffer to receive output data. err  ObitErr for reporting errors. Returns: return code, 0=> OK

ObitIOCode ObitFileWriteLine (  ObitFile *  in, gchar *  line, ObitErr *  err )

Public: Write next line to text file. Parameters: in  Pointer to object to be written line  pointer to memory to text to be written, should be newline terminated. err  ObitErr for reporting errors. Returns: return code, OBIT_IO_OK => OK

ObitFile* ObitFileZap (  ObitFile *  in, ObitErr *  err )

Public: destroy. Parameters: in  Pointer to object to be zapped. err  ObitErr for reporting errors. Returns: NULL as value of pointer to in, on failure returns in.

---