foop/src/deps/fp/last.js

interfaces that describe their intentions.

const isIndexable = require('../is/indexable')
const lastIndex = require('./lastIndex')

/**
 * Returns the last element of the given list or string.
 *
 * @func
 * @memberOf fp
 * @since 5.0.0-beta.2
 *
 * @param {*} x list to get last index of
 * @return {*}
 *
 * @tests fp/last
 *
 * @ramda v0.1.4
 * @category List
 * @sig [a] -> a | Undefined
 * @sig String -> String
 *
 * @see R.init, R.head, R.tail
 * @extends deps/fp/lastIndex
 *
 * {@link https://github.com/jashkenas/underscore/blob/master/underscore.js#L507 underscore-last}
 * @see {@link underscore-last}
 *
 * @types fp
 * @tests fp/*
 *
 * @example
 *
 *      last(['fi', 'fo', 'fum']); //=> 'fum'
 *      last([]); //=> undefined
 *
 *      last('abc'); //=> 'c'
 *      last(''); //=> ''
 *
 */
module.exports = x => (isIndexable(x) ? x[lastIndex(x)] : undefined)