Return to patterns.2 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / icon / man / man2

Annotation of 43BSD/contrib/icon/man/man2/patterns.2, revision 1.1

1.1     ! root        1: .so tmac.ilib
        !             2: .TH PATTERNS 2 "The University of Arizona \- 7/29/84"
        !             3: .SH NAME
        !             4: patterns \- SNOBOL4-style pattern matching
        !             5: .SH DESCRIPTION
        !             6: These procedures are adapted from TR 80-25 and TR 81-6. They
        !             7: provide procedural equivalents for most SNOBOL4 patterns and
        !             8: some extensions.
        !             9: .SH SYNOPSIS
        !            10: .nf
        !            11: .sp 1
        !            12: .ta 1.5i
        !            13: \*MAnchor()    &ANCHOR = 1 \fR if \*MMode := Anchor
        !            14: Any(s) ANY(S)
        !            15: Apply(s,\*bp)  S ? P
        !            16: Arb()  ARB
        !            17: Arbno(p)       ARBNO(P)
        !            18: Arbx(i)        ARB(I)
        !            19: Bal()  BAL
        !            20: Break(s)       BREAK(S)
        !            21: Breakx(s)      BREAKX(S)
        !            22: Cat(p1,\*bp2)  P1 P2
        !            23: Discard(p)     /P
        !            24: Exog(s)        \eS
        !            25: Find(s)        FIND(S)
        !            26: Float()        &ANCHOR = 0 \fR if \*MMode := Float
        !            27: Len(i) LEN(I)
        !            28: Limit(p,\*bi)  P \e i
        !            29: Locate(p)      LOCATE(P)
        !            30: Marb() \fRlongest-first\*M ARB
        !            31: Mode() \fRAnchored or unanchored matching (see \*MAnchor\fR and \*MFloat\fR)\*M
        !            32: Notany(s)      NOTANY(S)
        !            33: Pos(i) POS(I)
        !            34: Replace(p,\*bs)        P \(== S
        !            35: Rpos(i)        RPOS(I)
        !            36: Rtab(i)        RTAB(I)
        !            37: Span(s)        SPAN(S)
        !            38: String(s)      S
        !            39: Succeed()      SUCCEED
        !            40: Tab(i) TAB(I)
        !            41: Xform(f,\*bp)  F(P)
        !            42: .ft R
        !            43: .fi
        !            44: .LP
        !            45: In addition to the procedures above, the following expressions can be
        !            46: used:
        !            47: .nf
        !            48: .sp 1
        !            49: \*Mp1() | p2() P1 | P2
        !            50: v <\- p()      P . V \fR(approximate)\*M
        !            51: v := p()       P $ V \fR(approximate)\*M
        !            52: fail   FAIL
        !            53: =s             S\fR (in place of \*MString(s)\fR)\*M
        !            54: p1() || p2()   P1 P2 \fR(in place of \*MCat(p1,\*bp2)\fR)\*M
        !            55: .ft R
        !            56: .sp 1
        !            57: .fi
        !            58: .LP
        !            59: Using this system, most SNOBOL4 patterns can be satisfactorily transliterated
        !            60: into Icon procedures and expressions. For example, the pattern
        !            61: .DS
        !            62: SPAN("0123456789") $ N "H" LEN(*N) $ LITERAL
        !            63: .DE
        !            64: can be transliterated into
        !            65: .DS
        !            66: (n <\- Span('0123456789')) || ="H" || (literal <\- Len(n))
        !            67: .DE
        !            68: Concatenation of components is necessary to preserve the pattern-matching properties
        !            69: of SNOBOL4.
        !            70: See the documents listed below for details and limitations.
        !            71: .SH CAVEATS
        !            72: Simulating SNOBOL4 pattern matching using the procedures above
        !            73: is inefficient.
        !            74: .SH SEE ALSO
        !            75: Ralph E. Griswold. \fIPattern Matching in Icon\fR,
        !            76: TR 80-25, The University of Arizona, 1980.
        !            77: .LP
        !            78: Ralph E. Griswold. \fIModels of String Pattern Matching\fR,
        !            79: TR 81-6,
        !            80: Department of Computer Science, The University of Arizona, 1981.
        !            81: .LP
        !            82: Ralph E. Griswold. ``Implementing SNOBOL4 Pattern Matching in Icon'',
        !            83: \fIComputer Languages\fR, Vol. 8, No. 8 (1983), pp. 77-92.
        !            84: .SH AUTHOR
        !            85: Ralph E. Griswold

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.