Urbit Developers
  • Hoon

    • Overview
    • Cheat Sheet
    • Irregular forms
    • Hoon Errors
    • Hoon Style Guide
    • Basic Types
    • Advanced Types
    • Auras
    • Standard Library

      • 1a: Basic Arithmetic
      • 1b: Tree Addressing
      • 1c: Molds and Mold-Builders
      • 2a: Unit Logic
      • 2b: List Logic
      • 2c: Bit Arithmetic
      • 2d: Bit Logic
      • 2e: Insecure Hashing
      • 2f: Noun Ordering
      • 2g: Unsigned Powers
      • 2h: Set Logic
      • 2i: Map Logic
      • 2j: Jar and Jug Logic
      • 2k: Queue Logic
      • 2l: Container from Container
      • 2m: Container from Noun
      • 2n: Functional Hacks
      • 2o: Normalizing Containers
      • 2p: Serialization
      • 2q: Molds and Mold-Builders
      • 3a: Modular and Signed Ints
      • 3b: Floating Point
      • 3c: Urbit Time
      • 3d: SHA Hash Family
      • 3e: AES encryption (Removed)
      • 3f: Scrambling
      • 3g: Molds and Mold-Builders
      • 4a: Exotic Bases
      • 4b: Text Processing
      • 4c: Tank Printer
      • 4d: Parsing (Tracing)
      • 4e: Parsing (Combinators)
      • 4f: Parsing (Rule-Builders)
      • 4g: Parsing (Outside Caller)
      • 4h: Parsing (ASCII Glyphs)
      • 4i: Parsing (Useful Idioms)
      • 4j: Parsing (Bases and Base Digits)
      • 4k: Atom Printing
      • 4l: Atom Parsing
      • 4m: Formatting Functions
      • 4n: Virtualization
      • 4o: Molds
      • 5a: Compiler Utilities
      • 5b: Macro Expansion
      • 5c: Compiler Backend & Prettyprinter
      • 5d: Parser
      • 5e: Molds and mold builders
      • 5f: Profiling support
      • Runes

        • Atoms and strings
        • Nock . ('dot')
        • Wild ! ('zap')
        • Change Subject = ('tis')
        • Conditionals ? ('wut')
        • Cores | ('bar')
        • Arms + ('lus')
        • Cells : ('col')
        • Calls % ('cen')
        • Casts ^ ('ket')
        • Structures $ ('buc')
        • Make ; ('mic')
        • Hints ~ ('sig')
        • Imports / ('fas')
        • Terminators -- and ==
        • Limbs and wings

          • Limbs
          • Wings
          • Zuse

            • Table of Contents
            • 2d(1-5): To JSON, Wains
            • 2d(6): From JSON
            • 2d(7): From JSON (unit)
            • 2e(2-3): Print & Parse JSON
          • Arvo

            • Overview
            • Ames

              • Overview
              • Cryptography
              • API Reference
              • Scry Reference
              • Data Types
              • Behn

                • Overview
                • API Reference
                • Scry Reference
                • Examples
                • Clay

                  • Overview
                  • Architecture
                  • Using Clay
                  • Data Types
                  • Scry Reference
                  • API Reference
                  • Examples
                  • Marks

                    • Overview
                    • Writing Marks
                    • Using Marks
                    • Examples
                  • Dill

                    • Overview
                    • API Reference
                    • Scry Reference
                    • Data Types
                    • Eyre

                      • Overview
                      • External API Reference
                      • Internal API Reference
                      • Scry Reference
                      • Data Types
                      • Guide
                      • Gall

                        • Overview
                        • API Reference
                        • Data Types
                        • Threads Reference
                        • Iris

                          • Overview
                          • API Reference
                          • Data Types
                          • Example
                          • Jael

                            • Overview
                            • API Reference
                            • Scry Reference
                            • Data Types
                            • Examples
                            • Threads

                              • Overview
                              • HTTP API
                              • Reference
                              • Gall

                                • Start Thread
                                • Take Result
                                • Take Facts
                                • Stop Thread
                                • Poke Thread
                                • Examples

                                  • Fetch JSON
                                  • Child Thread
                                  • Main-loop
                                  • Poke Agent
                                  • Scry
                                  • Take Fact
                                • Concepts

                                  • Scries
                                  • Subscriptions
                                  • Tutorials

                                    • Move Trace
                                    • Reference

                                      • Cryptography
                                      • Filesystem Hierarchy
                                    • Nock

                                      • Nock Definition
                                      • Explanation
                                      • Example
                                      • Implementations
                                      • Vere

                                        • C Runtime System
                                        • Land of Nouns
                                        • API overview by prefix
                                        • C in Urbit
                                        • Writing Jets
                                        • Cryptography
                                        • Azimuth

                                          • Overview
                                          • Urbit HD Wallet
                                          • Azimuth Data Flow
                                          • Azimuth.eth
                                          • Ecliptic.eth
                                          • Advanced Azimuth Tools
                                          • Life and Rift
                                          • Layer 2

                                            • Layer 2 Overview
                                            • Layer 2 Actions
                                            • Transaction Format
                                            • Rollers
                                            • Roller HTTP RPC-API
                                            • Custom Roller Tutorial
                                          • Glossary

                                            • Ames
                                            • Aqua
                                            • Arm
                                            • Arvo
                                            • Atom
                                            • Azimuth
                                            • Battery
                                            • Behn
                                            • Bridge
                                            • Censures
                                            • chat
                                            • Claims
                                            • Clay
                                            • Comet
                                            • Core
                                            • Delegated Sending
                                            • Desk
                                            • Dill
                                            • Document Proposal
                                            • Dojo
                                            • Door
                                            • Ecliptic
                                            • Event Log
                                            • Eyre
                                            • Galaxy
                                            • Gall
                                            • Gate
                                            • HD Wallet
                                            • Hoon
                                            • Invite Tree
                                            • Iris
                                            • Jael
                                            • Keyfile
                                            • Khan
                                            • Landscape
                                            • Mark
                                            • Moon
                                            • Nock
                                            • Noun
                                            • OTA Updates
                                            • Payload
                                            • pH
                                            • Pier
                                            • Pill
                                            • Planet
                                            • Proxies
                                            • Replay
                                            • Factory Reset
                                            • Naive rollups
                                            • Sail/Udon
                                            • Senate
                                            • Ship
                                            • ship.arvo.network
                                            • Star
                                            • |sync
                                            • Trap
                                            • Upgrade Proposal
                                            • Vane
                                            • Vere
                                            • Voting
                                            • Wallet-Generator
                                            • Additional

                                              • Cryptography
                                              • Software Distribution

                                                • Overview
                                                • Docket File
                                                • Glob
                                              Urbit Developers
                                              • Hoon

                                                • Overview
                                                • Cheat Sheet
                                                • Irregular forms
                                                • Hoon Errors
                                                • Hoon Style Guide
                                                • Basic Types
                                                • Advanced Types
                                                • Auras
                                                • Standard Library

                                                  • 1a: Basic Arithmetic
                                                  • 1b: Tree Addressing
                                                  • 1c: Molds and Mold-Builders
                                                  • 2a: Unit Logic
                                                  • 2b: List Logic
                                                  • 2c: Bit Arithmetic
                                                  • 2d: Bit Logic
                                                  • 2e: Insecure Hashing
                                                  • 2f: Noun Ordering
                                                  • 2g: Unsigned Powers
                                                  • 2h: Set Logic
                                                  • 2i: Map Logic
                                                  • 2j: Jar and Jug Logic
                                                  • 2k: Queue Logic
                                                  • 2l: Container from Container
                                                  • 2m: Container from Noun
                                                  • 2n: Functional Hacks
                                                  • 2o: Normalizing Containers
                                                  • 2p: Serialization
                                                  • 2q: Molds and Mold-Builders
                                                  • 3a: Modular and Signed Ints
                                                  • 3b: Floating Point
                                                  • 3c: Urbit Time
                                                  • 3d: SHA Hash Family
                                                  • 3e: AES encryption (Removed)
                                                  • 3f: Scrambling
                                                  • 3g: Molds and Mold-Builders
                                                  • 4a: Exotic Bases
                                                  • 4b: Text Processing
                                                  • 4c: Tank Printer
                                                  • 4d: Parsing (Tracing)
                                                  • 4e: Parsing (Combinators)
                                                  • 4f: Parsing (Rule-Builders)
                                                  • 4g: Parsing (Outside Caller)
                                                  • 4h: Parsing (ASCII Glyphs)
                                                  • 4i: Parsing (Useful Idioms)
                                                  • 4j: Parsing (Bases and Base Digits)
                                                  • 4k: Atom Printing
                                                  • 4l: Atom Parsing
                                                  • 4m: Formatting Functions
                                                  • 4n: Virtualization
                                                  • 4o: Molds
                                                  • 5a: Compiler Utilities
                                                  • 5b: Macro Expansion
                                                  • 5c: Compiler Backend & Prettyprinter
                                                  • 5d: Parser
                                                  • 5e: Molds and mold builders
                                                  • 5f: Profiling support
                                                  • Runes

                                                    • Atoms and strings
                                                    • Nock . ('dot')
                                                    • Wild ! ('zap')
                                                    • Change Subject = ('tis')
                                                    • Conditionals ? ('wut')
                                                    • Cores | ('bar')
                                                    • Arms + ('lus')
                                                    • Cells : ('col')
                                                    • Calls % ('cen')
                                                    • Casts ^ ('ket')
                                                    • Structures $ ('buc')
                                                    • Make ; ('mic')
                                                    • Hints ~ ('sig')
                                                    • Imports / ('fas')
                                                    • Terminators -- and ==
                                                    • Limbs and wings

                                                      • Limbs
                                                      • Wings
                                                      • Zuse

                                                        • Table of Contents
                                                        • 2d(1-5): To JSON, Wains
                                                        • 2d(6): From JSON
                                                        • 2d(7): From JSON (unit)
                                                        • 2e(2-3): Print & Parse JSON
                                                      • Arvo

                                                        • Overview
                                                        • Ames

                                                          • Overview
                                                          • Cryptography
                                                          • API Reference
                                                          • Scry Reference
                                                          • Data Types
                                                          • Behn

                                                            • Overview
                                                            • API Reference
                                                            • Scry Reference
                                                            • Examples
                                                            • Clay

                                                              • Overview
                                                              • Architecture
                                                              • Using Clay
                                                              • Data Types
                                                              • Scry Reference
                                                              • API Reference
                                                              • Examples
                                                              • Marks

                                                                • Overview
                                                                • Writing Marks
                                                                • Using Marks
                                                                • Examples
                                                              • Dill

                                                                • Overview
                                                                • API Reference
                                                                • Scry Reference
                                                                • Data Types
                                                                • Eyre

                                                                  • Overview
                                                                  • External API Reference
                                                                  • Internal API Reference
                                                                  • Scry Reference
                                                                  • Data Types
                                                                  • Guide
                                                                  • Gall

                                                                    • Overview
                                                                    • API Reference
                                                                    • Data Types
                                                                    • Threads Reference
                                                                    • Iris

                                                                      • Overview
                                                                      • API Reference
                                                                      • Data Types
                                                                      • Example
                                                                      • Jael

                                                                        • Overview
                                                                        • API Reference
                                                                        • Scry Reference
                                                                        • Data Types
                                                                        • Examples
                                                                        • Threads

                                                                          • Overview
                                                                          • HTTP API
                                                                          • Reference
                                                                          • Gall

                                                                            • Start Thread
                                                                            • Take Result
                                                                            • Take Facts
                                                                            • Stop Thread
                                                                            • Poke Thread
                                                                            • Examples

                                                                              • Fetch JSON
                                                                              • Child Thread
                                                                              • Main-loop
                                                                              • Poke Agent
                                                                              • Scry
                                                                              • Take Fact
                                                                            • Concepts

                                                                              • Scries
                                                                              • Subscriptions
                                                                              • Tutorials

                                                                                • Move Trace
                                                                                • Reference

                                                                                  • Cryptography
                                                                                  • Filesystem Hierarchy
                                                                                • Nock

                                                                                  • Nock Definition
                                                                                  • Explanation
                                                                                  • Example
                                                                                  • Implementations
                                                                                  • Vere

                                                                                    • C Runtime System
                                                                                    • Land of Nouns
                                                                                    • API overview by prefix
                                                                                    • C in Urbit
                                                                                    • Writing Jets
                                                                                    • Cryptography
                                                                                    • Azimuth

                                                                                      • Overview
                                                                                      • Urbit HD Wallet
                                                                                      • Azimuth Data Flow
                                                                                      • Azimuth.eth
                                                                                      • Ecliptic.eth
                                                                                      • Advanced Azimuth Tools
                                                                                      • Life and Rift
                                                                                      • Layer 2

                                                                                        • Layer 2 Overview
                                                                                        • Layer 2 Actions
                                                                                        • Transaction Format
                                                                                        • Rollers
                                                                                        • Roller HTTP RPC-API
                                                                                        • Custom Roller Tutorial
                                                                                      • Glossary

                                                                                        • Ames
                                                                                        • Aqua
                                                                                        • Arm
                                                                                        • Arvo
                                                                                        • Atom
                                                                                        • Azimuth
                                                                                        • Battery
                                                                                        • Behn
                                                                                        • Bridge
                                                                                        • Censures
                                                                                        • chat
                                                                                        • Claims
                                                                                        • Clay
                                                                                        • Comet
                                                                                        • Core
                                                                                        • Delegated Sending
                                                                                        • Desk
                                                                                        • Dill
                                                                                        • Document Proposal
                                                                                        • Dojo
                                                                                        • Door
                                                                                        • Ecliptic
                                                                                        • Event Log
                                                                                        • Eyre
                                                                                        • Galaxy
                                                                                        • Gall
                                                                                        • Gate
                                                                                        • HD Wallet
                                                                                        • Hoon
                                                                                        • Invite Tree
                                                                                        • Iris
                                                                                        • Jael
                                                                                        • Keyfile
                                                                                        • Khan
                                                                                        • Landscape
                                                                                        • Mark
                                                                                        • Moon
                                                                                        • Nock
                                                                                        • Noun
                                                                                        • OTA Updates
                                                                                        • Payload
                                                                                        • pH
                                                                                        • Pier
                                                                                        • Pill
                                                                                        • Planet
                                                                                        • Proxies
                                                                                        • Replay
                                                                                        • Factory Reset
                                                                                        • Naive rollups
                                                                                        • Sail/Udon
                                                                                        • Senate
                                                                                        • Ship
                                                                                        • ship.arvo.network
                                                                                        • Star
                                                                                        • |sync
                                                                                        • Trap
                                                                                        • Upgrade Proposal
                                                                                        • Vane
                                                                                        • Vere
                                                                                        • Voting
                                                                                        • Wallet-Generator
                                                                                        • Additional

                                                                                          • Cryptography
                                                                                          • Software Distribution

                                                                                            • Overview
                                                                                            • Docket File
                                                                                            • Glob
                                                                                          Reference/Hoon/Standard Library

                                                                                          4h: Parsing (ASCII Glyphs)

                                                                                          ++ace

                                                                                          Parse space

                                                                                          Parses ASCII character 32, space.

                                                                                          Source

                                                                                          ++ ace (just ' ')

                                                                                          Examples

                                                                                          > (scan " " ace)
                                                                                          ' '

                                                                                          ++bar

                                                                                          Parse vertical bar

                                                                                          Parses ASCII character 124, the vertical bar.

                                                                                          Source

                                                                                          ++ bar (just '|')

                                                                                          Examples

                                                                                          > (scan "|" bar)
                                                                                          '|'

                                                                                          ++bas

                                                                                          Parse backslash

                                                                                          Parses ASCII character 92, the backslash. Note the extra \ in the calling of bas with just is to escape the escape character, \.

                                                                                          Source

                                                                                          ++ bas (just '\\')

                                                                                          Examples

                                                                                          > (scan "\\" bas)
                                                                                          '\\'

                                                                                          ++buc

                                                                                          Parse dollar sign

                                                                                          Parses ASCII character 36, the dollar sign.

                                                                                          Source

                                                                                          ++ buc (just '$')

                                                                                          Examples

                                                                                          > (scan "$" buc)
                                                                                          '$'

                                                                                          ++cab

                                                                                          Parse underscore

                                                                                          Parses ASCII character 95, the underscore.

                                                                                          Source

                                                                                          ++ cab (just '_')

                                                                                          Examples

                                                                                          > (scan "_" cab)
                                                                                          '_'

                                                                                          ++cen

                                                                                          Parses percent sign

                                                                                          Parses ASCII character 37, the percent sign.

                                                                                          Source

                                                                                          ++ cen (just '%')

                                                                                          Examples

                                                                                          > (scan "%" cen)
                                                                                          '%'

                                                                                          ++col

                                                                                          Parse colon

                                                                                          Parses ASCII character 58, the colon

                                                                                          Source

                                                                                          ++ col (just ':')

                                                                                          Examples

                                                                                          > (scan ":" col)
                                                                                          ':'

                                                                                          ++com

                                                                                          Parse comma

                                                                                          Parses ASCII character 44, the comma.

                                                                                          Source

                                                                                          ++ com (just ',')

                                                                                          Examples

                                                                                          > (scan "," com)
                                                                                          ','

                                                                                          ++doq

                                                                                          Parse double quote

                                                                                          Parses ASCII character 34, the double quote.

                                                                                          Source

                                                                                          ++ doq (just '"')

                                                                                          Examples

                                                                                          > (scan "\"" doq)
                                                                                          '"'

                                                                                          ++dot

                                                                                          Parse period

                                                                                          Parses ASCII character 46, the period.

                                                                                          Source

                                                                                          ++ dot (just '.')

                                                                                          Examples

                                                                                          > (scan "." dot)
                                                                                          '.'

                                                                                          ++fas

                                                                                          Parse forward slash

                                                                                          Parses ASCII character 47, the forward slash.

                                                                                          Source

                                                                                          ++ fas (just '/')

                                                                                          Examples

                                                                                          > (scan "/" fas)
                                                                                          '/'

                                                                                          ++gal

                                                                                          Parse less-than sign

                                                                                          Parses ASCII character 60, the less-than sign.

                                                                                          Source

                                                                                          ++ gal (just '<')

                                                                                          Examples

                                                                                          > (scan "<" gal)
                                                                                          '<'

                                                                                          ++gar

                                                                                          Parse greater-than sign

                                                                                          Parses ASCII character 62, the greater-than sign.

                                                                                          Source

                                                                                          ++ gar (just '>')

                                                                                          Examples

                                                                                          > (scan ">" gar)
                                                                                          '>'

                                                                                          ++hax

                                                                                          Parse number sign

                                                                                          Parses ASCII character 35, the number sign.

                                                                                          Source

                                                                                          ++ hax (just '#')

                                                                                          Examples

                                                                                          > (scan "#" hax)
                                                                                          '#'

                                                                                          ++hep

                                                                                          Parse hyphen

                                                                                          Parses ASCII character 45, the hyphen.

                                                                                          Source

                                                                                          ++ hep (just '-')

                                                                                          Examples

                                                                                          > (scan "-" hep)
                                                                                          '-'

                                                                                          ++kel

                                                                                          Parse left curley bracket

                                                                                          Parses ASCII character 123, the left curly bracket. Note that { (kel) opens a Hoon expression for Hoon string interpolation. To parse it, therefore, it must be escaped.

                                                                                          Source

                                                                                          ++ kel (just '{')

                                                                                          Examples

                                                                                          > (scan "\{" kel)
                                                                                          '{'

                                                                                          ++ker

                                                                                          Parse right curley bracket

                                                                                          Parses ASCII character 125, the right curly bracket.

                                                                                          Source

                                                                                          ++ ker (just '}')

                                                                                          Examples

                                                                                          > (scan "}" ker)
                                                                                          '}'

                                                                                          ++ket

                                                                                          Parse caret

                                                                                          Parses ASCII character 94, the caret.

                                                                                          Source

                                                                                          ++ ket (just '^')

                                                                                          Examples

                                                                                          > (scan "^" ket)
                                                                                          '^'

                                                                                          ++lus

                                                                                          Parse plus sign

                                                                                          Parses ASCII character 43, the plus sign.

                                                                                          Source

                                                                                          ++ lus (just '+')

                                                                                          Examples

                                                                                          > (scan "+" lus)
                                                                                          '+'

                                                                                          ++mic

                                                                                          Parse semicolon

                                                                                          Parses ASCII character 59, the semicolon.

                                                                                          Source

                                                                                          ++ mic (just ';')

                                                                                          Examples

                                                                                          > (scan ";" mic)
                                                                                          ';'

                                                                                          ++pal

                                                                                          Parse left parenthesis

                                                                                          Parses ASCII character 40, the left parenthesis.

                                                                                          Source

                                                                                          ++ pal (just '(')

                                                                                          Examples

                                                                                          > (scan "(" pal)
                                                                                          '('

                                                                                          ++pam

                                                                                          Parse ampersand

                                                                                          Parses ASCII character 38, the ampersand.

                                                                                          Source

                                                                                          ++ pam (just '&')

                                                                                          Examples

                                                                                          > (scan "&" pam)
                                                                                          '&'

                                                                                          ++par

                                                                                          Parse right parenthesis

                                                                                          Parses ASCII character 41, the right parenthesis.

                                                                                          Source

                                                                                          ++ par (just ')')

                                                                                          Examples

                                                                                          > (scan ")" par)
                                                                                          ')'

                                                                                          ++pat

                                                                                          Parse "at" sign

                                                                                          Parses ASCII character 64, the "at" sign.

                                                                                          Source

                                                                                          ++ pat (just '@')

                                                                                          Examples

                                                                                          > (scan "@" pat)
                                                                                          '@'

                                                                                          ++sel

                                                                                          Parse left square bracket

                                                                                          Parses ASCII character 91, the left square bracket.

                                                                                          Source

                                                                                          ++ sel (just '[')

                                                                                          Examples

                                                                                          > (scan "[" sel)
                                                                                          '['

                                                                                          ++ser

                                                                                          Parse right square bracket

                                                                                          Parses ASCII character 93, the right square bracket.

                                                                                          Source

                                                                                          ++ ser (just ']')

                                                                                          Examples

                                                                                          > (scan "]" ser)
                                                                                          ']'

                                                                                          ++sig

                                                                                          Parse tilde

                                                                                          Parses ASCII character 126, the tilde.

                                                                                          Source

                                                                                          ++ sig (just '~')

                                                                                          Examples

                                                                                          > (scan "~" sig)
                                                                                          '~'

                                                                                          ++soq

                                                                                          Parse single quote

                                                                                          Parses ASCII character 39, soq. Note the \ in the example is to escape the soq because soq delimits a cord.

                                                                                          Source

                                                                                          ++ soq (just '\'')

                                                                                          Examples

                                                                                          > (scan "'" soq)
                                                                                          '\''

                                                                                          ++tar

                                                                                          Parse asterisk

                                                                                          Parses ASCII character 42, the asterisk.

                                                                                          Source

                                                                                          ++ tar (just '*')

                                                                                          Examples

                                                                                          > (scan "*" tar)
                                                                                          '*'

                                                                                          ++tic

                                                                                          Parse backtick

                                                                                          Parses ASCII character 96, the backtick.

                                                                                          Source

                                                                                          ++ tic (just '`')

                                                                                          Examples

                                                                                          > (scan "`" tic)
                                                                                          '`'

                                                                                          ++tis

                                                                                          Parse equals sign

                                                                                          Parses ASCII character 61, the equals sign.

                                                                                          Source

                                                                                          ++ tis (just '=')

                                                                                          Examples

                                                                                          > (scan "=" tis)
                                                                                          '='

                                                                                          ++wut

                                                                                          Parses question mark

                                                                                          Parses ASCII character 63, the question mark.

                                                                                          Source

                                                                                          ++ wut (just '?')

                                                                                          Examples

                                                                                          > (scan "?" wut)
                                                                                          '?'

                                                                                          ++zap

                                                                                          Exclamation point

                                                                                          Parses ASCII character 33, the exclamation point zap.

                                                                                          Source

                                                                                          ++ zap (just '!')

                                                                                          Examples

                                                                                          > (scan "!" zap)
                                                                                          '!'

                                                                                          <-

                                                                                          4g: Parsing (Outside Caller)

                                                                                          4i: Parsing (Useful Idioms)

                                                                                          ->

                                                                                          Edit this page on GitHub