• 
• 
• Reference
• 
• Data Loading
• 
• CSV

csv

Reads structured data from a CSV file.

The CSV file will be read and parsed into a 2-dimensional array of strings: Each row in the CSV file will be represented as an array of strings, and all rows will be collected into a single array. Header rows will not be stripped.

Example

#let results = csv("example.csv")

#table(
  columns: 2,
  [*Condition*], [*Result*],
  ..results.flatten(),
)

Parameters

Parameters are the inputs to a function. They are specified in parentheses after the function name.

source

str or bytes

RequiredPositional

Positional parameters are specified in order, without names.

A path to a CSV file or raw CSV bytes.

delimiter

str

The delimiter that separates columns in the CSV file. Must be a single ASCII character.

Default: ","

row-type

type

How to represent the file's rows.

• If set to array, each row is represented as a plain array of strings.
• If set to dictionary, each row is represented as a dictionary mapping from header keys to strings. This option only makes sense when a header row is present in the CSV file.

Default: array

Definitions

Functions and types and can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.

decode

csv.decode is deprecated, directly pass bytes to csv instead

Reads structured data from a CSV string/bytes.

data

str or bytes

RequiredPositional

Positional parameters are specified in order, without names.

CSV data.

delimiter

str

The delimiter that separates columns in the CSV file. Must be a single ASCII character.

Default: ","

row-type

type

How to represent the file's rows.

• If set to array, each row is represented as a plain array of strings.
• If set to dictionary, each row is represented as a dictionary mapping from header keys to strings. This option only makes sense when a header row is present in the CSV file.

Default: array

CBORPrevious page

JSONNext page