getToken: Extract a token from a vector of strings.

In APSIM: General Utility Functions for the 'Agricultural Production Systems Simulator'

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.

APSIM documentation built on May 22, 2019, 9:03 a.m.