CSV Policy C++ Interface — oosxl 0.1.0 documentation

# CSV Policy C++ Interface

The C++ interface defines the abstract interface `iCSVPolicy` in the `oo` namespace. This interface provides formatting configuration options for parsing CSV.

## Class Definition

class oo::iCSVPolicy

  Abstract interface for CSV Policy configuration.

## Character Handling

virtual char oo::iCSVPolicy::get_delimiter() const

  Gets the current field delimiter.

  Returns:

    The delimiter character.

virtual bool oo::iCSVPolicy::set_delimiter(char delim)

  Sets the field delimiter.

  Parameters:

    delim – The delimiter character to set.

  Returns:

    `true` on success, `false` on failure.

virtual char oo::iCSVPolicy::get_quote() const

  Gets the current string escaping character.

  Returns:

    The string escaping character.

virtual void oo::iCSVPolicy::set_quote(char quote)

  Sets the string escaping character.

  Parameters:

    quote – The string escaping character to set.

virtual void oo::iCSVPolicy::set_no_quote()

  Disables string escaping.

virtual bool oo::iCSVPolicy::is_quote_enabled() const

  Checks whether string escaping is enabled.

  Returns:

    `true` if enabled, otherwise `false`.

virtual void oo::iCSVPolicy::add_trim_char(char trim_char)

  Adds a character to the set of trim characters. If the character appears before or after a field value, it will be stripped during field value parsing.

  Parameters:

    trim_char – The character to add to the trim set.

virtual void oo::iCSVPolicy::clear_trim_chars()

  Clears all trim characters.

## Column Handling

virtual void oo::iCSVPolicy::ignore_column(int col)

  Marks a column to be ignored during parsing.

  Parameters:

    col – The 1‑based column index to ignore.

## Numeric Formatting

virtual char oo::iCSVPolicy::decimal_symbol() const

  Gets the current decimal point symbol.

  Returns:

    The decimal point symbol.

virtual void oo::iCSVPolicy::set_decimal_symbol(char symbol)

  Sets the decimal point symbol.

  Parameters:

    symbol – The decimal point symbol.

virtual char oo::iCSVPolicy::group_separator() const

  Gets the current digit grouping separator (e.g., thousands separator).

  Returns:

    The digit grouping separator.

virtual void oo::iCSVPolicy::set_group_separator(char sep)

  Sets the digit grouping separator (e.g., thousands separator).

  Parameters:

    sep – The digit grouping separator.

virtual int oo::iCSVPolicy::group_size() const

  Gets the current digit grouping size (e.g., for thousands separators, the group size is 3).

  Returns:

    The grouping size (number of digits per group).

virtual void oo::iCSVPolicy::set_group_size(int size)

  Sets the digit grouping size (e.g., for thousands separators, the group size is 3).

  Parameters:

    size – The grouping size.

## Currency

virtual const char *oo::iCSVPolicy::currency_sign() const

  Gets the current currency sign string (e.g., `"$"`, `"USD"`).

  Returns:

    The currency sign string.

virtual void oo::iCSVPolicy::set_currency_sign(const char *sign)

  Sets the currency sign (e.g., `"$"`, `"USD"`).

  Parameters:

    sign – The currency sign string.

## Date/Time Format

virtual const char *oo::iCSVPolicy::datetime_format() const

  Gets the current date/time format string.

  Returns:

    The date/time format string.

virtual void oo::iCSVPolicy::set_datetime_format(const char *fmt)

  Sets the date/time format string.

  Parameters:

    fmt – The date/time format string (e.g., `"%Y-%m-%d %H:%M:%S"`).

### Date/Time Format Specifier Reference

Specifier | Description | Example
--- | --- | ---
%Y | Full year | 2026
%y | Last two digits of year | 26
%m | Two‑digit month (01 to 12) | 01
%b | Abbreviated month name (Jan, Feb, …) | Jan
%h | Same as %b |
%B | Full month name (January, February, …) | January
%d | Two‑digit day (01 to 31) | 03
%a | Abbreviated weekday (Sun, Mon, …) | Mon
%A | Full weekday (Sunday, Monday, …) | Monday
%H | Hour in 24‑hour format (00 to 23) | 14
%I | Hour in 12‑hour format (01 to 12) | 02
%M | Minute (00 to 59) | 45
%S | Second (00 to 59) | 30
%p | AM or PM (with 12‑hour hour) | AM
%z | Time zone offset (e.g., +0200 or -0800) | +0000
%Z | Time zone name (Only “UTC” is supported) | UTC
%n | Matches whitespace |
%t | Matches whitespace |
%. | Matches any character (skips it) |

Styled using the Piccolo Theme