19962015 Ericsson AB. All Rights Reserved. The contents of this file are subject to the Erlang Public License, Version 1.1, (the "License"); you may not use this file except in compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. erl_parse Robert Bjarne Däcker 1 Bjarne Däcker 97-01-24 B erl_parse.sgml
erl_parse The Erlang Parser

This module is the basic Erlang parser which converts tokens into the abstract form of either forms (i.e., top-level constructs), expressions, or terms. The Abstract Format is described in the ERTS User's Guide. Note that a token list must end with the dot token in order to be acceptable to the parse functions (see erl_scan(3)).

Parse tree for Erlang clause.

Parse tree for Erlang expression.

Parse tree for Erlang form.

Parse an Erlang form

This function parses Tokens as if it were a form. It returns:

{ok, AbsForm}

The parsing was successful. AbsForm is the abstract form of the parsed form.

{error, ErrorInfo}

An error occurred.

Parse Erlang expressions

This function parses Tokens as if it were a list of expressions. It returns:

{ok, ExprList}

The parsing was successful. ExprList is a list of the abstract forms of the parsed expressions.

{error, ErrorInfo}

An error occurred.

Parse an Erlang term

This function parses Tokens as if it were a term. It returns:

{ok, Term}

The parsing was successful. Term is the Erlang term corresponding to the token list.

{error, ErrorInfo}

An error occurred.

format_error(ErrorDescriptor) -> Chars Format an error descriptor ErrorDescriptor = error_description() Chars = [char() | Chars]

Uses an ErrorDescriptor and returns a string which describes the error. This function is usually called implicitly when an ErrorInfo structure is processed (see below).

Generate a list of tokens for an expression

This function generates a list of tokens representing the abstract form AbsTerm of an expression. Optionally, it appends MoreTokens.

Convert abstract form to an Erlang term

Converts the abstract form AbsTerm of a term into a conventional Erlang data structure (i.e., the term itself). This is the inverse of abstract/1.

Convert an Erlang term into an abstract form

Converts the Erlang data structure Data into an abstract form of type AbsTerm. This is the inverse of normalise/1.

erl_parse:abstract(T) is equivalent to erl_parse:abstract(T, 0).

Convert an Erlang term into an abstract form

Converts the Erlang data structure Data into an abstract form of type AbsTerm.

The Line option is the line that will be assigned to each node of the abstract form.

The Encoding option is used for selecting which integer lists will be considered as strings. The default is to use the encoding returned by epp:default_encoding/0. The value none means that no integer lists will be considered as strings. The encoding_func() will be called with one integer of a list at a time, and if it returns true for every integer the list will be considered a string.

Map a function over the annotations of an abstract form

Modifies the abstract form Abstr by applying Fun on every collection of annotations of the abstract form. The abstract form is traversed in a depth-first, left-to-right, fashion.

Fold a function over the annotations of an abstract form

Updates an accumulator by applying Fun on every collection of annotations of the abstract form Abstr. The first call to Fun has AccIn as argument, and the returned accumulator AccOut is passed to the next call, and so on. The final value of the accumulator is returned. The abstract form is traversed in a depth-first, left-to-right, fashion.

Map and fold a function over the annotations of an abstract form

Modifies the abstract form Abstr by applying Fun on every collection of annotations of the abstract form, while at the same time updating an accumulator. The first call to Fun has AccIn as second argument, and the returned accumulator AccOut is passed to the next call, and so on. The modified abstract form as well as the the final value of the accumulator is returned. The abstract form is traversed in a depth-first, left-to-right, fashion.

Create new annotations

Creates an abstract form from a term which has the same structure as an abstract form, but locations where the abstract form has annotations. For each location, erl_anno:new/1 is called, and the annotations replace the location.

Return annotations as terms

Assumes that Term is a term with the same structure as an abstract form, but with terms, T say, on those places where an abstract form has annotations. Returns an abstract form where every term T has been replaced by the value returned by calling erl_anno:from_term(T). The term Term is traversed in a depth-first, left-to-right, fashion.

Return the representation of annotations

Returns a term where every collection of annotations Anno of Abstr has been replaced by the term returned by calling erl_anno:to_term(Anno). The abstract form is traversed in a depth-first, left-to-right, fashion.

Error Information

The ErrorInfo mentioned above is the standard ErrorInfo structure which is returned from all IO modules. It has the format:

{ErrorLine, Module, ErrorDescriptor}

A string which describes the error is obtained with the following call:

Module:format_error(ErrorDescriptor)
See Also

io(3), erl_anno(3), erl_scan(3), ERTS User's Guide