Проектирование именования API

API разработан для простого использования и согласованности. Простота использования измеряется количеством вызовов для достижения конкретного действия высокого уровня.

Схема именования

Библиотека использует простую схему именования, которая использует стандартные аббревиатуры для сохранения краткости и осмысленности имён. С версии 0.8.2 многие символы были переименованы в соответствии с этой схемой. Конечная цель состоит в том, чтобы программист мог предположить имя.

Английское слово	Использовать	Примечания
initialize	initT	`init` используется для создания типа значения `T`
new	newP	`new` используется для создания ссылочного типа `P`
find	find	должно возвращать позицию, где что-то было найдено; для булева результата используйте `contains`
contains	contains	часто сокращение от `find() >= 0`
append	add	используйте `add` вместо `append`
compare	cmp	должно возвращать целое число со `< 0` `== 0` или `> 0` семантикой; для булева результата используйте `sameXYZ`
put	put, `[]=`	рассмотрите перегрузку `[]=` для put
get	get, `[]`	рассмотрите перегрузку `[]` для get; рассмотрите возможность не использовать `get` в качестве префикса: `len` вместо `getLen`
length	len	также используется для количества элементов
size	size, len	size должно относиться к размеру в байтах
capacity	cap
memory	mem	подразумевает операцию низкого уровня
items	items	по умолчанию итератор по коллекции
pairs	pairs	итератор по парам (ключ, значение)
delete	delete, del	del предположительно быстрее, чем delete, потому что не сохраняет порядок; delete сохраняет порядок
remove	delete, del	несогласованно в данный момент
remove-and-return	pop	`Table`/`TableRef` псевдоним для `take`
include	incl
exclude	excl
command	cmd
execute	exec
environment	env
variable	var
value	value, val	val предпочтительнее, несогласованно в данный момент
executable	exe
directory	dir
path	path	path — это строка "/usr/bin" (например), dir — это содержимое "/usr/bin"; несогласованно в данный момент
extension	ext
separator	sep
column	col, column	col предпочтительнее, несогласованно в данный момент
application	app
configuration	cfg
message	msg
argument	arg
object	obj
parameter	param
operator	opr
procedure	proc
function	func
coordinate	coord
rectangle	rect
point	point
symbol	sym
literal	lit
string	str
identifier	ident
indentation	indent