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()