class RuntimeException;
/**
- Separa la cadena recibida en distintos elementos.
+ Tokenize the input string into several elements
*/
class Tokenizer {
+
+ int _apply(const char* str, const char* separator) throw(RuntimeException);
+
public:
typedef char* const* const_iterator;
const char* operator [](const int i) const throw(RuntimeException) { return at(i); }
/**
- Aplica la separacion sobre la cadena str con el separador recibido como parametro.
+ Process the separation over the string str with the separator provided.
- @param str Cadena sobre la que aplicar la separacion.
- @param separator Caracteres que van a actuar como separador de las subcadenas contenidas en el
- primer parametro.
+ Internally used strtok_r has these imitations: sequence of two or more contiguous delimiter
+ bytes in the parsed string is considered to be a single delimiter. Delimiter bytes at the start
+ or end of the string are ignored. Put another way: the tokens returned by strtok() are always
+ nonempty strings. To override these limitations, the string provided can be internally modified
+ inserting a artificial token in order to cheat on strtok_r. For this feature, you may provide
+ '<null>' or whatever string (non-empty) you prefer.
- @return Numero de elementos obtenidos al aplicar la separacion.
+ @param str String to apply the separation.
+ @param separator Characters used as separator within the string tokenized
+ @param tokenizeContiguous If provided, it will be the artificial token used internally. The
+ resulting tokens shall store this string in case of contiguous separators. NULL by
+ default (original strtok_r behaviour).
+ @return Number of tokens
*/
- int apply(const std::string& str, const char* separator) throw(RuntimeException) {
- return apply(str.c_str(), separator);
+ int apply(const char* str, const char* separator, const char *tokenizeContiguous = NULL) throw(RuntimeException);
+ int apply(const std::string& str, const char* separator, const char *tokenizeContiguous = NULL) throw(RuntimeException) {
+ return apply(str.c_str(), separator, tokenizeContiguous);
}
- /**
- Aplica la separacion sobre la cadena str con el separador recibido como parametro.
-
- @param str Cadena sobre la que aplicar la separacion.
- @param separator Caracteres que van a actuar como separador de las subcadenas contenidas en el
- primer parametro.
-
- @return Numero de elementos obtenidos al aplicar la separacion.
-
- */
- int apply(const char* str, const char* separator) throw(RuntimeException);
// Metodos
/**