C8::Tuple

If you are writing data to a stream you create a tuple object, fill it with data, then write it to the stream. Similarly, if you are reading data from a stream, you receive a row of data, read the individual values from the tuple object, and then write the data to your destination.

• new() – Creates a new C8::Tuple object.
• column_names() – Gets an array that contains the names of the tuple columns.
• column_names(@val) – Sets the tuple column names to the values listed in the array.
• column_name_pos($name) – Gets the position of a column name. The first column is column 0 (not 1).
• timestamp() – Gets the tuple's timestamp, expressed as the number of seconds (not microseconds) since midnight January 1, 1970.
  Note: The Perl library contains functions to convert between seconds and more readable formats such as "YYYY-MM-DD HH24:MI:SS".
• timestamp($val) – Sets the tuple's timestamp to the specified value, expressed as the number of seconds (not microseconds) since midnight January 1, 1970.
  Note: The Perl library contains functions to convert between seconds and more readable formats such as "YYYY-MM-DD HH24:MI:SS".
• fields() – Gets the tuple fields list. This gets a complete row. The data is returned as an array, with one field per array element.
• fields($val) – Sets the tuple fields list. This sets a complete row. The data is passed as an array, with one field per array element.
• field($name) – Gets a single value from the current tuple. Given the name of the field, returns the value as a string.
• field($name,$val) – Sets a single value in the current tuple. The input parameters are the name of the field and the value of the field.
• as_csv_string() – Gets the tuple fields value from a CSV string. Note that the first field in the CSV string is the row timestamp value.
• as_csv_string($val) – Sets the tuple fields value from a CSV string. Note that the first field in the CSV string is the row timestamp value.