Valence.Span (valence v1.0.0)

Copy Markdown View Source

Mapa de posições do AST: para cada nó, um intervalo [início, fim) em {linha, coluna}.

início é o mínimo entre a posição própria do nó e a dos filhos (o parser aponta o |> para o operador, o campo de um acesso para o nome do campo, etc.). fim é o máximo entre o closing/end do próprio nó, o fim dos filhos, e o comprimento do próprio token.

Colunas são contadas em bytes a partir do início da linha: suficiente para código ASCII, que é o escopo do spike.

Summary

Functions

Nó mais interno que contém a posição, ou nil.

Lista de nós em pré-ordem (pai antes dos filhos, ordem de fonte).

Posição própria do nó (a que o parser atribui), se houver.

Como parse!/1, mas devolve {:error, meta, mensagem, token}.

Types

t()

@type t() :: %Valence.Span{
  depth: non_neg_integer(),
  finish: {pos_integer(), pos_integer()},
  node: term(),
  start: {pos_integer(), pos_integer()}
}

Functions

innermost(nodes, pos)

@spec innermost([t()], {pos_integer(), pos_integer()}) :: t() | nil

Nó mais interno que contém a posição, ou nil.

nodes(ast, source)

@spec nodes(term(), String.t()) :: [t()]

Lista de nós em pré-ordem (pai antes dos filhos, ordem de fonte).

own_start(arg1)

@spec own_start(term()) :: {pos_integer(), pos_integer()} | nil

Posição própria do nó (a que o parser atribui), se houver.

parse(source)

@spec parse(String.t()) :: {:ok, term()} | {:error, keyword(), String.t(), term()}

Como parse!/1, mas devolve {:error, meta, mensagem, token}.

parse!(source)

@spec parse!(String.t()) :: term()