La bibliothèque se documente elle-même · Traitement du langage et linguistique

stzNaturalEngine

64 méthodes propres · 0 formes avec extensions, rangées sous leur méthode

la source: base/natural/stzNatural.ring(s'ouvre dans un nouvel onglet) · Toutes les classes · La référence du domaine : Traitement du langage et linguistique

Sous chaque méthode, ses extensions (Q CS XT Z ZZ IB W U) : en gras et cochée, elle existe ; barrée, elle n'existe pas. Les extensions et leur sens

Exemples : 0 viennent des tests de la bibliothèque ; 24 ont été composés à partir de la signature de chaque méthode et exécutés pour cette page, sur un objet neuf, par exemple o1 = new stzNaturalEngine("en", "", [], ""). 40 méthodes n'en ont pas encore. Exemples exécutés le 2026-10-03 20:34 dans la bibliothèque au commit 0e72e2e2c.

Méthode

Explication, telle que la source la porte

init

(sans commentaire dans la source : le nom se lit comme une phrase) initaucune extension

InterpolateContext

(sans commentaire dans la source : le nom se lit comme une phrase) interpolate context

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.InterpolateContext("a", [ 2, 3 ])
#--> a

composé à partir de la signature, exécuté pour cette page

aucune extension

FindContextPlaceholders

(sans commentaire dans la source : le nom se lit comme une phrase) find context placeholdersaucune extension

GetContextValue

(sans commentaire dans la source : le nom se lit comme une phrase) get context value

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.GetContextValue("a", [ 2, 3 ])
#--> not_found

composé à partir de la signature, exécuté pour cette page

aucune extension

NormalizeKey

(sans commentaire dans la source : le nom se lit comme une phrase) normalize key

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.NormalizeKey("a")
#--> A

composé à partir de la signature, exécuté pour cette page

aucune extension

FindInList

(sans commentaire dans la source : le nom se lit comme une phrase) find in list

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.FindInList([ 2, 3 ], "a")
#--> not_found

composé à partir de la signature, exécuté pour cette page

aucune extension

Execute

(sans commentaire dans la source : le nom se lit comme une phrase) executeaucune extension

TokenizeCode

(sans commentaire dans la source : le nom se lit comme une phrase) tokenize codeaucune extension

SmartSplit

(sans commentaire dans la source : le nom se lit comme une phrase) smart split

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.SmartSplit("a") )
#--> [ "a" ]

composé à partir de la signature, exécuté pour cette page

aucune extension

LooksEvalSafeList

Only these SHAPES may be eval'd as list literals: a bracketed [ ... ] form, or a pure numeric range like 1:5. Prose that isListInString() mistakes for a range ("note:") is rejected.aucune extension

PairedQuoteSections

Non-overlapping quote pairing: positions 1-2, 3-4, ... form the quoted sections. An unmatched trailing quote is simply ignored. An apostrophe with a LETTER on both sides is part of a word ("it's", "don't"), not a string delimiter.aucune extension

NormalizeForeignDigits

Normalize the language's digits and list punctuation OUTSIDE quoted strings (Arabic-Indic numerals in a value list must become ASCII for the list eval; a quoted string keeps its script untouched).

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.NormalizeForeignDigits("a")
#--> a

composé à partir de la signature, exécuté pour cette page

aucune extension

MapDigits

(sans commentaire dans la source : le nom se lit comme une phrase) map digits

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.MapDigits("a")
#--> a

composé à partir de la signature, exécuté pour cette page

aucune extension

StripEdgePunct

A word without clinging trailing punctuation ("empty?" -> "empty"). BYTE-based whole-mark matching (StzLeft/StzRight take byte counts while StzLen counts codepoints -- mixing them mangles multibyte words; exact byte-suffix comparison is UTF-8-safe).

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.StripEdgePunct("a")
#--> a

composé à partir de la signature, exécuté pour cette page

aucune extension

PhraseResolve

MULTI-WORD PHRASE resolution: head word + up to two following content words (ignored words skipped), longest EXACT method-name join wins -- "remove [its] duplicates" -> removeduplicates, "is [it] empty" -> isempty. Returns [ semanticId, nextIndex, matchedPhrase ] or [ "", 0, "" ]. Only consulted when at least one word is dictionary-unknown, so pure-dictionary programs never pay the lazy lexicon growth.aucune extension

LoadLanguageData

(sans commentaire dans la source : le nom se lit comme une phrase) load language dataaucune extension

LangResolvable

May unknown words of the active language be resolved at all? English always (the unified lexicon); others when a pack exists.

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.LangResolvable()
#--> 1

composé à partir de la signature, exécuté pour cette page

aucune extension

SetStrict

(sans commentaire dans la source : le nom se lit comme une phrase) set strictaucune extension

SetAllowedOperations

(sans commentaire dans la source : le nom se lit comme une phrase) set allowed operationsaucune extension

FindLanguageDefinition

(sans commentaire dans la source : le nom se lit comme une phrase) find language definitionaucune extension

Process

(sans commentaire dans la source : le nom se lit comme une phrase) processaucune extension

ConvertToSemanticTokens

(sans commentaire dans la source : le nom se lit comme une phrase) convert to semantic tokensaucune extension

ShouldTreatAsLiteral

(sans commentaire dans la source : le nom se lit comme une phrase) should treat as literalaucune extension

FallbackEligible

May an unknown word at the current position be fallback-resolved to an action? NO whenever the word sits in a VALUE position: right after an OBJECT_* (it is the creation value: Create a string with capitals), right after a VALUE_INDICATOR, or right after a METHOD_* that still expects parameters (Replace dot with underscore). In all those spots the word must stay a literal -- resolution would corrupt the program.aucune extension

IsIgnoredWord

(sans commentaire dans la source : le nom se lit comme une phrase) is ignored word

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.IsIgnoredWord("a")
#--> 1

composé à partir de la signature, exécuté pour cette page

aucune extension

ToSemantic

(sans commentaire dans la source : le nom se lit comme une phrase) to semanticaucune extension

GenerateCodeFromSemantics

(sans commentaire dans la source : le nom se lit comme une phrase) generate code from semanticsaussi écrite: Codeaucune extension

FindDefineIndex

(sans commentaire dans la source : le nom se lit comme une phrase) find define index

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.FindDefineIndex("a")
#--> 0

composé à partir de la signature, exécuté pour cette page

aucune extension

ProcessObjectCreation

(sans commentaire dans la source : le nom se lit comme une phrase) process object creation

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ProcessObjectCreation(2) )
#--> [ [ "code", "" ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

ProcessObjectNaming

'... called <name>': alias the CURRENT object as o_<name>. The next literal token after NAME_INDICATOR is the name (guards make sure it stayed literal even if it collides with a dictionary word).

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ProcessObjectNaming(2) )
#--> [ [ "code", "" ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

ProcessObjectSwitch

'Use <name>': switch the live object to a previously named one. Unknown names are skipped with a debug note (permissive execution).

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.ProcessObjectSwitch(2)
#--> 3

composé à partir de la signature, exécuté pour cette page

aucune extension

ProcessValueKeep

'Keep it as <name>': bind the current result to a VALUE variable. pbFromQuery says whether a query line just set @result.

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ProcessValueKeep(2, TRUE) )
#--> [ [ "code", "" ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

ValueRefOf

RECALL: the bound variable for a literal token, or "" -- only bare WORDS recall (a quoted 'sep' is data, never a reference).aucune extension

SanitizedName

(sans commentaire dans la source : le nom se lit comme une phrase) sanitized name

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.SanitizedName("a")
#--> a

composé à partir de la signature, exécuté pour cette page

aucune extension

NamedObjects

(sans commentaire dans la source : le nom se lit comme une phrase) named objectsaucune extension

ProcessMethod

(sans commentaire dans la source : le nom se lit comme une phrase) process method

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ProcessMethod(2, "a") )
#--> [ [ "code", "" ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

ExtractMethodParameters

(sans commentaire dans la source : le nom se lit comme une phrase) extract method parameters

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ExtractMethodParameters(2, 5) )
#--> [ [ "params", [ ] ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

ExtractParamsBackward

VERB-FINAL grammar: the parameters precede their verb ("'.'" instead- of "'_'" put). Walk backward to the previous action/creation boundary collecting unconsumed literals, keep the LAST nParamCount in textual order, and mark them consumed so no later verb re-grabs them.aucune extension

ProcessMethodWithModifiers

(sans commentaire dans la source : le nom se lit comme une phrase) process method with modifiers

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.ProcessMethodWithModifiers(2, "a") )
#--> [ [ "code", "" ], [ "next_index", 3 ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

GetSemanticOperation

(sans commentaire dans la source : le nom se lit comme une phrase) get semantic operationaucune extension

Result

(sans commentaire dans la source : le nom se lit comme une phrase) resultaucune extension

Answers

INTERROGATIVE NARRATIONS (the stzChainOfTruth absorption, NATURAL_VISION step 4): every QUERY in the narration records its answer, in order. A chain of truth is now just a narration that asks several questions: Naturally("Create a string with 'ring' Is it lowercase ? Does it contain 'g' ?").AllYes() #--> 1 Result() stays "the last thing produced" (unchanged contract); Answers() exposes the full record; AllYes()/AnyYes() fold it.aucune extension

AllYes

(sans commentaire dans la source : le nom se lit comme une phrase) all yesaussi écrite: AllTrue

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.AllYes()
#--> 0

composé à partir de la signature, exécuté pour cette page

aucune extension

AnyYes

(sans commentaire dans la source : le nom se lit comme une phrase) any yesaussi écrite: AnyTrue

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.AnyYes()
#--> 0

composé à partir de la signature, exécuté pour cette page

aucune extension

OriginalCode

(sans commentaire dans la source : le nom se lit comme une phrase) original codeaucune extension

NaturalCode

(sans commentaire dans la source : le nom se lit comme une phrase) natural codeaucune extension

Understood

PARAPHRASE-BACK (the Boeing-CPL trust loop): say what was UNDERSTOOD, in plain words derived from the interpreted tokens -- so the writer of a loosely-phrased (or vocalized Arabic) narration sees the canonical reading before trusting the result.aucune extension

SuggestNext

(sans commentaire dans la source : le nom se lit comme une phrase) suggest nextaucune extension

Unresolved

UNDERSTANDABILITY: the action-position words this run could not interpret, each with the nearest known word as a suggestion -- [ [word, suggestion], ... ]. Execution is permissive (unknown words degrade to literals); this is the honest report of it.aucune extension

UnderstoodAll

(sans commentaire dans la source : le nom se lit comme une phrase) understood all

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.UnderstoodAll()
#--> 1

composé à partir de la signature, exécuté pour cette page

aucune extension

Analyze

Dry run: tokenize + interpret WITHOUT generating or executing any code. Returns the lint report.

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? @@( o1.Analyze("a") )
#--> [ [ "understood", 1 ], [ "unresolved", [ ] ] ]

composé à partir de la signature, exécuté pour cette page

aucune extension

Context

(sans commentaire dans la source : le nom se lit comme une phrase) contextaucune extension

EnableDebug

(sans commentaire dans la source : le nom se lit comme une phrase) enable debugaucune extension

DisableDebug

(sans commentaire dans la source : le nom se lit comme une phrase) disable debugaucune extension

AddToDebugLog

(sans commentaire dans la source : le nom se lit comme une phrase) add to debug logaucune extension

DebugLog

(sans commentaire dans la source : le nom se lit comme une phrase) debug logaucune extension

ClearDebugLog

(sans commentaire dans la source : le nom se lit comme une phrase) clear debug logaucune extension

ClearDebug

(sans commentaire dans la source : le nom se lit comme une phrase) clear debugaucune extension

Language

(sans commentaire dans la source : le nom se lit comme une phrase) language

exemple composé

o1 = new stzNaturalEngine("en", "", [], "")
? o1.Language()
#--> en

composé à partir de la signature, exécuté pour cette page

aucune extension

IgnoredWords

(sans commentaire dans la source : le nom se lit comme une phrase) ignored wordsaucune extension

Mappings

(sans commentaire dans la source : le nom se lit comme une phrase) mappingsaucune extension

Values

(sans commentaire dans la source : le nom se lit comme une phrase) valuesaucune extension

Tokens

(sans commentaire dans la source : le nom se lit comme une phrase) tokensaucune extension

Object

(sans commentaire dans la source : le nom se lit comme une phrase) objectaucune extension