Learn R Programming

APSIM (version 0.9.3)

getToken: Extract a token from a vector of strings.

Description

Extract a token from a character vector in a data frame containing a number of delimited tokens. Specialised version of str_split that works on vectors.

Usage

getToken(x, cname, pos, sep, colName)

Arguments

x

A data frame

cname

The name of the column to extract a token from.

pos

The position of the desired token in the token string.

sep

The character to use as a seperator (e.g. ":", ";", etc.) Can be multi-character.

colName

A name for the new column.

Details

By default loadApsim will automatically create columns from constants inside the output files. However sometimes you might want to extract values from different data such as the file name. This is easy to do if the data is a fixed width, but it can be difficult when it's of variable length and delimited. str_split() is the most common way to deal with this sort of data, but it doesn't work on a vector.

getToken takes a data frame, a column of type 'character', a seperator and a token position to return each token in the given position. It then appends the token as a new column.