home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ifl / iflFileDesc.z / iflFileDesc
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))    IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc - IFL's image file descriptor
  10.  
  11.  
  12. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  13.      This is a base class with no inheritance.
  14.  
  15.  
  16. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  17.      #include <ifl/iflFileDesc.h>
  18.  
  19.  
  20. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      iflFileDesc is IFL's image file descriptor.  It is created from a file
  22.      name and/or a Unix file descriptor.  It can either parse apart the
  23.      components of a IFL file name (Unix file name, image index, format name,
  24.      format specific string) or be supplied with a pre-parsed name.
  25.  
  26.      An iflFileDesc can be used to pre-parse an IFL file name, perhaps to
  27.      check if the Unix file already exists when saving to a file, and then
  28.      passed to iiiiffffllllFFFFiiiilllleeee::::::::ooooppppeeeennnn() or iiiiffffllllFFFFiiiilllleeee::::::::ccccrrrreeeeaaaatttteeee() to avoid reparsing the
  29.      name.  It can also be used to implement a different file name syntax by
  30.      passing the pre-parsed file name to the alternate constructors.
  31.  
  32. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  33.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
  34.  
  35.           iflFileDesc(const char* name, iflFormat* format=NULL)
  36.           iflFileDesc(const char* fileName, int index,
  37.                       const char* formatName=NULL,
  38.                       const char* formatSpecific=NULL)
  39.           iflFileDesc(const char* fileName, int index, iflFormat* format,
  40.                       const char* formatSpecific=NULL)
  41.  
  42.      GGGGeeeetttt aaaannnndddd sssseeeetttt mmmmeeeetttthhhhooooddddssss
  43.  
  44.           void setFileDesc(int filedesc)
  45.           iflStatus getStatus()
  46.           const char* getFileName()
  47.           int getFileDesc()
  48.           int getIndex()
  49.           const char* getFormatName()
  50.           iflFormat* getFormat()
  51.           const char* getFormatSpecific()
  52.  
  53.  
  54.  
  55. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  56.      iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc(((())))
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))    IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))
  71.  
  72.  
  73.  
  74.           iflFileDesc(const char* fileName, int index,
  75.                       const char* formatName=NULL,
  76.                       const char* formatSpecific=NULL)
  77.           iflFileDesc(const char* fileName, int index, iflFormat* format,
  78.                       const char* formatSpecific=NULL)
  79.           iflFileDesc(const char* name, iflFormat* format=NULL)
  80.  
  81.  
  82.           The first contructor creates a descriptor by parsing a IFL file name
  83.           into it's components: Unix file name, image index, format name and
  84.           format specifc string.  The second contructor creates a descriptor
  85.           from an already parsed name, The third version is the same as the
  86.           second except it takes the format by pointer instead of by name.
  87.  
  88.      ggggeeeettttFFFFiiiilllleeeeDDDDeeeesssscccc(((())))
  89.  
  90.           int getFileDesc()
  91.  
  92.  
  93.           This method returns the Unix file descriptor.
  94.  
  95.      ggggeeeettttFFFFiiiilllleeeeNNNNaaaammmmeeee(((())))
  96.  
  97.           const char* getFileName()
  98.  
  99.  
  100.           This method returns the Unix file name portion of the parsed name.
  101.  
  102.      ggggeeeettttFFFFoooorrrrmmmmaaaatttt(((())))
  103.  
  104.           iflFormat* getFormat()
  105.  
  106.  
  107.           This method returns the iflFormat* for the format name portion of
  108.           the parsed name.
  109.  
  110.      ggggeeeettttFFFFoooorrrrmmmmaaaattttNNNNaaaammmmeeee(((())))
  111.  
  112.           const char* getFormatName()
  113.  
  114.  
  115.           This method returns the format name portion of the parsed name.
  116.  
  117.      ggggeeeettttFFFFoooorrrrmmmmaaaattttSSSSppppeeeecccciiiiffffiiiicccc(((())))
  118.  
  119.           const char* getFormatSpecific()
  120.  
  121.  
  122.           This method returns the format specifc portion of the parsed name.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))    IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiiffffllllFFFFiiiilllleeeeDDDDeeeesssscccc((((3333))))
  137.  
  138.  
  139.  
  140.      ggggeeeettttIIIInnnnddddeeeexxxx(((())))
  141.  
  142.           int getIndex()
  143.  
  144.  
  145.           This method returns the sub-image index portion of the parsed name.
  146.  
  147.      ggggeeeettttSSSSttttaaaattttuuuussss(((())))
  148.  
  149.           iflStatus getStatus()
  150.  
  151.  
  152.           This method returns the status of parsing the file name (e.g. if an
  153.           unknown format name was encoutered).
  154.  
  155.      sssseeeettttFFFFiiiilllleeeeDDDDeeeesssscccc(((())))
  156.  
  157.           void setFileDesc(int filedesc)
  158.  
  159.  
  160.           This method can be used to let IFL know that the file is already
  161.           opened and to used this file descriptor rather than re-opening it.
  162.  
  163. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  164.      iflFile(3), iflFormat(3)
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.