schemaName (schema -- reportedName)

Builtins

Name introduction, declaration modifiers, and module binding: NAME: ...;, codeRef, def, exportFunction, importFunction, importVariable, overload, private, static, use, and virtual.
Struct construction forms: (...), {...}, and array.
Selection forms: source-text selection with NAME and .NAME, read-only source-text selection with @NAME and .@NAME, and ordinal or known-name data-input selection with @, callField, and fieldRead.
Writing forms: source-text selection with !NAME and .!NAME, ordinal selection with ! and fieldWrite, and already-selected destination replacement with set.
Calling and control flow: call, if, loop, ucall, and uif.
Text operations: &, LF, attribute, textSize, and textSplit.
Condition constants, value comparison, and logical operators: <, =, >, DEBUG, FALSE, TRUE, and, is, lshift, or, rshift, xor, and ~.
Arithmetic and numeric transforms: *, +, -, /, ^, cast, ceil, cos, floor, log, log10, mod, neg, sin, and sqrt.
Reference, creation, and value-state operations: const, dynamic, isConst, isDirty, isDynamic, isRef, isStatic, known?, new, newVarOfTheSameType, stable?, unconst, and unknownStable?.
Schema and struct introspection: code?, codeRef?, fieldCount, fieldIndex, fieldIsRef, fieldIsVirtual, fieldName, has, isCombined, managed?, same, schemaName, and virtual?.
Storage and manual lifetime operations: addressToReference, alignment, manuallyDestroyVariable, manuallyInitVariable, storageAddress, and storageSize.
Diagnostics and compile-time failure: failCompilation, getCallTrace, printCompilerMessage, printStack, printStackTrace, and raiseStaticError.

schemaName (schema -- reportedName)

Inputs

schema: Value or Ref whose dereferenced schema is the one being named.

Outputs

reportedName: Known Text reported schema name.

schemaName is a dereferenced-schema naming query. It returns the reported name of the dereferenced schema as known Text.

Without a valid override, the result is the default formatted name of the dereferenced schema.

Only a Dict schema overrides that default, and only with a static Text field named SCHEMA_NAME. Current value contents do not participate. Matching reported names still do not imply same.

schemaName is descriptive only. Use same when exact dereferenced-schema identity matters.

Behavior

The result is always known Text.

Ref values are dereferenced before formatting, so a Ref input reports the dereferenced schema, not the Ref schema itself.

Only a Dict schema overrides the default formatted name.

The override is used only when SCHEMA_NAME is a static Text field.

If SCHEMA_NAME is absent, non-static, or not Text, the default formatted schema name is returned.

Two different schemas can still report the same name.

Example

{} () {} [ value: 0 dynamic; "-- dereferenced schema --" printCompilerMessage value schemaName printStack _:; @value schemaName printStack _:; named: { SCHEMA_NAME: "Greeting" virtual; value: 0; }; "-- static text override --" printCompilerMessage named schemaName printStack _:; @named schemaName printStack _:; "-- ignored overrides --" printCompilerMessage { SCHEMA_NAME: 0 ("Temp") dynamic @; value: 0; } schemaName printStack _:; { SCHEMA_NAME: 0 virtual; value: 0; } schemaName printStack _:; ] "main" exportFunction

Expected Output During Compilation

-- dereferenced schema -- "Int32" "Int32" -- static text override -- "Greeting" "Greeting" -- ignored overrides -- "{SCHEMA_NAME: Text; value: Int32;}" "{SCHEMA_NAME: 0 virtual; value: Int32;}"