.forbids pragma: defining forbidden tags (#20050)
* .forbids pragma: defining illegal effects for proc types This patch intends to define the opposite of the .tags pragma: a way to define effects which are not allowed in a proc. * updated documentation and changelogs for the forbids pragma * renamed notTagEffects to forbiddenEffects * corrected issues of forbids pragma the forbids pragma didn't handle simple restrictions properly and it also had issues with subtyping * removed incorrect character from changelog * added test to cover the interaction of methods and the forbids pragma * covering the interaction of the tags and forbids pragmas * updated manual about the forbids pragma * removed useless statement * corrected the subtyping of proc types using the forbids pragma * updated manual for the forbids pragma * updated documentations for forbids pragma * updated nim docs * updated docs with rsttester.nim * regenerated documentation * updated rst docs * Update changelog.md Co-authored-by: ringabout <43030857+ringabout@users.noreply.github.com> * updated changelog * corrected typo Co-authored-by: ringabout <43030857+ringabout@users.noreply.github.com>
This commit is contained in:
Lancer11211
GitHub
parent
62b81d7f10
commit
efd5c571bf
24 changed files with 405 additions and 71 deletions
|
|
@ -67,6 +67,8 @@ becomes an alias for `addr`.
|
||||||
|
|
||||||
## Language changes
|
## Language changes
|
||||||
|
|
||||||
|
- [Tag tracking](manual.html#tag-tracking) supports the definition of forbidden tags by the `.forbids` pragma
|
||||||
|
which can be used to disable certain effects in proc types.
|
||||||
- [Case statement macros](manual.html#macros-case-statement-macros) are no longer experimental,
|
- [Case statement macros](manual.html#macros-case-statement-macros) are no longer experimental,
|
||||||
meaning you no longer need to enable the experimental switch `caseStmtMacros` to use them.
|
meaning you no longer need to enable the experimental switch `caseStmtMacros` to use them.
|
||||||
- Templates now accept [macro pragmas](https://nim-lang.github.io/Nim/manual.html#userminusdefined-pragmas-macro-pragmas).
|
- Templates now accept [macro pragmas](https://nim-lang.github.io/Nim/manual.html#userminusdefined-pragmas-macro-pragmas).
|
||||||
|
|
|
||||||
|
|
@ -347,7 +347,8 @@ const
|
||||||
ensuresEffects* = 2 # 'ensures' annotation
|
ensuresEffects* = 2 # 'ensures' annotation
|
||||||
tagEffects* = 3 # user defined tag ('gc', 'time' etc.)
|
tagEffects* = 3 # user defined tag ('gc', 'time' etc.)
|
||||||
pragmasEffects* = 4 # not an effect, but a slot for pragmas in proc type
|
pragmasEffects* = 4 # not an effect, but a slot for pragmas in proc type
|
||||||
effectListLen* = 5 # list of effects list
|
forbiddenEffects* = 5 # list of illegal effects
|
||||||
|
effectListLen* = 6 # list of effects list
|
||||||
nkLastBlockStmts* = {nkRaiseStmt, nkReturnStmt, nkBreakStmt, nkContinueStmt}
|
nkLastBlockStmts* = {nkRaiseStmt, nkReturnStmt, nkBreakStmt, nkContinueStmt}
|
||||||
# these must be last statements in a block
|
# these must be last statements in a block
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1212,8 +1212,9 @@ proc documentRaises*(cache: IdentCache; n: PNode) =
|
||||||
let p3 = documentWriteEffect(cache, n, sfWrittenTo, "writes")
|
let p3 = documentWriteEffect(cache, n, sfWrittenTo, "writes")
|
||||||
let p4 = documentNewEffect(cache, n)
|
let p4 = documentNewEffect(cache, n)
|
||||||
let p5 = documentWriteEffect(cache, n, sfEscapes, "escapes")
|
let p5 = documentWriteEffect(cache, n, sfEscapes, "escapes")
|
||||||
|
let p6 = documentEffect(cache, n, pragmas, wForbids, forbiddenEffects)
|
||||||
|
|
||||||
if p1 != nil or p2 != nil or p3 != nil or p4 != nil or p5 != nil:
|
if p1 != nil or p2 != nil or p3 != nil or p4 != nil or p5 != nil or p6 != nil:
|
||||||
if pragmas.kind == nkEmpty:
|
if pragmas.kind == nkEmpty:
|
||||||
n[pragmasPos] = newNodeI(nkPragma, n.info)
|
n[pragmasPos] = newNodeI(nkPragma, n.info)
|
||||||
if p1 != nil: n[pragmasPos].add p1
|
if p1 != nil: n[pragmasPos].add p1
|
||||||
|
|
@ -1221,6 +1222,7 @@ proc documentRaises*(cache: IdentCache; n: PNode) =
|
||||||
if p3 != nil: n[pragmasPos].add p3
|
if p3 != nil: n[pragmasPos].add p3
|
||||||
if p4 != nil: n[pragmasPos].add p4
|
if p4 != nil: n[pragmasPos].add p4
|
||||||
if p5 != nil: n[pragmasPos].add p5
|
if p5 != nil: n[pragmasPos].add p5
|
||||||
|
if p6 != nil: n[pragmasPos].add p6
|
||||||
|
|
||||||
proc generateDoc*(d: PDoc, n, orig: PNode, docFlags: DocFlags = kDefault) =
|
proc generateDoc*(d: PDoc, n, orig: PNode, docFlags: DocFlags = kDefault) =
|
||||||
## Goes through nim nodes recursively and collects doc comments.
|
## Goes through nim nodes recursively and collects doc comments.
|
||||||
|
|
|
||||||
|
|
@ -32,7 +32,7 @@ const
|
||||||
wCompilerProc, wNonReloadable, wCore, wProcVar, wVarargs, wCompileTime, wMerge,
|
wCompilerProc, wNonReloadable, wCore, wProcVar, wVarargs, wCompileTime, wMerge,
|
||||||
wBorrow, wImportCompilerProc, wThread,
|
wBorrow, wImportCompilerProc, wThread,
|
||||||
wAsmNoStackFrame, wDiscardable, wNoInit, wCodegenDecl,
|
wAsmNoStackFrame, wDiscardable, wNoInit, wCodegenDecl,
|
||||||
wGensym, wInject, wRaises, wEffectsOf, wTags, wLocks, wDelegator, wGcSafe,
|
wGensym, wInject, wRaises, wEffectsOf, wTags, wForbids, wLocks, wDelegator, wGcSafe,
|
||||||
wConstructor, wLiftLocals, wStackTrace, wLineTrace, wNoDestroy,
|
wConstructor, wLiftLocals, wStackTrace, wLineTrace, wNoDestroy,
|
||||||
wRequires, wEnsures, wEnforceNoRaises}
|
wRequires, wEnsures, wEnforceNoRaises}
|
||||||
converterPragmas* = procPragmas
|
converterPragmas* = procPragmas
|
||||||
|
|
@ -45,7 +45,7 @@ const
|
||||||
iteratorPragmas* = declPragmas + {FirstCallConv..LastCallConv, wNoSideEffect, wSideEffect,
|
iteratorPragmas* = declPragmas + {FirstCallConv..LastCallConv, wNoSideEffect, wSideEffect,
|
||||||
wMagic, wBorrow,
|
wMagic, wBorrow,
|
||||||
wDiscardable, wGensym, wInject, wRaises, wEffectsOf,
|
wDiscardable, wGensym, wInject, wRaises, wEffectsOf,
|
||||||
wTags, wLocks, wGcSafe, wRequires, wEnsures}
|
wTags, wForbids, wLocks, wGcSafe, wRequires, wEnsures}
|
||||||
exprPragmas* = {wLine, wLocks, wNoRewrite, wGcSafe, wNoSideEffect}
|
exprPragmas* = {wLine, wLocks, wNoRewrite, wGcSafe, wNoSideEffect}
|
||||||
stmtPragmas* = {
|
stmtPragmas* = {
|
||||||
wHint, wWarning, wError,
|
wHint, wWarning, wError,
|
||||||
|
|
@ -65,7 +65,7 @@ const
|
||||||
lambdaPragmas* = {FirstCallConv..LastCallConv,
|
lambdaPragmas* = {FirstCallConv..LastCallConv,
|
||||||
wNoSideEffect, wSideEffect, wNoreturn, wNosinks, wDynlib, wHeader,
|
wNoSideEffect, wSideEffect, wNoreturn, wNosinks, wDynlib, wHeader,
|
||||||
wThread, wAsmNoStackFrame,
|
wThread, wAsmNoStackFrame,
|
||||||
wRaises, wLocks, wTags, wRequires, wEnsures, wEffectsOf,
|
wRaises, wLocks, wTags, wForbids, wRequires, wEnsures, wEffectsOf,
|
||||||
wGcSafe, wCodegenDecl, wNoInit, wCompileTime}
|
wGcSafe, wCodegenDecl, wNoInit, wCompileTime}
|
||||||
typePragmas* = declPragmas + {wMagic, wAcyclic,
|
typePragmas* = declPragmas + {wMagic, wAcyclic,
|
||||||
wPure, wHeader, wCompilerProc, wCore, wFinal, wSize, wShallow,
|
wPure, wHeader, wCompilerProc, wCore, wFinal, wSize, wShallow,
|
||||||
|
|
@ -85,7 +85,7 @@ const
|
||||||
paramPragmas* = {wNoalias, wInject, wGensym}
|
paramPragmas* = {wNoalias, wInject, wGensym}
|
||||||
letPragmas* = varPragmas
|
letPragmas* = varPragmas
|
||||||
procTypePragmas* = {FirstCallConv..LastCallConv, wVarargs, wNoSideEffect,
|
procTypePragmas* = {FirstCallConv..LastCallConv, wVarargs, wNoSideEffect,
|
||||||
wThread, wRaises, wEffectsOf, wLocks, wTags, wGcSafe,
|
wThread, wRaises, wEffectsOf, wLocks, wTags, wForbids, wGcSafe,
|
||||||
wRequires, wEnsures}
|
wRequires, wEnsures}
|
||||||
forVarPragmas* = {wInject, wGensym}
|
forVarPragmas* = {wInject, wGensym}
|
||||||
allRoutinePragmas* = methodPragmas + iteratorPragmas + lambdaPragmas
|
allRoutinePragmas* = methodPragmas + iteratorPragmas + lambdaPragmas
|
||||||
|
|
@ -820,7 +820,7 @@ proc singlePragma(c: PContext, sym: PSym, n: PNode, i: var int,
|
||||||
elif not isStatement:
|
elif not isStatement:
|
||||||
localError(c.config, n.info, "'cast' pragma only allowed in a statement context")
|
localError(c.config, n.info, "'cast' pragma only allowed in a statement context")
|
||||||
case whichPragma(key[1])
|
case whichPragma(key[1])
|
||||||
of wRaises, wTags: pragmaRaisesOrTags(c, key[1])
|
of wRaises, wTags, wForbids: pragmaRaisesOrTags(c, key[1])
|
||||||
else: discard
|
else: discard
|
||||||
return
|
return
|
||||||
elif key.kind notin nkIdentKinds:
|
elif key.kind notin nkIdentKinds:
|
||||||
|
|
@ -1184,7 +1184,7 @@ proc singlePragma(c: PContext, sym: PSym, n: PNode, i: var int,
|
||||||
noVal(c, it)
|
noVal(c, it)
|
||||||
if sym == nil: invalidPragma(c, it)
|
if sym == nil: invalidPragma(c, it)
|
||||||
of wLine: pragmaLine(c, it)
|
of wLine: pragmaLine(c, it)
|
||||||
of wRaises, wTags: pragmaRaisesOrTags(c, it)
|
of wRaises, wTags, wForbids: pragmaRaisesOrTags(c, it)
|
||||||
of wLocks:
|
of wLocks:
|
||||||
if sym == nil: pragmaLockStmt(c, it)
|
if sym == nil: pragmaLockStmt(c, it)
|
||||||
elif sym.typ == nil: invalidPragma(c, it)
|
elif sym.typ == nil: invalidPragma(c, it)
|
||||||
|
|
|
||||||
|
|
@ -154,6 +154,8 @@ proc effectProblem(f, a: PType; result: var string; c: PContext) =
|
||||||
"proc with {.locks: 0.} to get extended error information."
|
"proc with {.locks: 0.} to get extended error information."
|
||||||
of efEffectsDelayed:
|
of efEffectsDelayed:
|
||||||
result.add "\n The `.effectsOf` annotations differ."
|
result.add "\n The `.effectsOf` annotations differ."
|
||||||
|
of efTagsIllegal:
|
||||||
|
result.add "\n The `.forbids` requirements caught an illegal tag."
|
||||||
when defined(drnim):
|
when defined(drnim):
|
||||||
if not c.graph.compatibleProps(c.graph, f, a):
|
if not c.graph.compatibleProps(c.graph, f, a):
|
||||||
result.add "\n The `.requires` or `.ensures` properties are incompatible."
|
result.add "\n The `.requires` or `.ensures` properties are incompatible."
|
||||||
|
|
@ -730,4 +732,4 @@ proc searchForBorrowProc(c: PContext, startScope: PScope, fn: PSym): PSym =
|
||||||
result = nil
|
result = nil
|
||||||
elif result.magic in {mArrPut, mArrGet}:
|
elif result.magic in {mArrPut, mArrGet}:
|
||||||
# cannot borrow these magics for now
|
# cannot borrow these magics for now
|
||||||
result = nil
|
result = nil
|
||||||
|
|
|
||||||
|
|
@ -66,6 +66,7 @@ type
|
||||||
TEffects = object
|
TEffects = object
|
||||||
exc: PNode # stack of exceptions
|
exc: PNode # stack of exceptions
|
||||||
tags: PNode # list of tags
|
tags: PNode # list of tags
|
||||||
|
forbids: PNode # list of tags
|
||||||
bottom, inTryStmt, inExceptOrFinallyStmt, leftPartOfAsgn: int
|
bottom, inTryStmt, inExceptOrFinallyStmt, leftPartOfAsgn: int
|
||||||
owner: PSym
|
owner: PSym
|
||||||
ownerModule: PSym
|
ownerModule: PSym
|
||||||
|
|
@ -388,6 +389,12 @@ proc addTag(a: PEffects, e, comesFrom: PNode) =
|
||||||
if sameType(aa[i].typ.skipTypes(skipPtrs), e.typ.skipTypes(skipPtrs)): return
|
if sameType(aa[i].typ.skipTypes(skipPtrs), e.typ.skipTypes(skipPtrs)): return
|
||||||
throws(a.tags, e, comesFrom)
|
throws(a.tags, e, comesFrom)
|
||||||
|
|
||||||
|
proc addNotTag(a: PEffects, e, comesFrom: PNode) =
|
||||||
|
var aa = a.forbids
|
||||||
|
for i in 0..<aa.len:
|
||||||
|
if sameType(aa[i].typ.skipTypes(skipPtrs), e.typ.skipTypes(skipPtrs)): return
|
||||||
|
throws(a.forbids, e, comesFrom)
|
||||||
|
|
||||||
proc mergeRaises(a: PEffects, b, comesFrom: PNode) =
|
proc mergeRaises(a: PEffects, b, comesFrom: PNode) =
|
||||||
if b.isNil:
|
if b.isNil:
|
||||||
addRaiseEffect(a, createRaise(a.graph, comesFrom), comesFrom)
|
addRaiseEffect(a, createRaise(a.graph, comesFrom), comesFrom)
|
||||||
|
|
@ -403,6 +410,7 @@ proc mergeTags(a: PEffects, b, comesFrom: PNode) =
|
||||||
proc listEffects(a: PEffects) =
|
proc listEffects(a: PEffects) =
|
||||||
for e in items(a.exc): message(a.config, e.info, hintUser, typeToString(e.typ))
|
for e in items(a.exc): message(a.config, e.info, hintUser, typeToString(e.typ))
|
||||||
for e in items(a.tags): message(a.config, e.info, hintUser, typeToString(e.typ))
|
for e in items(a.tags): message(a.config, e.info, hintUser, typeToString(e.typ))
|
||||||
|
for e in items(a.forbids): message(a.config, e.info, hintUser, typeToString(e.typ))
|
||||||
#if a.maxLockLevel != 0:
|
#if a.maxLockLevel != 0:
|
||||||
# message(e.info, hintUser, "lockLevel: " & a.maxLockLevel)
|
# message(e.info, hintUser, "lockLevel: " & a.maxLockLevel)
|
||||||
|
|
||||||
|
|
@ -604,7 +612,7 @@ proc isOwnedProcVar(tracked: PEffects; n: PNode): bool =
|
||||||
|
|
||||||
proc isNoEffectList(n: PNode): bool {.inline.} =
|
proc isNoEffectList(n: PNode): bool {.inline.} =
|
||||||
assert n.kind == nkEffectList
|
assert n.kind == nkEffectList
|
||||||
n.len == 0 or (n[tagEffects] == nil and n[exceptionEffects] == nil)
|
n.len == 0 or (n[tagEffects] == nil and n[exceptionEffects] == nil and n[forbiddenEffects] == nil)
|
||||||
|
|
||||||
proc isTrival(caller: PNode): bool {.inline.} =
|
proc isTrival(caller: PNode): bool {.inline.} =
|
||||||
result = caller.kind == nkSym and caller.sym.magic in {mEqProc, mIsNil, mMove, mWasMoved, mSwap}
|
result = caller.kind == nkSym and caller.sym.magic in {mEqProc, mIsNil, mMove, mWasMoved, mSwap}
|
||||||
|
|
@ -924,14 +932,17 @@ type
|
||||||
oldLocked: int
|
oldLocked: int
|
||||||
oldLockLevel: TLockLevel
|
oldLockLevel: TLockLevel
|
||||||
enforcedGcSafety, enforceNoSideEffects: bool
|
enforcedGcSafety, enforceNoSideEffects: bool
|
||||||
oldExc, oldTags: int
|
oldExc, oldTags, oldForbids: int
|
||||||
exc, tags: PNode
|
exc, tags, forbids: PNode
|
||||||
|
|
||||||
proc createBlockContext(tracked: PEffects): PragmaBlockContext =
|
proc createBlockContext(tracked: PEffects): PragmaBlockContext =
|
||||||
|
var oldForbidsLen = 0
|
||||||
|
if tracked.forbids != nil: oldForbidsLen = tracked.forbids.len
|
||||||
result = PragmaBlockContext(oldLocked: tracked.locked.len,
|
result = PragmaBlockContext(oldLocked: tracked.locked.len,
|
||||||
oldLockLevel: tracked.currLockLevel,
|
oldLockLevel: tracked.currLockLevel,
|
||||||
enforcedGcSafety: false, enforceNoSideEffects: false,
|
enforcedGcSafety: false, enforceNoSideEffects: false,
|
||||||
oldExc: tracked.exc.len, oldTags: tracked.tags.len)
|
oldExc: tracked.exc.len, oldTags: tracked.tags.len,
|
||||||
|
oldForbids: oldForbidsLen)
|
||||||
|
|
||||||
proc applyBlockContext(tracked: PEffects, bc: PragmaBlockContext) =
|
proc applyBlockContext(tracked: PEffects, bc: PragmaBlockContext) =
|
||||||
if bc.enforcedGcSafety: tracked.inEnforcedGcSafe = true
|
if bc.enforcedGcSafety: tracked.inEnforcedGcSafe = true
|
||||||
|
|
@ -952,6 +963,10 @@ proc unapplyBlockContext(tracked: PEffects; bc: PragmaBlockContext) =
|
||||||
setLen(tracked.tags.sons, bc.oldTags)
|
setLen(tracked.tags.sons, bc.oldTags)
|
||||||
for t in bc.tags:
|
for t in bc.tags:
|
||||||
addTag(tracked, t, t)
|
addTag(tracked, t, t)
|
||||||
|
if bc.forbids != nil:
|
||||||
|
setLen(tracked.forbids.sons, bc.oldForbids)
|
||||||
|
for t in bc.forbids:
|
||||||
|
addNotTag(tracked, t, t)
|
||||||
|
|
||||||
proc castBlock(tracked: PEffects, pragma: PNode, bc: var PragmaBlockContext) =
|
proc castBlock(tracked: PEffects, pragma: PNode, bc: var PragmaBlockContext) =
|
||||||
case whichPragma(pragma)
|
case whichPragma(pragma)
|
||||||
|
|
@ -966,6 +981,13 @@ proc castBlock(tracked: PEffects, pragma: PNode, bc: var PragmaBlockContext) =
|
||||||
else:
|
else:
|
||||||
bc.tags = newNodeI(nkArgList, pragma.info)
|
bc.tags = newNodeI(nkArgList, pragma.info)
|
||||||
bc.tags.add n
|
bc.tags.add n
|
||||||
|
of wForbids:
|
||||||
|
let n = pragma[1]
|
||||||
|
if n.kind in {nkCurly, nkBracket}:
|
||||||
|
bc.forbids = n
|
||||||
|
else:
|
||||||
|
bc.forbids = newNodeI(nkArgList, pragma.info)
|
||||||
|
bc.forbids.add n
|
||||||
of wRaises:
|
of wRaises:
|
||||||
let n = pragma[1]
|
let n = pragma[1]
|
||||||
if n.kind in {nkCurly, nkBracket}:
|
if n.kind in {nkCurly, nkBracket}:
|
||||||
|
|
@ -1274,7 +1296,7 @@ proc subtypeRelation(g: ModuleGraph; spec, real: PNode): bool =
|
||||||
|
|
||||||
proc checkRaisesSpec(g: ModuleGraph; emitWarnings: bool; spec, real: PNode, msg: string, hints: bool;
|
proc checkRaisesSpec(g: ModuleGraph; emitWarnings: bool; spec, real: PNode, msg: string, hints: bool;
|
||||||
effectPredicate: proc (g: ModuleGraph; a, b: PNode): bool {.nimcall.};
|
effectPredicate: proc (g: ModuleGraph; a, b: PNode): bool {.nimcall.};
|
||||||
hintsArg: PNode = nil) =
|
hintsArg: PNode = nil; isForbids: bool = false) =
|
||||||
# check that any real exception is listed in 'spec'; mark those as used;
|
# check that any real exception is listed in 'spec'; mark those as used;
|
||||||
# report any unused exception
|
# report any unused exception
|
||||||
var used = initIntSet()
|
var used = initIntSet()
|
||||||
|
|
@ -1282,8 +1304,11 @@ proc checkRaisesSpec(g: ModuleGraph; emitWarnings: bool; spec, real: PNode, msg:
|
||||||
block search:
|
block search:
|
||||||
for s in 0..<spec.len:
|
for s in 0..<spec.len:
|
||||||
if effectPredicate(g, spec[s], r):
|
if effectPredicate(g, spec[s], r):
|
||||||
|
if isForbids: break
|
||||||
used.incl(s)
|
used.incl(s)
|
||||||
break search
|
break search
|
||||||
|
if isForbids:
|
||||||
|
break search
|
||||||
# XXX call graph analysis would be nice here!
|
# XXX call graph analysis would be nice here!
|
||||||
pushInfoContext(g.config, spec.info)
|
pushInfoContext(g.config, spec.info)
|
||||||
var rr = if r.kind == nkRaiseStmt: r[0] else: r
|
var rr = if r.kind == nkRaiseStmt: r[0] else: r
|
||||||
|
|
@ -1312,6 +1337,10 @@ proc checkMethodEffects*(g: ModuleGraph; disp, branch: PSym) =
|
||||||
if not isNil(tagsSpec):
|
if not isNil(tagsSpec):
|
||||||
checkRaisesSpec(g, false, tagsSpec, actual[tagEffects],
|
checkRaisesSpec(g, false, tagsSpec, actual[tagEffects],
|
||||||
"can have an unlisted effect: ", hints=off, subtypeRelation)
|
"can have an unlisted effect: ", hints=off, subtypeRelation)
|
||||||
|
let forbidsSpec = effectSpec(p, wForbids)
|
||||||
|
if not isNil(forbidsSpec):
|
||||||
|
checkRaisesSpec(g, false, forbidsSpec, actual[tagEffects],
|
||||||
|
"has an illegal effect: ", hints=off, subtypeRelation, isForbids=true)
|
||||||
if sfThread in disp.flags and notGcSafe(branch.typ):
|
if sfThread in disp.flags and notGcSafe(branch.typ):
|
||||||
localError(g.config, branch.info, "base method is GC-safe, but '$1' is not" %
|
localError(g.config, branch.info, "base method is GC-safe, but '$1' is not" %
|
||||||
branch.name.s)
|
branch.name.s)
|
||||||
|
|
@ -1349,6 +1378,12 @@ proc setEffectsForProcType*(g: ModuleGraph; t: PType, n: PNode; s: PSym = nil) =
|
||||||
elif s != nil and (s.magic != mNone or {sfImportc, sfExportc} * s.flags == {sfImportc}):
|
elif s != nil and (s.magic != mNone or {sfImportc, sfExportc} * s.flags == {sfImportc}):
|
||||||
effects[tagEffects] = newNodeI(nkArgList, effects.info)
|
effects[tagEffects] = newNodeI(nkArgList, effects.info)
|
||||||
|
|
||||||
|
let forbidsSpec = effectSpec(n, wForbids)
|
||||||
|
if not isNil(forbidsSpec):
|
||||||
|
effects[forbiddenEffects] = forbidsSpec
|
||||||
|
elif s != nil and (s.magic != mNone or {sfImportc, sfExportc} * s.flags == {sfImportc}):
|
||||||
|
effects[forbiddenEffects] = newNodeI(nkArgList, effects.info)
|
||||||
|
|
||||||
let requiresSpec = propSpec(n, wRequires)
|
let requiresSpec = propSpec(n, wRequires)
|
||||||
if not isNil(requiresSpec):
|
if not isNil(requiresSpec):
|
||||||
effects[requiresEffects] = requiresSpec
|
effects[requiresEffects] = requiresSpec
|
||||||
|
|
@ -1365,6 +1400,7 @@ proc rawInitEffects(g: ModuleGraph; effects: PNode) =
|
||||||
newSeq(effects.sons, effectListLen)
|
newSeq(effects.sons, effectListLen)
|
||||||
effects[exceptionEffects] = newNodeI(nkArgList, effects.info)
|
effects[exceptionEffects] = newNodeI(nkArgList, effects.info)
|
||||||
effects[tagEffects] = newNodeI(nkArgList, effects.info)
|
effects[tagEffects] = newNodeI(nkArgList, effects.info)
|
||||||
|
effects[forbiddenEffects] = newNodeI(nkArgList, effects.info)
|
||||||
effects[requiresEffects] = g.emptyNode
|
effects[requiresEffects] = g.emptyNode
|
||||||
effects[ensuresEffects] = g.emptyNode
|
effects[ensuresEffects] = g.emptyNode
|
||||||
effects[pragmasEffects] = g.emptyNode
|
effects[pragmasEffects] = g.emptyNode
|
||||||
|
|
@ -1374,6 +1410,7 @@ proc initEffects(g: ModuleGraph; effects: PNode; s: PSym; t: var TEffects; c: PC
|
||||||
|
|
||||||
t.exc = effects[exceptionEffects]
|
t.exc = effects[exceptionEffects]
|
||||||
t.tags = effects[tagEffects]
|
t.tags = effects[tagEffects]
|
||||||
|
t.forbids = effects[forbiddenEffects]
|
||||||
t.owner = s
|
t.owner = s
|
||||||
t.ownerModule = s.getModule
|
t.ownerModule = s.getModule
|
||||||
t.init = @[]
|
t.init = @[]
|
||||||
|
|
@ -1448,6 +1485,15 @@ proc trackProc*(c: PContext; s: PSym, body: PNode) =
|
||||||
else:
|
else:
|
||||||
effects[tagEffects] = t.tags
|
effects[tagEffects] = t.tags
|
||||||
|
|
||||||
|
let forbidsSpec = effectSpec(p, wForbids)
|
||||||
|
if not isNil(forbidsSpec):
|
||||||
|
checkRaisesSpec(g, false, forbidsSpec, t.tags, "has an illegal effect: ",
|
||||||
|
hints=off, subtypeRelation, isForbids=true)
|
||||||
|
# after the check, use the formal spec:
|
||||||
|
effects[forbiddenEffects] = forbidsSpec
|
||||||
|
else:
|
||||||
|
effects[forbiddenEffects] = t.forbids
|
||||||
|
|
||||||
let requiresSpec = propSpec(p, wRequires)
|
let requiresSpec = propSpec(p, wRequires)
|
||||||
if not isNil(requiresSpec):
|
if not isNil(requiresSpec):
|
||||||
effects[requiresEffects] = requiresSpec
|
effects[requiresEffects] = requiresSpec
|
||||||
|
|
|
||||||
|
|
@ -2300,7 +2300,7 @@ proc semPragmaBlock(c: PContext, n: PNode): PNode =
|
||||||
for p in pragmaList:
|
for p in pragmaList:
|
||||||
if whichPragma(p) == wCast:
|
if whichPragma(p) == wCast:
|
||||||
case whichPragma(p[1])
|
case whichPragma(p[1])
|
||||||
of wGcSafe, wNoSideEffect, wTags, wRaises:
|
of wGcSafe, wNoSideEffect, wTags, wForbids, wRaises:
|
||||||
discard "handled in sempass2"
|
discard "handled in sempass2"
|
||||||
of wUncheckedAssign:
|
of wUncheckedAssign:
|
||||||
inUncheckedAssignSection = 1
|
inUncheckedAssignSection = 1
|
||||||
|
|
|
||||||
|
|
@ -1372,6 +1372,13 @@ proc compatibleEffectsAux(se, re: PNode): bool =
|
||||||
return false
|
return false
|
||||||
result = true
|
result = true
|
||||||
|
|
||||||
|
proc hasIncompatibleEffect(se, re: PNode): bool =
|
||||||
|
if re.isNil: return false
|
||||||
|
for r in items(re):
|
||||||
|
for s in items(se):
|
||||||
|
if safeInheritanceDiff(r.typ, s.typ) != high(int):
|
||||||
|
return true
|
||||||
|
|
||||||
type
|
type
|
||||||
EffectsCompat* = enum
|
EffectsCompat* = enum
|
||||||
efCompat
|
efCompat
|
||||||
|
|
@ -1381,6 +1388,7 @@ type
|
||||||
efTagsUnknown
|
efTagsUnknown
|
||||||
efLockLevelsDiffer
|
efLockLevelsDiffer
|
||||||
efEffectsDelayed
|
efEffectsDelayed
|
||||||
|
efTagsIllegal
|
||||||
|
|
||||||
proc compatibleEffects*(formal, actual: PType): EffectsCompat =
|
proc compatibleEffects*(formal, actual: PType): EffectsCompat =
|
||||||
# for proc type compatibility checking:
|
# for proc type compatibility checking:
|
||||||
|
|
@ -1414,6 +1422,14 @@ proc compatibleEffects*(formal, actual: PType): EffectsCompat =
|
||||||
if not res:
|
if not res:
|
||||||
#if tfEffectSystemWorkaround notin actual.flags:
|
#if tfEffectSystemWorkaround notin actual.flags:
|
||||||
return efTagsDiffer
|
return efTagsDiffer
|
||||||
|
|
||||||
|
let sn = spec[forbiddenEffects]
|
||||||
|
if not isNil(sn) and sn.kind != nkArgList:
|
||||||
|
if 0 == real.len:
|
||||||
|
return efTagsUnknown
|
||||||
|
elif hasIncompatibleEffect(sn, real[tagEffects]):
|
||||||
|
return efTagsIllegal
|
||||||
|
|
||||||
if formal.lockLevel.ord < 0 or
|
if formal.lockLevel.ord < 0 or
|
||||||
actual.lockLevel.ord <= formal.lockLevel.ord:
|
actual.lockLevel.ord <= formal.lockLevel.ord:
|
||||||
|
|
||||||
|
|
@ -1627,6 +1643,8 @@ proc typeMismatch*(conf: ConfigRef; info: TLineInfo, formal, actual: PType, n: P
|
||||||
msg.add "\nlock levels differ"
|
msg.add "\nlock levels differ"
|
||||||
of efEffectsDelayed:
|
of efEffectsDelayed:
|
||||||
msg.add "\n.effectsOf annotations differ"
|
msg.add "\n.effectsOf annotations differ"
|
||||||
|
of efTagsIllegal:
|
||||||
|
msg.add "\n.notTag catched an illegal effect"
|
||||||
localError(conf, info, msg)
|
localError(conf, info, msg)
|
||||||
|
|
||||||
proc isTupleRecursive(t: PType, cycleDetector: var IntSet): bool =
|
proc isTupleRecursive(t: PType, cycleDetector: var IntSet): bool =
|
||||||
|
|
|
||||||
|
|
@ -324,6 +324,8 @@ proc registerAdditionalOps*(c: PCtx) =
|
||||||
getEffectList(c, a, exceptionEffects)
|
getEffectList(c, a, exceptionEffects)
|
||||||
registerCallback c, "stdlib.effecttraits.getTagsListImpl", proc (a: VmArgs) =
|
registerCallback c, "stdlib.effecttraits.getTagsListImpl", proc (a: VmArgs) =
|
||||||
getEffectList(c, a, tagEffects)
|
getEffectList(c, a, tagEffects)
|
||||||
|
registerCallback c, "stdlib.effecttraits.getForbidsListImpl", proc (a: VmArgs) =
|
||||||
|
getEffectList(c, a, forbiddenEffects)
|
||||||
|
|
||||||
registerCallback c, "stdlib.effecttraits.isGcSafeImpl", proc (a: VmArgs) =
|
registerCallback c, "stdlib.effecttraits.isGcSafeImpl", proc (a: VmArgs) =
|
||||||
let fn = getNode(a, 0)
|
let fn = getNode(a, 0)
|
||||||
|
|
|
||||||
|
|
@ -71,7 +71,7 @@ type
|
||||||
wSinkInference = "sinkInference", wWarnings = "warnings",
|
wSinkInference = "sinkInference", wWarnings = "warnings",
|
||||||
wHints = "hints", wOptimization = "optimization", wRaises = "raises",
|
wHints = "hints", wOptimization = "optimization", wRaises = "raises",
|
||||||
wWrites = "writes", wReads = "reads", wSize = "size", wEffects = "effects", wTags = "tags",
|
wWrites = "writes", wReads = "reads", wSize = "size", wEffects = "effects", wTags = "tags",
|
||||||
wRequires = "requires", wEnsures = "ensures", wInvariant = "invariant",
|
wForbids = "forbids", wRequires = "requires", wEnsures = "ensures", wInvariant = "invariant",
|
||||||
wAssume = "assume", wAssert = "assert",
|
wAssume = "assume", wAssert = "assert",
|
||||||
wDeadCodeElimUnused = "deadCodeElim", # deprecated, dead code elim always happens
|
wDeadCodeElimUnused = "deadCodeElim", # deprecated, dead code elim always happens
|
||||||
wSafecode = "safecode", wPackage = "package", wNoForward = "noforward", wReorder = "reorder",
|
wSafecode = "safecode", wPackage = "package", wNoForward = "noforward", wReorder = "reorder",
|
||||||
|
|
@ -145,4 +145,4 @@ else:
|
||||||
for i in a..b:
|
for i in a..b:
|
||||||
if cmpIgnoreStyle($i, s) == 0:
|
if cmpIgnoreStyle($i, s) == 0:
|
||||||
return i
|
return i
|
||||||
result = default
|
result = default
|
||||||
|
|
|
||||||
|
|
@ -5069,7 +5069,7 @@ means to *tag* a routine and to perform checks against this tag:
|
||||||
type IO = object ## input/output effect
|
type IO = object ## input/output effect
|
||||||
proc readLine(): string {.tags: [IO].} = discard
|
proc readLine(): string {.tags: [IO].} = discard
|
||||||
|
|
||||||
proc no_IO_please() {.tags: [].} =
|
proc no_effects_please() {.tags: [].} =
|
||||||
# the compiler prevents this:
|
# the compiler prevents this:
|
||||||
let x = readLine()
|
let x = readLine()
|
||||||
```
|
```
|
||||||
|
|
@ -5080,6 +5080,51 @@ also be attached to a proc type. This affects type compatibility.
|
||||||
The inference for tag tracking is analogous to the inference for
|
The inference for tag tracking is analogous to the inference for
|
||||||
exception tracking.
|
exception tracking.
|
||||||
|
|
||||||
|
There is also a way which can be used to forbid certain effects:
|
||||||
|
|
||||||
|
.. code-block:: nim
|
||||||
|
:test: "nim c --warningAsError:Effect:on $1"
|
||||||
|
:status: 1
|
||||||
|
|
||||||
|
type IO = object ## input/output effect
|
||||||
|
proc readLine(): string {.tags: [IO].} = discard
|
||||||
|
proc echoLine(): void = discard
|
||||||
|
|
||||||
|
proc no_IO_please() {.forbids: [IO].} =
|
||||||
|
# this is OK because it didn't define any tag:
|
||||||
|
echoLine()
|
||||||
|
# the compiler prevents this:
|
||||||
|
let y = readLine()
|
||||||
|
|
||||||
|
The `forbids` pragma defines a list of illegal effects - if any statement
|
||||||
|
invokes any of those effects, the compilation will fail.
|
||||||
|
Procedure types with any disallowed effect are the subtypes of equal
|
||||||
|
procedure types without such lists:
|
||||||
|
|
||||||
|
.. code-block:: nim
|
||||||
|
type MyEffect = object
|
||||||
|
type ProcType1 = proc (i: int): void {.forbids: [MyEffect].}
|
||||||
|
type ProcType2 = proc (i: int): void
|
||||||
|
|
||||||
|
proc caller1(p: ProcType1): void = p(1)
|
||||||
|
proc caller2(p: ProcType2): void = p(1)
|
||||||
|
|
||||||
|
proc effectful(i: int): void {.tags: [MyEffect].} = echo $i
|
||||||
|
proc effectless(i: int): void {.forbids: [MyEffect].} = echo $i
|
||||||
|
|
||||||
|
proc toBeCalled1(i: int): void = effectful(i)
|
||||||
|
proc toBeCalled2(i: int): void = effectless(i)
|
||||||
|
|
||||||
|
## this will fail because toBeCalled1 uses MyEffect which was forbidden by ProcType1:
|
||||||
|
caller1(toBeCalled1)
|
||||||
|
## this is OK because both toBeCalled1 and ProcType1 have the same requirements:
|
||||||
|
caller1(toBeCalled2)
|
||||||
|
## these are OK because ProcType2 doesn't have any effect requirement:
|
||||||
|
caller2(toBeCalled1)
|
||||||
|
caller2(toBeCalled2)
|
||||||
|
|
||||||
|
`ProcType2` is a subtype of `ProcType1`. Unlike with tags, the parent context - the function which calls other functions with forbidden effects - doesn't inherit the forbidden list of effects.
|
||||||
|
|
||||||
|
|
||||||
Side effects
|
Side effects
|
||||||
------------
|
------------
|
||||||
|
|
|
||||||
|
|
@ -18,6 +18,7 @@ import macros
|
||||||
|
|
||||||
proc getRaisesListImpl(n: NimNode): NimNode = discard "see compiler/vmops.nim"
|
proc getRaisesListImpl(n: NimNode): NimNode = discard "see compiler/vmops.nim"
|
||||||
proc getTagsListImpl(n: NimNode): NimNode = discard "see compiler/vmops.nim"
|
proc getTagsListImpl(n: NimNode): NimNode = discard "see compiler/vmops.nim"
|
||||||
|
proc getForbidsListImpl(n: NimNode): NimNode = discard "see compiler/vmops.nim"
|
||||||
proc isGcSafeImpl(n: NimNode): bool = discard "see compiler/vmops.nim"
|
proc isGcSafeImpl(n: NimNode): bool = discard "see compiler/vmops.nim"
|
||||||
proc hasNoSideEffectsImpl(n: NimNode): bool = discard "see compiler/vmops.nim"
|
proc hasNoSideEffectsImpl(n: NimNode): bool = discard "see compiler/vmops.nim"
|
||||||
|
|
||||||
|
|
@ -37,6 +38,14 @@ proc getTagsList*(fn: NimNode): NimNode =
|
||||||
expectKind fn, nnkSym
|
expectKind fn, nnkSym
|
||||||
result = getTagsListImpl(fn)
|
result = getTagsListImpl(fn)
|
||||||
|
|
||||||
|
proc getForbidsList*(fn: NimNode): NimNode =
|
||||||
|
## Extracts the `.forbids` list of the func/proc/etc `fn`.
|
||||||
|
## `fn` has to be a resolved symbol of kind `nnkSym`. This
|
||||||
|
## implies that the macro that calls this proc should accept `typed`
|
||||||
|
## arguments and not `untyped` arguments.
|
||||||
|
expectKind fn, nnkSym
|
||||||
|
result = getForbidsListImpl(fn)
|
||||||
|
|
||||||
proc isGcSafe*(fn: NimNode): bool =
|
proc isGcSafe*(fn: NimNode): bool =
|
||||||
## Return true if the func/proc/etc `fn` is `gcsafe`.
|
## Return true if the func/proc/etc `fn` is `gcsafe`.
|
||||||
## `fn` has to be a resolved symbol of kind `nnkSym`. This
|
## `fn` has to be a resolved symbol of kind `nnkSym`. This
|
||||||
|
|
|
||||||
|
|
@ -76,7 +76,7 @@
|
||||||
<dl class="item">
|
<dl class="item">
|
||||||
<div id="foo-procs-all">
|
<div id="foo-procs-all">
|
||||||
<div id="foo">
|
<div id="foo">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#foo"><span class="Identifier">foo</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#foo"><span class="Identifier">foo</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
I do foo
|
I do foo
|
||||||
|
|
|
||||||
|
|
@ -278,7 +278,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="'big-procs-all">
|
<div id="'big-procs-all">
|
||||||
<div id="'big,string">
|
<div id="'big,string">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#%27big%2Cstring"><span class="Identifier">`'big`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#%27big%2Cstring"><span class="Identifier">`'big`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -323,7 +323,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="f-procs-all">
|
<div id="f-procs-all">
|
||||||
<div id="f,G[int]">
|
<div id="f,G[int]">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#f%2CG%5Bint%5D"><span class="Identifier">f</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="utils.html#G"><span class="Identifier">G</span></a><span class="Other">[</span><span class="Identifier">int</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#f%2CG%5Bint%5D"><span class="Identifier">f</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="utils.html#G"><span class="Identifier">G</span></a><span class="Other">[</span><span class="Identifier">int</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
There is also variant <a class="reference internal nimdoc" title="proc f(x: G[string])" href="#f,G[string]">f(G[string])</a>
|
There is also variant <a class="reference internal nimdoc" title="proc f(x: G[string])" href="#f,G[string]">f(G[string])</a>
|
||||||
|
|
@ -331,7 +331,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</dd>
|
</dd>
|
||||||
</div>
|
</div>
|
||||||
<div id="f,G[string]">
|
<div id="f,G[string]">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#f%2CG%5Bstring%5D"><span class="Identifier">f</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="utils.html#G"><span class="Identifier">G</span></a><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#f%2CG%5Bstring%5D"><span class="Identifier">f</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="utils.html#G"><span class="Identifier">G</span></a><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
See also <a class="reference internal nimdoc" title="proc f(x: G[int])" href="#f,G[int]">f(G[int])</a>.
|
See also <a class="reference internal nimdoc" title="proc f(x: G[int])" href="#f,G[int]">f(G[int])</a>.
|
||||||
|
|
@ -353,7 +353,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn2-procs-all">
|
<div id="fn2-procs-all">
|
||||||
<div id="fn2">
|
<div id="fn2">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn2"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn2"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -361,7 +361,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</dd>
|
</dd>
|
||||||
</div>
|
</div>
|
||||||
<div id="fn2,int">
|
<div id="fn2,int">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn2%2Cint"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn2%2Cint"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
fn2 comment
|
fn2 comment
|
||||||
|
|
@ -369,7 +369,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</dd>
|
</dd>
|
||||||
</div>
|
</div>
|
||||||
<div id="fn2,int,float">
|
<div id="fn2,int,float">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn2%2Cint%2Cfloat"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span> <span class="Identifier">y</span><span class="Other">:</span> <span class="Identifier">float</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn2%2Cint%2Cfloat"><span class="Identifier">fn2</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span> <span class="Identifier">y</span><span class="Other">:</span> <span class="Identifier">float</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -380,7 +380,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn3-procs-all">
|
<div id="fn3-procs-all">
|
||||||
<div id="fn3">
|
<div id="fn3">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn3"><span class="Identifier">fn3</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn3"><span class="Identifier">fn3</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -391,7 +391,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn4-procs-all">
|
<div id="fn4-procs-all">
|
||||||
<div id="fn4">
|
<div id="fn4">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn4"><span class="Identifier">fn4</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn4"><span class="Identifier">fn4</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -402,7 +402,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn5-procs-all">
|
<div id="fn5-procs-all">
|
||||||
<div id="fn5">
|
<div id="fn5">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn5"><span class="Identifier">fn5</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn5"><span class="Identifier">fn5</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -413,7 +413,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn6-procs-all">
|
<div id="fn6-procs-all">
|
||||||
<div id="fn6">
|
<div id="fn6">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn6"><span class="Identifier">fn6</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn6"><span class="Identifier">fn6</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -424,7 +424,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn7-procs-all">
|
<div id="fn7-procs-all">
|
||||||
<div id="fn7">
|
<div id="fn7">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn7"><span class="Identifier">fn7</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn7"><span class="Identifier">fn7</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -435,7 +435,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn8-procs-all">
|
<div id="fn8-procs-all">
|
||||||
<div id="fn8">
|
<div id="fn8">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fn8"><span class="Identifier">fn8</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fn8"><span class="Identifier">fn8</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">auto</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -446,7 +446,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn9-procs-all">
|
<div id="fn9-procs-all">
|
||||||
<div id="fn9,int">
|
<div id="fn9,int">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#fn9%2Cint"><span class="Identifier">fn9</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#fn9%2Cint"><span class="Identifier">fn9</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -457,7 +457,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fn10-procs-all">
|
<div id="fn10-procs-all">
|
||||||
<div id="fn10,int">
|
<div id="fn10,int">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#fn10%2Cint"><span class="Identifier">fn10</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#fn10%2Cint"><span class="Identifier">fn10</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
comment
|
comment
|
||||||
|
|
@ -468,7 +468,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="fN11-procs-all">
|
<div id="fN11-procs-all">
|
||||||
<div id="fN11">
|
<div id="fN11">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#fN11"><span class="Identifier">fN11</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#fN11"><span class="Identifier">fN11</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -476,7 +476,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</dd>
|
</dd>
|
||||||
</div>
|
</div>
|
||||||
<div id="fN11,int">
|
<div id="fN11,int">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#fN11%2Cint"><span class="Identifier">fN11</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#fN11%2Cint"><span class="Identifier">fN11</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -498,7 +498,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
</div>
|
</div>
|
||||||
<div id="someType-procs-all">
|
<div id="someType-procs-all">
|
||||||
<div id="someType_2">
|
<div id="someType_2">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#someType_2"><span class="Identifier">someType</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#someType_2"><span class="Identifier">someType</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
constructor.
|
constructor.
|
||||||
|
|
@ -515,7 +515,7 @@ Ref. <a class="reference internal nimdoc" title="proc `[]`[T](x: G[T]): T" href=
|
||||||
<dl class="item">
|
<dl class="item">
|
||||||
<div id="fooBar-iterators-all">
|
<div id="fooBar-iterators-all">
|
||||||
<div id="fooBar.i,seq[SomeType]">
|
<div id="fooBar.i,seq[SomeType]">
|
||||||
<dt><pre><span class="Keyword">iterator</span> <a href="#fooBar.i%2Cseq%5BSomeType%5D"><span class="Identifier">fooBar</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">iterator</span> <a href="#fooBar.i%2Cseq%5BSomeType%5D"><span class="Identifier">fooBar</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="utils.html#SomeType"><span class="Identifier">SomeType</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -471,7 +471,7 @@
|
||||||
<dl class="item">
|
<dl class="item">
|
||||||
<div id="addfBug14485-procs-all">
|
<div id="addfBug14485-procs-all">
|
||||||
<div id="addfBug14485">
|
<div id="addfBug14485">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#addfBug14485"><span class="Identifier">addfBug14485</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#addfBug14485"><span class="Identifier">addfBug14485</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
Some proc
|
Some proc
|
||||||
|
|
@ -494,7 +494,7 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="anything-procs-all">
|
<div id="anything-procs-all">
|
||||||
<div id="anything">
|
<div id="anything">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#anything"><span class="Identifier">anything</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#anything"><span class="Identifier">anything</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
There is no block quote after blank lines at the beginning.
|
There is no block quote after blank lines at the beginning.
|
||||||
|
|
@ -506,7 +506,7 @@
|
||||||
<div id="asyncFun1-procs-all">
|
<div id="asyncFun1-procs-all">
|
||||||
<div id="asyncFun1">
|
<div id="asyncFun1">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun1"><span class="Identifier">asyncFun1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">int</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span>
|
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun1"><span class="Identifier">asyncFun1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">int</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span>
|
||||||
<span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span></span>.}</pre></dt>
|
<span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
ok1
|
ok1
|
||||||
|
|
@ -517,7 +517,8 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="asyncFun2-procs-all">
|
<div id="asyncFun2-procs-all">
|
||||||
<div id="asyncFun2">
|
<div id="asyncFun2">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun2"><span class="Identifier">asyncFun2</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun2"><span class="Identifier">asyncFun2</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span>
|
||||||
|
</span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -528,7 +529,8 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="asyncFun3-procs-all">
|
<div id="asyncFun3-procs-all">
|
||||||
<div id="asyncFun3">
|
<div id="asyncFun3">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun3"><span class="Identifier">asyncFun3</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#asyncFun3"><span class="Identifier">asyncFun3</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span>
|
||||||
|
</span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -552,7 +554,7 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="baz-procs-all">
|
<div id="baz-procs-all">
|
||||||
<div id="baz">
|
<div id="baz">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#baz"><span class="Identifier">baz</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#baz"><span class="Identifier">baz</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -589,7 +591,7 @@
|
||||||
<div id="c_nonexistent-procs-all">
|
<div id="c_nonexistent-procs-all">
|
||||||
<div id="c_nonexistent,cstring">
|
<div id="c_nonexistent,cstring">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#c_nonexistent%2Ccstring"><span class="Identifier">c_nonexistent</span></a><span class="Other">(</span><span class="Identifier">frmt</span><span class="Other">:</span> <span class="Identifier">cstring</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">cint</span> {.<span class="Identifier">importc</span><span class="Other">:</span> <span class="StringLit">"nonexistent"</span><span class="Other">,</span>
|
<dt><pre><span class="Keyword">proc</span> <a href="#c_nonexistent%2Ccstring"><span class="Identifier">c_nonexistent</span></a><span class="Other">(</span><span class="Identifier">frmt</span><span class="Other">:</span> <span class="Identifier">cstring</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">cint</span> {.<span class="Identifier">importc</span><span class="Other">:</span> <span class="StringLit">"nonexistent"</span><span class="Other">,</span>
|
||||||
<span class="Identifier">header</span><span class="Other">:</span> <span class="StringLit">"<stdio.h>"</span><span class="Other">,</span> <span class="Identifier">varargs</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<span class="Identifier">header</span><span class="Other">:</span> <span class="StringLit">"<stdio.h>"</span><span class="Other">,</span> <span class="Identifier">varargs</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -601,7 +603,8 @@
|
||||||
<div id="c_printf-procs-all">
|
<div id="c_printf-procs-all">
|
||||||
<div id="c_printf,cstring">
|
<div id="c_printf,cstring">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#c_printf%2Ccstring"><span class="Identifier">c_printf</span></a><span class="Other">(</span><span class="Identifier">frmt</span><span class="Other">:</span> <span class="Identifier">cstring</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">cint</span> {.<span class="Identifier">importc</span><span class="Other">:</span> <span class="StringLit">"printf"</span><span class="Other">,</span> <span class="Identifier">header</span><span class="Other">:</span> <span class="StringLit">"<stdio.h>"</span><span class="Other">,</span>
|
<dt><pre><span class="Keyword">proc</span> <a href="#c_printf%2Ccstring"><span class="Identifier">c_printf</span></a><span class="Other">(</span><span class="Identifier">frmt</span><span class="Other">:</span> <span class="Identifier">cstring</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">cint</span> {.<span class="Identifier">importc</span><span class="Other">:</span> <span class="StringLit">"printf"</span><span class="Other">,</span> <span class="Identifier">header</span><span class="Other">:</span> <span class="StringLit">"<stdio.h>"</span><span class="Other">,</span>
|
||||||
<span class="Identifier">varargs</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<span class="Identifier">varargs</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
|
||||||
|
</span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
the c printf. etc.
|
the c printf. etc.
|
||||||
|
|
@ -612,7 +615,7 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="fromUtils3-procs-all">
|
<div id="fromUtils3-procs-all">
|
||||||
<div id="fromUtils3">
|
<div id="fromUtils3">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#fromUtils3"><span class="Identifier">fromUtils3</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#fromUtils3"><span class="Identifier">fromUtils3</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
came form utils but should be shown where <tt class="docutils literal"><span class="pre"><span class="Identifier">fromUtilsGen</span></span></tt> is called
|
came form utils but should be shown where <tt class="docutils literal"><span class="pre"><span class="Identifier">fromUtilsGen</span></span></tt> is called
|
||||||
|
|
@ -638,7 +641,7 @@
|
||||||
<div id="low-procs-all">
|
<div id="low-procs-all">
|
||||||
<div id="low,T">
|
<div id="low,T">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#low%2CT"><span class="Identifier">low</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Identifier">Ordinal</span> <span class="Operator">|</span> <span class="Keyword">enum</span> <span class="Operator">|</span> <span class="Identifier">range</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">"Low"</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
|
<dt><pre><span class="Keyword">proc</span> <a href="#low%2CT"><span class="Identifier">low</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Identifier">Ordinal</span> <span class="Operator">|</span> <span class="Keyword">enum</span> <span class="Operator">|</span> <span class="Identifier">range</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">"Low"</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
|
||||||
<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
<p>Returns the lowest possible value of an ordinal value <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt>. As a special semantic rule, <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> may also be a type identifier.</p>
|
<p>Returns the lowest possible value of an ordinal value <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt>. As a special semantic rule, <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> may also be a type identifier.</p>
|
||||||
|
|
@ -654,7 +657,7 @@
|
||||||
<div id="low2-procs-all">
|
<div id="low2-procs-all">
|
||||||
<div id="low2,T">
|
<div id="low2,T">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#low2%2CT"><span class="Identifier">low2</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Identifier">Ordinal</span> <span class="Operator">|</span> <span class="Keyword">enum</span> <span class="Operator">|</span> <span class="Identifier">range</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">"Low"</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
|
<dt><pre><span class="Keyword">proc</span> <a href="#low2%2CT"><span class="Identifier">low2</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Identifier">Ordinal</span> <span class="Operator">|</span> <span class="Keyword">enum</span> <span class="Operator">|</span> <span class="Identifier">range</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">"Low"</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
|
||||||
<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
<p>Returns the lowest possible value of an ordinal value <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt>. As a special semantic rule, <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> may also be a type identifier.</p>
|
<p>Returns the lowest possible value of an ordinal value <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt>. As a special semantic rule, <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> may also be a type identifier.</p>
|
||||||
|
|
@ -671,7 +674,7 @@
|
||||||
</div>
|
</div>
|
||||||
<div id="p1-procs-all">
|
<div id="p1-procs-all">
|
||||||
<div id="p1">
|
<div id="p1">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#p1"><span class="Identifier">p1</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#p1"><span class="Identifier">p1</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cp1
|
cp1
|
||||||
|
|
@ -698,7 +701,7 @@ this is a nested doc comment
|
||||||
</div>
|
</div>
|
||||||
<div id="someFunc-procs-all">
|
<div id="someFunc-procs-all">
|
||||||
<div id="someFunc">
|
<div id="someFunc">
|
||||||
<dt><pre><span class="Keyword">func</span> <a href="#someFunc"><span class="Identifier">someFunc</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">func</span> <a href="#someFunc"><span class="Identifier">someFunc</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
My someFunc. Stuff in <tt class="docutils literal"><span class="pre"><span class="Identifier">quotes</span></span></tt> here. <a class="reference external" href="https://nim-lang.org">Some link</a>
|
My someFunc. Stuff in <tt class="docutils literal"><span class="pre"><span class="Identifier">quotes</span></span></tt> here. <a class="reference external" href="https://nim-lang.org">Some link</a>
|
||||||
|
|
@ -709,7 +712,7 @@ this is a nested doc comment
|
||||||
</div>
|
</div>
|
||||||
<div id="tripleStrLitTest-procs-all">
|
<div id="tripleStrLitTest-procs-all">
|
||||||
<div id="tripleStrLitTest">
|
<div id="tripleStrLitTest">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#tripleStrLitTest"><span class="Identifier">tripleStrLitTest</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#tripleStrLitTest"><span class="Identifier">tripleStrLitTest</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -756,7 +759,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z1-procs-all">
|
<div id="z1-procs-all">
|
||||||
<div id="z1">
|
<div id="z1">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z1"><span class="Identifier">z1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="testproject.html#Foo"><span class="Identifier">Foo</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z1"><span class="Identifier">z1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="testproject.html#Foo"><span class="Identifier">Foo</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz1
|
cz1
|
||||||
|
|
@ -767,7 +770,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z2-procs-all">
|
<div id="z2-procs-all">
|
||||||
<div id="z2">
|
<div id="z2">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z2"><span class="Identifier">z2</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z2"><span class="Identifier">z2</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz2
|
cz2
|
||||||
|
|
@ -780,7 +783,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z3-procs-all">
|
<div id="z3-procs-all">
|
||||||
<div id="z3">
|
<div id="z3">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z3"><span class="Identifier">z3</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z3"><span class="Identifier">z3</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz3
|
cz3
|
||||||
|
|
@ -791,7 +794,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z4-procs-all">
|
<div id="z4-procs-all">
|
||||||
<div id="z4">
|
<div id="z4">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z4"><span class="Identifier">z4</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z4"><span class="Identifier">z4</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz4
|
cz4
|
||||||
|
|
@ -802,7 +805,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z5-procs-all">
|
<div id="z5-procs-all">
|
||||||
<div id="z5">
|
<div id="z5">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z5"><span class="Identifier">z5</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z5"><span class="Identifier">z5</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz5
|
cz5
|
||||||
|
|
@ -813,7 +816,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z6-procs-all">
|
<div id="z6-procs-all">
|
||||||
<div id="z6">
|
<div id="z6">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z6"><span class="Identifier">z6</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z6"><span class="Identifier">z6</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz6
|
cz6
|
||||||
|
|
@ -824,7 +827,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z7-procs-all">
|
<div id="z7-procs-all">
|
||||||
<div id="z7">
|
<div id="z7">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z7"><span class="Identifier">z7</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z7"><span class="Identifier">z7</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz7
|
cz7
|
||||||
|
|
@ -835,7 +838,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z8-procs-all">
|
<div id="z8-procs-all">
|
||||||
<div id="z8">
|
<div id="z8">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z8"><span class="Identifier">z8</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z8"><span class="Identifier">z8</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz8
|
cz8
|
||||||
|
|
@ -846,7 +849,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z9-procs-all">
|
<div id="z9-procs-all">
|
||||||
<div id="z9">
|
<div id="z9">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z9"><span class="Identifier">z9</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z9"><span class="Identifier">z9</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -859,7 +862,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z10-procs-all">
|
<div id="z10-procs-all">
|
||||||
<div id="z10">
|
<div id="z10">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z10"><span class="Identifier">z10</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z10"><span class="Identifier">z10</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -872,7 +875,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z11-procs-all">
|
<div id="z11-procs-all">
|
||||||
<div id="z11">
|
<div id="z11">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z11"><span class="Identifier">z11</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z11"><span class="Identifier">z11</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -885,7 +888,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z12-procs-all">
|
<div id="z12-procs-all">
|
||||||
<div id="z12">
|
<div id="z12">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z12"><span class="Identifier">z12</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z12"><span class="Identifier">z12</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -898,7 +901,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z13-procs-all">
|
<div id="z13-procs-all">
|
||||||
<div id="z13">
|
<div id="z13">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z13"><span class="Identifier">z13</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z13"><span class="Identifier">z13</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz13
|
cz13
|
||||||
|
|
@ -911,7 +914,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="z17-procs-all">
|
<div id="z17-procs-all">
|
||||||
<div id="z17">
|
<div id="z17">
|
||||||
<dt><pre><span class="Keyword">proc</span> <a href="#z17"><span class="Identifier">z17</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">proc</span> <a href="#z17"><span class="Identifier">z17</span></a><span class="Other">(</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
cz17 rest
|
cz17 rest
|
||||||
|
|
@ -930,7 +933,7 @@ at indent 0
|
||||||
<dl class="item">
|
<dl class="item">
|
||||||
<div id="method1-methods-all">
|
<div id="method1-methods-all">
|
||||||
<div id="method1.e,Moo">
|
<div id="method1.e,Moo">
|
||||||
<dt><pre><span class="Keyword">method</span> <a href="#method1.e%2CMoo"><span class="Identifier">method1</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">method</span> <a href="#method1.e%2CMoo"><span class="Identifier">method1</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
foo1
|
foo1
|
||||||
|
|
@ -941,7 +944,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="method2-methods-all">
|
<div id="method2-methods-all">
|
||||||
<div id="method2.e,Moo">
|
<div id="method2.e,Moo">
|
||||||
<dt><pre><span class="Keyword">method</span> <a href="#method2.e%2CMoo"><span class="Identifier">method2</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">method</span> <a href="#method2.e%2CMoo"><span class="Identifier">method2</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
foo2
|
foo2
|
||||||
|
|
@ -952,7 +955,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="method3-methods-all">
|
<div id="method3-methods-all">
|
||||||
<div id="method3.e,Moo">
|
<div id="method3.e,Moo">
|
||||||
<dt><pre><span class="Keyword">method</span> <a href="#method3.e%2CMoo"><span class="Identifier">method3</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">method</span> <a href="#method3.e%2CMoo"><span class="Identifier">method3</span></a><span class="Other">(</span><span class="Identifier">self</span><span class="Other">:</span> <span class="Identifier">Moo</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span class="Identifier">base</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
foo3
|
foo3
|
||||||
|
|
@ -969,7 +972,7 @@ at indent 0
|
||||||
<dl class="item">
|
<dl class="item">
|
||||||
<div id="fromUtils1-iterators-all">
|
<div id="fromUtils1-iterators-all">
|
||||||
<div id="fromUtils1.i">
|
<div id="fromUtils1.i">
|
||||||
<dt><pre><span class="Keyword">iterator</span> <a href="#fromUtils1.i"><span class="Identifier">fromUtils1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">iterator</span> <a href="#fromUtils1.i"><span class="Identifier">fromUtils1</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -984,7 +987,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="iter1-iterators-all">
|
<div id="iter1-iterators-all">
|
||||||
<div id="iter1.i,int">
|
<div id="iter1.i,int">
|
||||||
<dt><pre><span class="Keyword">iterator</span> <a href="#iter1.i%2Cint"><span class="Identifier">iter1</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">iterator</span> <a href="#iter1.i%2Cint"><span class="Identifier">iter1</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
foo1
|
foo1
|
||||||
|
|
@ -995,7 +998,7 @@ at indent 0
|
||||||
</div>
|
</div>
|
||||||
<div id="iter2-iterators-all">
|
<div id="iter2-iterators-all">
|
||||||
<div id="iter2.i,int">
|
<div id="iter2.i,int">
|
||||||
<dt><pre><span class="Keyword">iterator</span> <a href="#iter2.i%2Cint"><span class="Identifier">iter2</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
|
<dt><pre><span class="Keyword">iterator</span> <a href="#iter2.i%2Cint"><span class="Identifier">iter2</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span>.}</pre></dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
|
||||||
foo2
|
foo2
|
||||||
|
|
|
||||||
21
tests/effects/teffects11.nim
Normal file
21
tests/effects/teffects11.nim
Normal file
|
|
@ -0,0 +1,21 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "type mismatch: got <proc (x: int){.gcsafe, locks: 0.}>"
|
||||||
|
line: 21
|
||||||
|
"""
|
||||||
|
|
||||||
|
type
|
||||||
|
Effect1 = object
|
||||||
|
Effect2 = object
|
||||||
|
Effect3 = object
|
||||||
|
|
||||||
|
proc test(fnc: proc(x: int): void {.forbids: [Effect2].}) {.tags: [Effect1, Effect3, RootEffect].} =
|
||||||
|
fnc(1)
|
||||||
|
|
||||||
|
proc t1(x: int): void = echo $x
|
||||||
|
proc t2(x: int): void {.tags: [Effect2].} = echo $x
|
||||||
|
proc t3(x: int): void {.tags: [Effect3].} = echo $x
|
||||||
|
|
||||||
|
test(t1)
|
||||||
|
test(t3)
|
||||||
|
test(t2)
|
||||||
52
tests/effects/teffects12.nim
Normal file
52
tests/effects/teffects12.nim
Normal file
|
|
@ -0,0 +1,52 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
"""
|
||||||
|
|
||||||
|
import std/locks
|
||||||
|
|
||||||
|
type
|
||||||
|
Test2Effect* = object
|
||||||
|
Test2* = object
|
||||||
|
value2*: int
|
||||||
|
Test1Effect* = object
|
||||||
|
Test1* = object
|
||||||
|
value1*: int
|
||||||
|
Main* = object
|
||||||
|
test1Lock: Lock
|
||||||
|
test1: Test1
|
||||||
|
test2Lock: Lock
|
||||||
|
test2: Test2
|
||||||
|
|
||||||
|
proc `=copy`(obj1: var Test2, obj2: Test2) {.error.}
|
||||||
|
proc `=copy`(obj1: var Test1, obj2: Test1) {.error.}
|
||||||
|
proc `=copy`(obj1: var Main, obj2: Main) {.error.}
|
||||||
|
|
||||||
|
proc withTest1(main: var Main,
|
||||||
|
fn: proc(test1: var Test1) {.gcsafe, forbids: [Test1Effect].}) {.gcsafe, tags: [Test1Effect, RootEffect].} =
|
||||||
|
withLock(main.test1Lock):
|
||||||
|
fn(main.test1)
|
||||||
|
|
||||||
|
proc withTest2(main: var Main,
|
||||||
|
fn: proc(test1: var Test2) {.gcsafe, forbids: [Test2Effect].}) {.gcsafe, tags: [Test2Effect, RootEffect].} =
|
||||||
|
withLock(main.test2Lock):
|
||||||
|
fn(main.test2)
|
||||||
|
|
||||||
|
proc newMain(): Main =
|
||||||
|
var test1lock: Lock
|
||||||
|
initLock(test1Lock)
|
||||||
|
var test2lock: Lock
|
||||||
|
initLock(test2Lock)
|
||||||
|
var main = Main(test1Lock: move(test1Lock), test1: Test1(value1: 1),
|
||||||
|
test2Lock: move(test2Lock), test2: Test2(value2: 2))
|
||||||
|
main.withTest1(proc(test1: var Test1) = test1.value1 += 1)
|
||||||
|
main.withTest2(proc(test2: var Test2) = test2.value2 += 1)
|
||||||
|
move main
|
||||||
|
|
||||||
|
var main = newMain()
|
||||||
|
main.withTest1(proc(test1: var Test1) =
|
||||||
|
test1.value1 += 1
|
||||||
|
main.withTest2(proc(test2: var Test2) = test2.value2 += 1)
|
||||||
|
)
|
||||||
|
|
||||||
|
main.withTest1(proc(test1: var Test1) {.tags: [].} = echo $test1.value1)
|
||||||
|
main.withTest2(proc(test2: var Test2) {.tags: [].} = echo $test2.value2)
|
||||||
19
tests/effects/teffects13.nim
Normal file
19
tests/effects/teffects13.nim
Normal file
|
|
@ -0,0 +1,19 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "writeSomething() has an illegal effect: WriteIO"
|
||||||
|
line: 19
|
||||||
|
"""
|
||||||
|
|
||||||
|
type
|
||||||
|
IO = object of RootEffect ## input/output effect
|
||||||
|
ReadIO = object of IO ## input effect
|
||||||
|
WriteIO = object of IO ## output effect
|
||||||
|
|
||||||
|
proc readSomething(): string {.tags: [ReadIO].} = ""
|
||||||
|
proc writeSomething(): void {.tags: [WriteIO].} = echo "..."
|
||||||
|
|
||||||
|
proc noWritesPlease() {.forbids: [WriteIO].} =
|
||||||
|
# this is OK:
|
||||||
|
echo readSomething()
|
||||||
|
# the compiler prevents this:
|
||||||
|
writeSomething()
|
||||||
15
tests/effects/teffects14.nim
Normal file
15
tests/effects/teffects14.nim
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "func1() has an illegal effect: IO"
|
||||||
|
line: 15
|
||||||
|
"""
|
||||||
|
|
||||||
|
type IO = object ## input/output effect
|
||||||
|
proc func1(): string {.tags: [IO].} = discard
|
||||||
|
proc func2(): string = discard
|
||||||
|
|
||||||
|
proc no_IO_please() {.forbids: [IO].} =
|
||||||
|
# this is OK because it didn't define any tag:
|
||||||
|
discard func2()
|
||||||
|
# the compiler prevents this:
|
||||||
|
let y = func1()
|
||||||
18
tests/effects/teffects15.nim
Normal file
18
tests/effects/teffects15.nim
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "method1(c) has an illegal effect: IO"
|
||||||
|
line: 18
|
||||||
|
"""
|
||||||
|
|
||||||
|
type
|
||||||
|
IO = object ## input/output effect
|
||||||
|
CustomObject* = object of RootObj
|
||||||
|
text: string
|
||||||
|
|
||||||
|
method method1(obj: var CustomObject): string {.tags: [IO].} = obj.text & "."
|
||||||
|
method method2(obj: var CustomObject): string = obj.text & ":"
|
||||||
|
|
||||||
|
proc noIO() {.forbids: [IO].} =
|
||||||
|
var c = CustomObject(text: "a")
|
||||||
|
echo c.method2()
|
||||||
|
echo c.method1()
|
||||||
20
tests/effects/teffects16.nim
Normal file
20
tests/effects/teffects16.nim
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "writeSomething(\"a\") can have an unlisted effect: WriteIO"
|
||||||
|
line: 20
|
||||||
|
"""
|
||||||
|
|
||||||
|
type
|
||||||
|
IO = object of RootEffect ## input/output effect
|
||||||
|
ReadIO = object of IO ## input effect
|
||||||
|
WriteIO = object of IO ## output effect
|
||||||
|
LogIO = object of IO ## another output effect
|
||||||
|
|
||||||
|
proc readSomething(): string {.tags: [ReadIO].} = ""
|
||||||
|
proc writeSomething(msg: string): void {.tags: [WriteIO].} = echo msg
|
||||||
|
proc logSomething(msg: string): void {.tags: [LogIo].} = echo msg
|
||||||
|
|
||||||
|
proc noWritesPlease() {.forbids: [WriteIO], tags: [LogIO, ReadIO].} =
|
||||||
|
echo readSomething()
|
||||||
|
logSomething("a")
|
||||||
|
writeSomething("a")
|
||||||
17
tests/effects/teffects17.nim
Normal file
17
tests/effects/teffects17.nim
Normal file
|
|
@ -0,0 +1,17 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "writeSomething(\"a\") has an illegal effect: WriteIO"
|
||||||
|
line: 17
|
||||||
|
"""
|
||||||
|
|
||||||
|
type
|
||||||
|
IO = object of RootEffect ## input/output effect
|
||||||
|
ReadIO = object of IO ## input effect
|
||||||
|
WriteIO = object of IO ## output effect
|
||||||
|
|
||||||
|
proc readSomething(): string {.tags: [ReadIO].} = ""
|
||||||
|
proc writeSomething(msg: string): void {.tags: [WriteIO].} = echo msg
|
||||||
|
|
||||||
|
proc illegalEffectNegation() {.forbids: [WriteIO], tags: [ReadIO, WriteIO].} =
|
||||||
|
echo readSomething()
|
||||||
|
writeSomething("a")
|
||||||
19
tests/effects/teffects18.nim
Normal file
19
tests/effects/teffects18.nim
Normal file
|
|
@ -0,0 +1,19 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "type mismatch: got <ProcType2>"
|
||||||
|
line: 19
|
||||||
|
"""
|
||||||
|
|
||||||
|
type MyEffect = object
|
||||||
|
type ProcType1 = proc (i: int): void {.forbids: [MyEffect].}
|
||||||
|
type ProcType2 = proc (i: int): void
|
||||||
|
|
||||||
|
proc testFunc(p: ProcType1): void = p(1)
|
||||||
|
|
||||||
|
proc toBeCalled(i: int): void {.tags: [MyEffect].} = echo $i
|
||||||
|
|
||||||
|
let emptyTags = proc(i: int): void {.tags: [].} = echo $i
|
||||||
|
let noTags: ProcType2 = proc(i: int): void = toBeCalled(i)
|
||||||
|
|
||||||
|
testFunc(emptyTags)
|
||||||
|
testFunc(noTags)
|
||||||
23
tests/effects/teffects19.nim
Normal file
23
tests/effects/teffects19.nim
Normal file
|
|
@ -0,0 +1,23 @@
|
||||||
|
discard """
|
||||||
|
action: compile
|
||||||
|
errormsg: "type mismatch: got <proc (i: int){.gcsafe, locks: 0.}>"
|
||||||
|
line: 23
|
||||||
|
"""
|
||||||
|
|
||||||
|
type MyEffect = object
|
||||||
|
type ProcType1 = proc (i: int): void {.forbids: [MyEffect].}
|
||||||
|
type ProcType2 = proc (i: int): void
|
||||||
|
|
||||||
|
proc caller1(p: ProcType1): void = p(1)
|
||||||
|
proc caller2(p: ProcType2): void = p(1)
|
||||||
|
|
||||||
|
proc effectful(i: int): void {.tags: [MyEffect].} = echo $i
|
||||||
|
proc effectless(i: int): void {.forbids: [MyEffect].} = echo $i
|
||||||
|
|
||||||
|
proc toBeCalled1(i: int): void = effectful(i)
|
||||||
|
proc toBeCalled2(i: int): void = effectless(i)
|
||||||
|
|
||||||
|
caller1(toBeCalled2)
|
||||||
|
caller2(toBeCalled1)
|
||||||
|
caller2(toBeCalled2)
|
||||||
|
caller1(toBeCalled1)
|
||||||
Loading…
Add table
Add a link
Reference in a new issue