---
name: "Strings.fields"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Strings.fields"
---

# Strings.fields(3kaya)

Split a string into fields

## NAME

Strings::fields - Split a string into fields

## SYNOPSIS

**\[String\] fields(** *String input, \[Char\] delimiters, \[Char\] escape* **)**

## ARGUMENTS

**input** The input string

**delimiters** A list of characters that are treated as delimiters

**escape** Characters that escape the string - i.e. delimiters between two escape characters are treated as literal characters.

## DESCRIPTION

This function splits a string into fields. For example, to split a CSV file, you could use **fields(input,\[',','\\n'\],\['"'\]);** \
  This will treat commas and newlines as field separators, except within quoted strings.

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Regex.split (3kaya)**