Label: Difference between revisions

From Wiki of ZZT
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 8: Line 8:
Labels should consist of Latin alphabet letters (A - Z) and underscores. They are not case sensitive - <code>TOUCH</code> , <code>Touch</code> and <code>touch</code> refer to the same message.
Labels should consist of Latin alphabet letters (A - Z) and underscores. They are not case sensitive - <code>TOUCH</code> , <code>Touch</code> and <code>touch</code> refer to the same message.


The first occurrence of a label in the code is always used as the destination. To allow using additional occurrences of a label, labels can be [[Zap|zapped]], where they act as [[Comment|comments]] and will be ignored by [[Send|#send]] - for example, 'shot is the zapped form of the :shot label.
The first occurrence of a label in the code is always used as the destination. To allow using additional occurrences of a label, labels can be [[Zap|zapped]], where they act as [[Comment|comments]] and will be ignored by [[Send|#send]] - for example, <code>'shot</code> is the zapped form of the <code>:shot</code> label.


== Quirks ==
== Quirks ==

Revision as of 07:56, 24 December 2025

Lines of ZZT-OOP beginning with a colon : are labels.

Labels allow associating a specific location in the object's code with a specific message. The object will move program execution to such a location in the following two cases:

  • when explicitly requested by an object, including a different object, using #send;
  • when the game engine causes one of the built-in messages to be sent to the object.

Labels should consist of Latin alphabet letters (A - Z) and underscores. They are not case sensitive - TOUCH , Touch and touch refer to the same message.

The first occurrence of a label in the code is always used as the destination. To allow using additional occurrences of a label, labels can be zapped, where they act as comments and will be ignored by #send - for example, 'shot is the zapped form of the :shot label.

Quirks

  • Non-alphabet characters, such as numbers, may be used as part of a label; however, if a label is followed by additional such characters, it is also considered a valid match for a given message.
    • For example, the message touch will match the label :touch as well as the labels :touch , :touch1 and :touché, but not the labels :toucha or :touch_1.
    • Notably, this rule does not apply for the #restore command for the second and additional label occurrences, where an exact string match is required.