File
[ class tree: File ] [ index: File ] [ all elements ]
Packages:
File


Classes:
File
File_CSV
Files:
CSV.php
File.php
FileTest.php
parser.php
Util.php

Class: File_CSV

Source Location: /File-1.3.0/File/CSV.php

Class Overview




File class for handling CSV files (Comma Separated Values), a common format  for exchanging data.




Author(s):






        







Methods
















Inherited Variables





Inherited Methods














Class Details



[line 57]

File class for handling CSV files (Comma Separated Values), a common format  for exchanging data.
TODO: 
  • Usage example and Doc
  • Use getPointer() in discoverFormat
  • Add a line counter for being able to output better error reports
  • Store the last error in GLOBALS and add File_CSV::getLastError()
  Wish: 
  • Other methods like readAll(), writeAll(), numFields(), numRows()
  • Try to detect if a CSV has header or not in discoverFormat() (not possible with CSV)
  Known Bugs:  (they has been analyzed but for the moment the impact in the speed for   properly handle this uncommon cases is too high and won't be supported) 
  • A field which is composed only by a single quoted separator (ie -> ;";";)
    is not handled properly
  • When there is exactly one field minus than the expected number and there
    is a field with a separator inside, the parser will throw the "wrong count" error
  Info about CSV and links to other sources  http://www.shaftek.org/publications/drafts/mime-csv/draft-shafranovich-mime-csv-00.html#appendix









[ Top ]








Method Detail



	
	
discoverFormat   [line 496]

	

    

    

		mixed discoverFormat(
string
$file, [array
$extraSeps = array()])
    

    


	
		Discover the format of a CSV file (the number of fields, the separator  and if it quote string fields)


    

  • Return: Assoc array or false
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          the CSV file name
      

          

        array  
        $extraSeps  
        —
          extra separators that should be checked for.
      

        

    


        
[ Top ]

  

  
  
	
	
getPointer   [line 134]

	

    

    

		mixed getPointer(
string
$file, array
&$conf, [string
$mode = FILE_MODE_READ], [boolean
$reset = false])
    

    


	
		Return or create the file descriptor associated with a file


    

  • Return: A file resource or false
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          The name of the file
      

          

        array  
        &$conf  
        —
          The configuration
      

          

        string  
        $mode  
        —
          The open node (ex: FILE_MODE_READ or FILE_MODE_WRITE)
      

          

        boolean  
        $reset  
        —
          if passed as true and resource for the file exists                        than the file pointer will be moved to the beginning
      

        

    


        
[ Top ]

  

  
  
	
	
raiseError   [line 67]

	

    

    

		bool raiseError(
string
$error)
    

    


	
		This raiseError method works in a different way. It will always return  false (an error occurred) but it will call PEAR::raiseError() before  it. If no default PEAR global handler is set, will trigger an error.


    

  • Return: always false
    • 








        
Parameters:

    

    

          

        string  
        $error  
        —
          The error message
      

        

    


        
[ Top ]

  

  
  
	
	
read   [line 346]

	

    

    

		mixed read(
string
$file, array
&$conf)
    

    


	
		Reads a "row" from a CSV file and return it as an array


    

  • Return: Array or false
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          The CSV file
      

          

        array  
        &$conf  
        —
          The configuration of the dest CSV
      

        

    


        
[ Top ]

  

  
  
	
	
readQuoted   [line 212]

	

    

    

		mixed readQuoted(
string
$file, array
&$conf)
    

    


	
		Reads a row of data as an array from a CSV file. It's able to  read memo fields with multiline data.


    

  • Return: Array with the data read or false on error/no more data
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          The filename where to write the data
      

          

        array  
        &$conf  
        —
          The configuration of the dest CSV
      

        

    


        
[ Top ]

  

  
  
	
	
resetPointer   [line 620]

	

    

    

		boolean resetPointer(
string
$file, array
&$conf, string
$mode)
    

    


	
		Front to call getPointer and moving the resource to the  beginning of the file  Reset it if you like.


    

  • Return: true on success false on failure
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          The name of the file
      

          

        array  
        &$conf  
        —
          The configuration
      

          

        string  
        $mode  
        —
          The open node (ex: FILE_MODE_READ or FILE_MODE_WRITE)
      

        

    


        
[ Top ]

  

  
  
	
	
unquote   [line 167]

	

    

    

		string unquote(
string
$field, string
$quote)
    

    


	
		Unquote data


    

  • Return: the unquoted data
    • 








        
Parameters:

    

    

          

        string  
        $field  
        —
          The data to unquote
      

          

        string  
        $quote  
        —
          The quote char
      

        

    


        
[ Top ]

  

  
  
	
	
write   [line 454]

	

    

    

		bool write(
string
$file, array
$fields, array
&$conf)
    

    


	
		Writes a struc (array) in a file as CSV


    

  • Return: True on success false otherwise
    • 








        
Parameters:

    

    

          

        string  
        $file  
        —
          The filename where to write the data
      

          

        array  
        $fields  
        —
          Ordered array with the data
      

          

        array  
        &$conf  
        —
          The configuration of the dest CSV
      

        

    


        
[ Top ]

  

  
  



        

		    

		    Documentation generated on Fri, 01 Jun 2007 18:00:05 -0400 by phpDocumentor 1.3.2. PEAR Logo Copyright ©  PHP Group 2004.