WOLFRAM

Wolfram Language & System Documentation Center

CodeParse["code"]

parses a string of WL code returning an abstract syntax tree.

CodeParse[File[src]]

parses a file of WL code returning an abstract syntax tree.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Options  
SourceConvention  
Properties & Relations  
Possible Issues  
Related Guides
CodeParser`
CodeParser`

CodeParse

CodeParse["code"]

parses a string of WL code returning an abstract syntax tree.

CodeParse[File[src]]

parses a file of WL code returning an abstract syntax tree.

Details and Options

  • The following options can be given to CodeParse:
  • SourceConvention "LineColumn"convention to use for Source metadata

Examples

open all close all

Basic Examples  (1)

Load the package:

Wolfram Language code: Needs["CodeParser`"]

Parse a string of Wolfram Language code into an abstract syntax tree:

Wolfram Language code: CodeParse["1+1"]

Options  (1)

SourceConvention  (1)

Wolfram Language code: Needs["CodeParser`"]

Using "LineColumn" convention:

Wolfram Language code: CodeParse["f[x]", SourceConvention -> "LineColumn"]

Using "SourceCharacterIndex" convention:

Wolfram Language code: CodeParse["f[x]", SourceConvention -> "SourceCharacterIndex"]

Properties & Relations  (1)

The following three code strings parse in a similar manner:

Wolfram Language code: e1 = CodeParse["f[x]"]
Wolfram Language code: e2 = CodeParse["f@x"]
Wolfram Language code: e3 = CodeParse["x//f"]

The location of the tokens in the source are different for each source, so they are not identical:

Wolfram Language code: e1 === e2 === e3

Possible Issues  (1)

Wolfram Language code: Needs["CodeParser`"]

A string representing a file path is treated as code.

Wolfram Language code: CodeParse["ExampleData/Collatz.m"]

File paths must use the File wrapper.

Wolfram Language code: CodeParse[File["ExampleData/Collatz.m"]]