Referencia del Archivo Spanish.txt

#include "CSV.h"
#include <string>
#include <iostream>
#include <vector>
#include <stdlib.h>


Namespaces

namespace  std
 Definido por la biblioteca estándar C++.

Definiciones

#define Spanish_dox   "Documentación en español"
 Documentación en español.
#define CSV_line_h
 Evita la inclusión múltiple.
#define Spanish_dox   "Documentación en español"
 Documentación en español.

Funciones

int getNextCSV (char *res, size_t res_size, int(getChar)(void *context))
 Retrieves from the input character stream getChar() then next CSV value.
char * putCSV (char *res, size_t res_size, const char *line)
 Prepares line for output into a CSV file.
char * trim (char *str)
 Retorna la mayor subhilera de "str" que no tiene blancos al principio o al final.
void chop (char *str, char ch)
 Elimina ch si es el último caracter de str.

Documentación de las definiciones

#define Spanish_dox   "Documentación en español"

Documentación en español.

Definición en la línea 88 del archivo Spanish.txt.

#define CSV_line_h

Evita la inclusión múltiple.

Definición en la línea 22 del archivo Spanish.txt.

#define Spanish_dox   "Documentación en español"

Documentación en español.

Definición en la línea 88 del archivo Spanish.txt.


Documentación de las funciones

int getNextCSV ( char *  res,
size_t  res_size,
int(getChar)(void *context)   
)

Retrieves from the input character stream getChar() then next CSV value.

  • On each invocation to getChar() a single character is retrieved.
  • When nor more caracteres are available getChar() must retorn -1.
  • Stores the CSV value read into memory buffer res.
  • Buffer res can hold up to res_size char's.
  • If the value read is bigger than what res can hold only as many char's as will fit into res are retrieved; in this case, the full value will not be read.
  • If the full CSV value can be stored into res returns 1, otherwise signals failure returning 0.
  • The number of characters retrieved from getChar() always is strlen(res).

char* putCSV ( char *  res,
size_t  res_size,
const char *  line 
)

Prepares line for output into a CSV file.

  • Stores the resulting string in memory buffer res.
  • Buffer res can hold up to res_size char's.
  • NULL is returned whenever more than res_size char's are required.
  • Otherwise, returns res.

  • Surrounds the result in double-quotes when line has whitespace.
  • Surrounds the result in double-quotes when line has double-quotes.
  • Surrounds the result in double-quotes when line has commas ','.
  • Substitutes any double-quotes '"' within line with 2 double-quotes [""].

char* trim ( char *  str  ) 

Retorna la mayor subhilera de "str" que no tiene blancos al principio o al final.

  • Modifica la hilera "str" y retorna un puntero dentro de ella.
  • Si "str" tiene blancos al final, los elimina insertándole un char(0).
  • También elimina los caracteres " \f\n\r\t\v".
  • Usa isspace(ch) para determinar si una letra es o no es algún tipo de espacio whitespace.

    {{  // test::trim_C()
        char str[20];
        strcpy( str , " a b   " ); assertTrue( strcmp( trim(str), "a b" ) == 0 );
        strcpy( str , "  a\nb " ); assertTrue( strcmp( trim(str), "a\nb") == 0 );
        strcpy( str , ""        ); assertTrue( strcmp( trim(str), ""    ) == 0 );
        strcpy( str , "\r\t\n " ); assertTrue( strcmp( trim(str), ""    ) == 0 );
        strcpy( str , " a b "   ); assertTrue( strcmp( trim(str), "a b" ) == 0 );
        strcpy( str , " ab "    ); assertTrue( strcmp( trim(str), "ab"  ) == 0 );

    }}
Ver también:
test_CSV::test_trim_C()

void chop ( char *  str,
char  ch 
)

Elimina ch si es el último caracter de str.

  • El caracter eliminado siempre es ch.

    {{  // test::chop_C()
        char str[20]; char ch;
        strcpy( str , "12345") ; assertTrue( strcmp(str ,"12345")==0 );
        chop(str,'0');           assertTrue( strcmp(str ,"12345")==0 );

        for ( ch='5'; ch != '0'; --ch ) {
            assertTrue( str[strlen(str)-1] == ch );
            chop(str,ch);
        }

        assertTrue( *str == 0 );
        chop(str,'3'); assertTrue( *str == 0 );
    }}
Ver también:
test_CSV::test_chop_C()


Generado el Wed May 27 11:04:47 2009 para CSV: por  doxygen 1.5.8