vim: runtime/doc/vim9class.txt annotate

annotate runtime/doc/vim9class.txt @ 33678:7d9d2404a3d4 v9.0.2076

patch 9.0.2076: Vim9: No support for type aliases Commit: https://github.com/vim/vim/commit/ec3cebbd2b6b7583d2f683f5e66345163ec122aa Author: Yegappan Lakshmanan <yegappan@yahoo.com> Date: Fri Oct 27 19:35:26 2023 +0200 patch 9.0.2076: Vim9: No support for type aliases Problem: Vim9: No support for type aliases Solution: Implement :type command A type definition is giving a name to a type specification. This also known type alias. :type ListOfStrings = list<string> The type alias can be used wherever a built-in type can be used. The type alias name must start with an upper case character. closes: #13407 Signed-off-by: Christian Brabandt <cb@256bit.org> Signed-off-by: Yegappan Lakshmanan <yegappan@yahoo.com>

author	Christian Brabandt <cb@256bit.org>
date	Fri, 27 Oct 2023 19:45:05 +0200
parents	53416c49a7ab
children	f126ffc85f7c

rev	line source
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	1 vim9class.txt For Vim version 9.0. Last change: 2023 Sep 18
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	2
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	3
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	4 VIM REFERENCE MANUAL by Bram Moolenaar
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	5
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	6
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	7 NOTE - This is not finished yet, anything can still change! - NOTE
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	8
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	9
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	10 Vim9 classes, objects, interfaces, types and enums.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	11
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	12 1. Overview \|Vim9-class-overview\|
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	13 2. A simple class \|Vim9-simple-class\|
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	14 3. Class variables and methods \|Vim9-class-member\|
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	15 4. Using an abstract class \|Vim9-abstract-class\|
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	16 5. Using an interface \|Vim9-using-interface\|
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	17 6. More class details \|Vim9-class\|
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	18 7. Type definition \|Vim9-type\|
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	19 8. Enum \|Vim9-enum\|
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	20
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	21 9. Rationale
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	22 10. To be done later
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	23
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	24 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	25
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	26 1. Overview Vim9-class-overview
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	27
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	28 The fancy term is "object-oriented programming". You can find lots of study
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	29 material on this subject. Here we document what \|Vim9\| script provides,
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	30 assuming you know the basics already. Added are helpful hints about how to
33636 53416c49a7ab patch 9.0.2059: outstanding exceptions may be skipped Christian Brabandt <cb@256bit.org> parents: 33490 diff changeset	31 use this functionality effectively. Vim9 classes and objects cannot be used
53416c49a7ab patch 9.0.2059: outstanding exceptions may be skipped Christian Brabandt <cb@256bit.org> parents: 33490 diff changeset	32 in legacy Vim scripts and legacy functions.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	33
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	34 The basic item is an object:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	35 - An object stores state. It contains one or more variables that can each
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	36 have a value.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	37 - An object provides functions that use and manipulate its state. These
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	38 functions are invoked "on the object", which is what sets it apart from the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	39 traditional separation of data and code that manipulates the data.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	40 - An object has a well defined interface, with typed member variables and
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	41 methods.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	42 - Objects are created from a class and all objects have the same interface.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	43 This does not change at runtime, it is not dynamic.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	44
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	45 An object can only be created by a class. A class provides:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	46 - A new() method, the constructor, which returns an object for the class.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	47 This method is invoked on the class name: MyClass.new().
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	48 - State shared by all objects of the class: class variables (class members).
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	49 - A hierarchy of classes, with super-classes and sub-classes, inheritance.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	50
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	51 An interface is used to specify properties of an object:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	52 - An object can declare several interfaces that it implements.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	53 - Different objects implementing the same interface can be used the same way.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	54
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	55 The class hierarchy allows for single inheritance. Otherwise interfaces are
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	56 to be used where needed.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	57
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	58
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	59 Class modeling ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	60
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	61 You can model classes any way you like. Keep in mind what you are building,
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	62 don't try to model the real world. This can be confusing, especially because
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	63 teachers use real-world objects to explain class relations and you might think
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	64 your model should therefore reflect the real world. It doesn't! The model
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	65 should match your purpose.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	66
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	67 Keep in mind that composition (an object contains other objects) is often
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	68 better than inheritance (an object extends another object). Don't waste time
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	69 trying to find the optimal class model. Or waste time discussing whether a
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	70 square is a rectangle or that a rectangle is a square. It doesn't matter.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	71
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	72
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	73 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	74
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	75 2. A simple class Vim9-simple-class
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	76
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	77 Let's start with a simple example: a class that stores a text position (see
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	78 below for how to do this more efficiently): >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	79
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	80 class TextPosition
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	81 this.lnum: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	82 this.col: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	83
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	84 def new(lnum: number, col: number)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	85 this.lnum = lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	86 this.col = col
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	87 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	88
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	89 def SetLnum(lnum: number)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	90 this.lnum = lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	91 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	92
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	93 def SetCol(col: number)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	94 this.col = col
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	95 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	96
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	97 def SetPosition(lnum: number, col: number)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	98 this.lnum = lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	99 this.col = col
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	100 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	101 endclass
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	102 < object Object
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	103 You can create an object from this class with the new() method: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	104
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	105 var pos = TextPosition.new(1, 1)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	106
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	107 The object variables "lnum" and "col" can be accessed directly: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	108
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	109 echo $'The text position is ({pos.lnum}, {pos.col})'
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	110 < E1317 E1327
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	111 If you have been using other object-oriented languages you will notice that
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	112 in Vim the object members are consistently referred to with the "this."
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	113 prefix. This is different from languages like Java and TypeScript. The
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	114 naming convention makes the object members easy to spot. Also, when a
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	115 variable does not have the "this." prefix you know it is not an object
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	116 variable.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	117
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	118
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	119 Object variable write access ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	120
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	121 Now try to change an object variable directly: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	122
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	123 pos.lnum = 9
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	124 < E1335
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	125 This will give you an error! That is because by default object variables can
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	126 be read but not set. That's why the TextPosition class provides a method for
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	127 it: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	128
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	129 pos.SetLnum(9)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	130
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	131 Allowing to read but not set an object variable is the most common and safest
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	132 way. Most often there is no problem using a value, while setting a value may
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	133 have side effects that need to be taken care of. In this case, the SetLnum()
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	134 method could check if the line number is valid and either give an error or use
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	135 the closest valid value.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	136 :public E1331
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	137 If you don't care about side effects and want to allow the object variable to
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	138 be changed at any time, you can make it public: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	139
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	140 public this.lnum: number
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	141 public this.col: number
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	142
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	143 Now you don't need the SetLnum(), SetCol() and SetPosition() methods, setting
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	144 "pos.lnum" directly above will no longer give an error.
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	145 E1326
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	146 If you try to set an object variable that doesn't exist you get an error: >
31579 7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	147 pos.other = 9
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	148 < E1326: Member not found on object "TextPosition": other ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	149
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	150 E1376
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	151 A object variable cannot be accessed using the class name.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	152
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	153 Private variables ~
33383 5c12ca4dcd45 patch 9.0.1950: Vim9: error codes spread out Christian Brabandt <cb@256bit.org> parents: 33379 diff changeset	154 private-variable E1332 E1333
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	155 On the other hand, if you do not want the object variables to be read directly,
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	156 you can make them private. This is done by prefixing an underscore to the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	157 name: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	158
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	159 this._lnum: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	160 this._col number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	161
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	162 Now you need to provide methods to get the value of the private variables.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	163 These are commonly called getters. We recommend using a name that starts with
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	164 "Get": >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	165
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	166 def GetLnum(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	167 return this._lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	168 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	169
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	170 def GetCol() number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	171 return this._col
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	172 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	173
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	174 This example isn't very useful, the variables might as well have been public.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	175 It does become useful if you check the value. For example, restrict the line
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	176 number to the total number of lines: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	177
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	178 def GetLnum(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	179 if this._lnum > this._lineCount
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	180 return this._lineCount
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	181 endif
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	182 return this._lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	183 enddef
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	184 <
33025 1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	185 Private methods ~
33383 5c12ca4dcd45 patch 9.0.1950: Vim9: error codes spread out Christian Brabandt <cb@256bit.org> parents: 33379 diff changeset	186 private-method E1366
33025 1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	187 If you want object methods to be accessible only from other methods of the
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	188 same class and not used from outside the class, then you can make them
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	189 private. This is done by prefixing the method name with an underscore: >
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	190
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	191 class SomeClass
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	192 def _Foo(): number
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	193 return 10
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	194 enddef
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	195 def Bar(): number
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	196 return this._Foo()
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	197 enddef
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	198 endclass
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	199 <
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	200 Accessing a private method outside the class will result in an error (using
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	201 the above class): >
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	202
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	203 var a = SomeClass.new()
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	204 a._Foo()
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	205 <
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	206 Simplifying the new() method ~
33383 5c12ca4dcd45 patch 9.0.1950: Vim9: error codes spread out Christian Brabandt <cb@256bit.org> parents: 33379 diff changeset	207 new() constructor
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	208 Many constructors take values for the object variables. Thus you very often
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	209 see this pattern: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	210
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	211 class SomeClass
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	212 this.lnum: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	213 this.col: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	214
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	215 def new(lnum: number, col: number)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	216 this.lnum = lnum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	217 this.col = col
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	218 enddef
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	219 endclass
33379 7c9124711f99 patch 9.0.1948: Vim9: object variable "this." should only be used in constructor Christian Brabandt <cb@256bit.org> parents: 33372 diff changeset	220 <
7c9124711f99 patch 9.0.1948: Vim9: object variable "this." should only be used in constructor Christian Brabandt <cb@256bit.org> parents: 33372 diff changeset	221 E1390
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	222 Not only is this text you need to write, it also has the type of each
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	223 variables twice. Since this is so common a shorter way to write new() is
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	224 provided: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	225
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	226 def new(this.lnum, this.col)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	227 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	228
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	229 The semantics are easy to understand: Providing the object variable name,
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	230 including "this.", as the argument to new() means the value provided in the
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	231 new() call is assigned to that object variable. This mechanism comes from the
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	232 Dart language.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	233
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	234 Putting together this way of using new() and making the variables public
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	235 results in a much shorter class definition than what we started with: >
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	236
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	237 class TextPosition
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	238 public this.lnum: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	239 public this.col: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	240
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	241 def new(this.lnum, this.col)
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	242 enddef
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	243
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	244 def SetPosition(lnum: number, col: number)
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	245 this.lnum = lnum
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	246 this.col = col
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	247 enddef
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	248 endclass
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	249
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	250 The sequence of constructing a new object is:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	251 1. Memory is allocated and cleared. All values are zero/false/empty.
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	252 2. For each declared object variable that has an initializer, the expression
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	253 is evaluated and assigned to the variable. This happens in the sequence
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	254 the variables are declared in the class.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	255 3. Arguments in the new() method in the "this.name" form are assigned.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	256 4. The body of the new() method is executed.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	257
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	258 If the class extends a parent class, the same thing happens. In the second
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	259 step the object variables of the parent class are initialized first. There is
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	260 no need to call "super()" or "new()" on the parent.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	261
33385 b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	262 E1365
32903 54c01bb98b8e patch 9.0.1760: vim9 class problem with new() constructor Christian Brabandt <cb@256bit.org> parents: 32294 diff changeset	263 When defining the new() method the return type should not be specified. It
54c01bb98b8e patch 9.0.1760: vim9 class problem with new() constructor Christian Brabandt <cb@256bit.org> parents: 32294 diff changeset	264 always returns an object of the class.
54c01bb98b8e patch 9.0.1760: vim9 class problem with new() constructor Christian Brabandt <cb@256bit.org> parents: 32294 diff changeset	265
33385 b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	266 E1386
b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	267 When invoking an object method, the method name should be preceded by the
b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	268 object variable name. A object method cannot be invoked using the class
b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	269 name.
b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	270
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	271 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	272
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	273 3. Class Variables and Methods Vim9-class-member
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	274
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	275 :static E1337 E1338 E1368
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	276 Class members are declared with "static". They are used by the name without a
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	277 prefix in the class where they are defined: >
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	278
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	279 class OtherThing
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	280 this.size: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	281 static totalSize: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	282
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	283 def new(this.size)
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	284 totalSize += this.size
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	285 enddef
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	286 endclass
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	287 < E1340 E1341
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	288 Since the name is used as-is, shadowing the name by a method argument name
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	289 or local variable name is not allowed.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	290
33385 b5ad84fdc702 patch 9.0.1951: Vim9: hard to debug vim9_class errors from CI Christian Brabandt <cb@256bit.org> parents: 33383 diff changeset	291 E1374 E1375 E1384 E1385
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	292 To access a class member outside of the class where it is defined, the class
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	293 name prefix must be used. A class member cannot be accessed using an object.
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	294
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	295 Just like object members the access can be made private by using an underscore
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	296 as the first character in the name, and it can be made public by prefixing
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	297 "public": >
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	298
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	299 class OtherThing
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	300 static total: number # anybody can read, only class can write
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	301 static _sum: number # only class can read and write
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	302 public static result: number # anybody can read and write
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	303 endclass
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	304 <
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	305 class-method
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	306 Class methods are also declared with "static". They can use the class
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	307 variables but they have no access to the object variables, they cannot use the
33434 484543479bd7 runtime(doc): fix typos. Christian Brabandt <cb@256bit.org> parents: 33432 diff changeset	308 "this" keyword:
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	309 >
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	310 class OtherThing
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	311 this.size: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	312 static totalSize: number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	313
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	314 # Clear the total size and return the value it had before.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	315 static def ClearTotalSize(): number
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	316 var prev = totalSize
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	317 totalSize = 0
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	318 return prev
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	319 enddef
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	320 endclass
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	321
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	322 Inside the class the class method can be called by name directly, outside the
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	323 class the class name must be prefixed: `OtherThing.ClearTotalSize()`. To use
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	324 a super class method in a child class, the class name must be prefixed.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	325
33025 1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	326 Just like object methods the access can be made private by using an underscore
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	327 as the first character in the method name: >
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	328
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	329 class OtherThing
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	330 static def _Foo()
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	331 echo "Foo"
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	332 enddef
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	333 def Bar()
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	334 _Foo()
33025 1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	335 enddef
1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	336 endclass
33068 d42927c6e556 patch 9.0.1821: Vim9 constructors are always static Christian Brabandt <cb@256bit.org> parents: 33025 diff changeset	337 <
d42927c6e556 patch 9.0.1821: Vim9 constructors are always static Christian Brabandt <cb@256bit.org> parents: 33025 diff changeset	338 E1370
d42927c6e556 patch 9.0.1821: Vim9 constructors are always static Christian Brabandt <cb@256bit.org> parents: 33025 diff changeset	339 Note that constructors cannot be declared as "static", because they always
d42927c6e556 patch 9.0.1821: Vim9 constructors are always static Christian Brabandt <cb@256bit.org> parents: 33025 diff changeset	340 are.
33025 1d18c7fe609f patch 9.0.1804: Vim9: no support for private object methods Christian Brabandt <cb@256bit.org> parents: 32960 diff changeset	341
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	342 To access the class methods and class variables of a super class in an
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	343 extended class, the class name prefix should be used just as from anywhere
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	344 outside of the defining class: >
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	345
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	346 vim9script
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	347 class Vehicle
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	348 static nextID: number = 1000
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	349 static def GetID(): number
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	350 nextID += 1
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	351 return nextID
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	352 enddef
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	353 endclass
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	354 class Car extends Vehicle
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	355 this.myID: number
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	356 def new()
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	357 this.myID = Vehicle.GetID()
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	358 enddef
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	359 endclass
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	360 <
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	361 Class variables and methods are not inherited by a child class. A child class
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	362 can declare a static variable or a method with the same name as the one in the
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	363 super class. Depending on the class where the member is used the
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	364 corresponding class member will be used. The type of the class member in a
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	365 child class can be different from that in the super class.
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	366
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	367 ==============================================================================
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	368
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	369 4. Using an abstract class Vim9-abstract-class
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	370
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	371 An abstract class forms the base for at least one sub-class. In the class
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	372 model one often finds that a few classes have the same properties that can be
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	373 shared, but a class with these properties does not have enough state to create
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	374 an object from. A sub-class must extend the abstract class and add the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	375 missing state and/or methods before it can be used to create objects for.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	376
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	377 For example, a Shape class could store a color and thickness. You cannot
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	378 create a Shape object, it is missing the information about what kind of shape
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	379 it is. The Shape class functions as the base for a Square and a Triangle
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	380 class, for which objects can be created. Example: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	381
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	382 abstract class Shape
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	383 this.color = Color.Black
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	384 this.thickness = 10
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	385 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	386
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	387 class Square extends Shape
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	388 this.size: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	389
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	390 def new(this.size)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	391 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	392 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	393
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	394 class Triangle extends Shape
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	395 this.base: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	396 this.height: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	397
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	398 def new(this.base, this.height)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	399 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	400 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	401 <
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	402 An abstract class is defined the same way as a normal class, except that it
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	403 does not have any new() method. E1359
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	404
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	405 abstract-method E1371 E1372
33217 499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	406 An abstract method can be defined in an abstract class by using the "abstract"
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	407 prefix when defining the method: >
33217 499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	408
499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	409 abstract class Shape
499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	410 abstract def Draw()
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	411 abstract static def SetColor()
33217 499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	412 endclass
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	413 <
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	414 E1373
33217 499ba27ba0f6 patch 9.0.1885: Vim9: no support for abstract methods Christian Brabandt <cb@256bit.org> parents: 33068 diff changeset	415 A class extending the abstract class must implement all the abstract methods.
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	416 The signature (arguments, argument types and return type) must be exactly the
33490 33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	417 same. If the return type of a method is a class, then that class or one of
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	418 its subclasses can be used in the extended method. Class methods in an
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	419 abstract class can also be abstract methods.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	420
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	421 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	422
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	423 5. Using an interface Vim9-using-interface
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	424
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	425 The example above with Shape, Square and Triangle can be made more useful if
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	426 we add a method to compute the surface of the object. For that we create the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	427 interface called HasSurface, which specifies one method Surface() that returns
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	428 a number. This example extends the one above: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	429
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	430 abstract class Shape
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	431 this.color = Color.Black
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	432 this.thickness = 10
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	433 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	434
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	435 interface HasSurface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	436 def Surface(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	437 endinterface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	438
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	439 class Square extends Shape implements HasSurface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	440 this.size: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	441
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	442 def new(this.size)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	443 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	444
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	445 def Surface(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	446 return this.size * this.size
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	447 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	448 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	449
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	450 class Triangle extends Shape implements HasSurface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	451 this.base: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	452 this.height: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	453
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	454 def new(this.base, this.height)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	455 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	456
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	457 def Surface(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	458 return this.base * this.height / 2
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	459 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	460 endclass
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	461 <
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	462 E1348 E1349 E1367 E1382 E1383
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	463 If a class declares to implement an interface, all the items specified in the
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	464 interface must appear in the class, with the same types.
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	465
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	466 The interface name can be used as a type: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	467
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	468 var shapes: list<HasSurface> = [
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	469 Square.new(12),
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	470 Triangle.new(8, 15),
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	471 ]
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	472 for shape in shapes
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	473 echo $'the surface is {shape.Surface()}'
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	474 endfor
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	475 <
33372 3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	476 E1378 E1379 E1380 E1387
3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	477 An interface can contain only object methods and read-only object variables.
3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	478 An interface cannot contain read-write and private object variables, private
3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	479 object methods, class variables and class methods.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	480
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	481 An interface can extend another interface using "extends". The sub-interface
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	482 inherits all the instance variables and methods from the super interface.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	483
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	484 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	485
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	486 6. More class details Vim9-class Class class
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	487
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	488 Defining a class ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	489 :class :endclass :abstract
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	490 A class is defined between `:class` and `:endclass`. The whole class is
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	491 defined in one script file. It is not possible to add to a class later.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	492
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	493 A class can only be defined in a \|Vim9\| script file. E1316
31396 307f68a41b03 patch 9.0.1031: Vim9 class is not implemented yet Bram Moolenaar <Bram@vim.org> parents: 31335 diff changeset	494 A class cannot be defined inside a function.
307f68a41b03 patch 9.0.1031: Vim9 class is not implemented yet Bram Moolenaar <Bram@vim.org> parents: 31335 diff changeset	495
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	496 It is possible to define more than one class in a script file. Although it
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	497 usually is better to export only one main class. It can be useful to define
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	498 types, enums and helper classes though.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	499
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	500 The `:abstract` keyword may be prefixed and `:export` may be used. That gives
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	501 these variants: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	502
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	503 class ClassName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	504 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	505
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	506 export class ClassName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	507 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	508
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	509 abstract class ClassName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	510 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	511
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	512 export abstract class ClassName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	513 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	514 <
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	515 E1314
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	516 The class name should be CamelCased. It must start with an uppercase letter.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	517 That avoids clashing with builtin types.
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	518 E1315
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	519 After the class name these optional items can be used. Each can appear only
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	520 once. They can appear in any order, although this order is recommended: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	521 extends ClassName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	522 implements InterfaceName, OtherInterface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	523 specifies SomeInterface
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	524 < E1355 E1369
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	525 Each variable and method name can be used only once. It is not possible to
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	526 define a method with the same name and different type of arguments. It is not
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	527 possible to use a public and private member variable with the same name. A
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	528 object variable name used in a super class cannot be reused in a child class.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	529
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	530
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	531 Object Variable Initialization ~
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	532 If the type of a variable is not explicitly specified in a class, then it is
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	533 set to "any" during class definition. When an object is instantiated from the
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	534 class, then the type of the variable is set.
32960 d5c05e15cf81 patch 9.0.1780: Vim9 type not defined during object creation Christian Brabandt <cb@256bit.org> parents: 32903 diff changeset	535
33401 bb99820510ef patch 9.0.1959: Vim9: methods parameters and types are covariant Christian Brabandt <cb@256bit.org> parents: 33385 diff changeset	536 The following reserved keyword names cannot be used as an object or class
bb99820510ef patch 9.0.1959: Vim9: methods parameters and types are covariant Christian Brabandt <cb@256bit.org> parents: 33385 diff changeset	537 variable name: "super", "this", "true", "false", "null", "null_blob",
bb99820510ef patch 9.0.1959: Vim9: methods parameters and types are covariant Christian Brabandt <cb@256bit.org> parents: 33385 diff changeset	538 "null_dict", "null_function", "null_list", "null_partial", "null_string",
bb99820510ef patch 9.0.1959: Vim9: methods parameters and types are covariant Christian Brabandt <cb@256bit.org> parents: 33385 diff changeset	539 "null_channel" and "null_job".
32960 d5c05e15cf81 patch 9.0.1780: Vim9 type not defined during object creation Christian Brabandt <cb@256bit.org> parents: 32903 diff changeset	540
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	541 Extending a class ~
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	542 extends
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	543 A class can extend one other class. E1352 E1353 E1354
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	544 The basic idea is to build on top of an existing class, add properties to it.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	545
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	546 The extended class is called the "base class" or "super class". The new class
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	547 is called the "child class".
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	548
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	549 Object variables from the base class are all taken over by the child class. It
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	550 is not possible to override them (unlike some other languages).
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	551
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	552 E1356 E1357 E1358
33432 97ceabebaeaf patch 9.0.1974: vim9: using contra-variant type-checks Christian Brabandt <cb@256bit.org> parents: 33401 diff changeset	553 Object methods of the base class can be overruled. The signature (arguments,
33490 33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	554 argument types and return type) must be exactly the same. If the return type
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	555 of a method is a class, then that class or one of its subclasses can be used
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	556 in the extended method. The method of the base class can be called by
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	557 prefixing "super.".
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	558
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	559 E1377
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	560 The access level of a method (public or private) in a child class should be
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	561 the same as the super class.
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	562
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	563 Other object methods of the base class are taken over by the child class.
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	564
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	565 Class methods, including methods starting with "new", can be overruled, like
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	566 with object methods. The method on the base class can be called by prefixing
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	567 the name of the class (for class methods) or "super.".
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	568
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	569 Unlike other languages, the constructor of the base class does not need to be
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	570 invoked. In fact, it cannot be invoked. If some initialization from the base
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	571 class also needs to be done in a child class, put it in an object method and
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	572 call that method from every constructor().
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	573
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	574 If the base class did not specify a new() method then one was automatically
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	575 created. This method will not be taken over by the child class. The child
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	576 class can define its own new() method, or, if there isn't one, a new() method
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	577 will be added automatically.
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	578
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	579
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	580 A class implementing an interface ~
33372 3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	581 implements E1346 E1347 E1389
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	582 A class can implement one or more interfaces. The "implements" keyword can
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	583 only appear once E1350 . Multiple interfaces can be specified, separated by
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	584 commas. Each interface name can appear only once. E1351
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	585
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	586
cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	587 A class defining an interface ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	588 specifies
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	589 A class can declare its interface, the object variables and methods, with a
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	590 named interface. This avoids the need for separately specifying the
31396 307f68a41b03 patch 9.0.1031: Vim9 class is not implemented yet Bram Moolenaar <Bram@vim.org> parents: 31335 diff changeset	591 interface, which is often done in many languages, especially Java.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	592
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	593
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	594 Items in a class ~
33372 3e9a91624b40 patch 9.0.1945: Vim9: missing support for ro-vars in interface Christian Brabandt <cb@256bit.org> parents: 33351 diff changeset	595 E1318 E1325 E1388
32061 b2412874362f Update runtime files Bram Moolenaar <Bram@vim.org> parents: 32004 diff changeset	596 Inside a class, in between `:class` and `:endclass`, these items can appear:
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	597 - An object variable declaration: >
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	598 this._privateVariableName: memberType
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	599 this.readonlyVariableName: memberType
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	600 public this.readwriteVariableName: memberType
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	601 - A class variable declaration: >
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	602 static _privateClassVariableName: memberType
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	603 static readonlyClassVariableName: memberType
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	604 static public readwriteClassVariableName: memberType
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	605 - A constructor method: >
32004 a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	606 def new(arguments)
a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	607 def newName(arguments)
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	608 - A class method: >
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	609 static def SomeMethod(arguments)
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	610 static def _PrivateMethod(arguments)
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	611 - An object method: >
32004 a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	612 def SomeMethod(arguments)
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	613 def _PrivateMethod(arguments)
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	614
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	615 For the object variable the type must be specified. The best way is to do
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	616 this explicitly with ": {type}". For simple types you can also use an
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	617 initializer, such as "= 123", and Vim will see that the type is a number.
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	618 Avoid doing this for more complex types and when the type will be incomplete.
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	619 For example: >
31579 7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	620 this.nameList = []
7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	621 This specifies a list, but the item type is unknown. Better use: >
7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	622 this.nameList: list<string>
7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	623 The initialization isn't needed, the list is empty by default.
7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	624 E1330
7d68a90cbf5c Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31441 diff changeset	625 Some types cannot be used, such as "void", "null" and "v:none".
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	626
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	627
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	628 Defining an interface ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	629 :interface :endinterface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	630 An interface is defined between `:interface` and `:endinterface`. It may be
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	631 prefixed with `:export`: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	632
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	633 interface InterfaceName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	634 endinterface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	635
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	636 export interface InterfaceName
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	637 endinterface
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	638 < E1344
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	639 An interface can declare object variables, just like in a class but without
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	640 any initializer.
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	641 E1345
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	642 An interface can declare methods with `:def`, including the arguments and
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	643 return type, but without the body and without `:enddef`. Example: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	644
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	645 interface HasSurface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	646 this.size: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	647 def Surface(): number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	648 endinterface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	649
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	650 An interface name must start with an uppercase letter. E1343
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	651 The "Has" prefix can be used to make it easier to guess this is an interface
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	652 name, with a hint about what it provides.
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	653 An interface can only be defined in a \|Vim9\| script file. E1342
33286 0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	654 An interface cannot "implement" another interface but it can "extend" another
0c3553cfe22e patch 9.0.1909: Vim9: problem calling class method from other class Christian Brabandt <cb@256bit.org> parents: 33217 diff changeset	655 interface. E1381
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	656
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	657
32004 a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	658 null object ~
a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	659
32061 b2412874362f Update runtime files Bram Moolenaar <Bram@vim.org> parents: 32004 diff changeset	660 When a variable is declared to have the type of an object, but it is not
32004 a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	661 initialized, the value is null. When trying to use this null object Vim often
a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	662 does not know what class was supposed to be used. Vim then cannot check if
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	663 a variable name is correct and you will get an "Using a null object" error,
33434 484543479bd7 runtime(doc): fix typos. Christian Brabandt <cb@256bit.org> parents: 33432 diff changeset	664 even when the variable name is invalid. E1360 E1362
32004 a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	665
a9b5ffbc0428 Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31885 diff changeset	666
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	667 Default constructor ~
33383 5c12ca4dcd45 patch 9.0.1950: Vim9: error codes spread out Christian Brabandt <cb@256bit.org> parents: 33379 diff changeset	668 default-constructor
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	669 In case you define a class without a new() method, one will be automatically
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	670 defined. This default constructor will have arguments for all the object
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	671 variables, in the order they were specified. Thus if your class looks like: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	672
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	673 class AutoNew
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	674 this.name: string
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	675 this.age: number
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	676 this.gender: Gender
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	677 endclass
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	678
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	679 Then the default constructor will be: >
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	680
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	681 def new(this.name = v:none, this.age = v:none, this.gender = v:none)
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	682 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	683
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	684 The "= v:none" default values make the arguments optional. Thus you can also
e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	685 call `new()` without any arguments. No assignment will happen and the default
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	686 value for the object variables will be used. This is a more useful example,
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	687 with default values: >
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	688
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	689 class TextPosition
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	690 this.lnum: number = 1
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	691 this.col: number = 1
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	692 endclass
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	693
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	694 If you want the constructor to have mandatory arguments, you need to write it
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	695 yourself. For example, if for the AutoNew class above you insist on getting
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	696 the name, you can define the constructor like this: >
e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	697
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	698 def new(this.name, this.age = v:none, this.gender = v:none)
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	699 enddef
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	700 < E1328
e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	701 Note that you cannot use another default value than "v:none" here. If you
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	702 want to initialize the object variables, do it where they are declared. This
31441 e572ff386670 patch 9.0.1053: default constructor arguments are not optional Bram Moolenaar <Bram@vim.org> parents: 31430 diff changeset	703 way you only need to look in one place for the default values.
31430 e5e95e8c78a7 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31396 diff changeset	704
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	705 All object variables will be used in the default constructor, also private
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	706 access ones.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	707
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	708 If the class extends another one, the object variables of that class will come
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	709 first.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	710
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	711
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	712 Multiple constructors ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	713
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	714 Normally a class has just one new() constructor. In case you find that the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	715 constructor is often called with the same arguments you may want to simplify
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	716 your code by putting those arguments into a second constructor method. For
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	717 example, if you tend to use the color black a lot: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	718
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	719 def new(this.garment, this.color, this.size)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	720 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	721 ...
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	722 var pants = new(Garment.pants, Color.black, "XL")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	723 var shirt = new(Garment.shirt, Color.black, "XL")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	724 var shoes = new(Garment.shoes, Color.black, "45")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	725
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	726 Instead of repeating the color every time you can add a constructor that
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	727 includes it: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	728
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	729 def newBlack(this.garment, this.size)
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	730 this.color = Color.black
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	731 enddef
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	732 ...
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	733 var pants = newBlack(Garment.pants, "XL")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	734 var shirt = newBlack(Garment.shirt, "XL")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	735 var shoes = newBlack(Garment.shoes, "9.5")
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	736
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	737 Note that the method name must start with "new". If there is no method called
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	738 "new()" then the default constructor is added, even though there are other
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	739 constructor methods.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	740
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	741
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	742 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	743
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	744 7. Type definition Vim9-type :type
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	745
33678 7d9d2404a3d4 patch 9.0.2076: Vim9: No support for type aliases Christian Brabandt <cb@256bit.org> parents: 33636 diff changeset	746 A type definition is giving a name to a type specification. This also known
7d9d2404a3d4 patch 9.0.2076: Vim9: No support for type aliases Christian Brabandt <cb@256bit.org> parents: 33636 diff changeset	747 type alias. For Example: >
33490 33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	748
33678 7d9d2404a3d4 patch 9.0.2076: Vim9: No support for type aliases Christian Brabandt <cb@256bit.org> parents: 33636 diff changeset	749 :type ListOfStrings = list<string>
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	750
33678 7d9d2404a3d4 patch 9.0.2076: Vim9: No support for type aliases Christian Brabandt <cb@256bit.org> parents: 33636 diff changeset	751 The type alias can be used wherever a built-in type can be used. The type
7d9d2404a3d4 patch 9.0.2076: Vim9: No support for type aliases Christian Brabandt <cb@256bit.org> parents: 33636 diff changeset	752 alias name must start with an upper case character.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	753
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	754 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	755
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	756 8. Enum Vim9-enum :enum :endenum
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	757
33490 33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	758 {not implemented yet}
33593174288b runtime(doc): Update vim9class help (#13292) Christian Brabandt <cb@256bit.org> parents: 33434 diff changeset	759
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	760 An enum is a type that can have one of a list of values. Example: >
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	761
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	762 :enum Color
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	763 White
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	764 Red
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	765 Green
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	766 Blue
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	767 Black
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	768 :endenum
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	769
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	770
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	771 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	772
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	773 9. Rationale
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	774
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	775 Most of the choices for \|Vim9\| classes come from popular and recently
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	776 developed languages, such as Java, TypeScript and Dart. The syntax has been
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	777 made to fit with the way Vim script works, such as using `endclass` instead of
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	778 using curly braces around the whole class.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	779
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	780 Some common constructs of object-oriented languages were chosen very long ago
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	781 when this kind of programming was still new, and later found to be
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	782 sub-optimal. By this time those constructs were widely used and changing them
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	783 was not an option. In Vim we do have the freedom to make different choices,
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	784 since classes are completely new. We can make the syntax simpler and more
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	785 consistent than what "old" languages use. Without diverting too much, it
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	786 should still mostly look like what you know from existing languages.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	787
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	788 Some recently developed languages add all kinds of fancy features that we
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	789 don't need for Vim. But some have nice ideas that we do want to use.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	790 Thus we end up with a base of what is common in popular languages, dropping
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	791 what looks like a bad idea, and adding some nice features that are easy to
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	792 understand.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	793
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	794 The main rules we use to make decisions:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	795 - Keep it simple.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	796 - No surprises, mostly do what other languages are doing.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	797 - Avoid mistakes from the past.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	798 - Avoid the need for the script writer to consult the help to understand how
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	799 things work, most things should be obvious.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	800 - Keep it consistent.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	801 - Aim at an average size plugin, not at a huge project.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	802
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	803
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	804 Using new() for the constructor ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	805
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	806 Many languages use the class name for the constructor method. A disadvantage
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	807 is that quite often this is a long name. And when changing the class name all
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	808 constructor methods need to be renamed. Not a big deal, but still a
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	809 disadvantage.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	810
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	811 Other languages, such as TypeScript, use a specific name, such as
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	812 "constructor()". That seems better. However, using "new" or "new()" to
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	813 create a new object has no obvious relation with "constructor()".
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	814
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	815 For \|Vim9\| script using the same method name for all constructors seemed like
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	816 the right choice, and by calling it new() the relation between the caller and
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	817 the method being called is obvious.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	818
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	819
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	820 No overloading of the constructor ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	821
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	822 In Vim script, both legacy and \|Vim9\| script, there is no overloading of
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	823 methods. That means it is not possible to use the same method name with
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	824 different types of arguments. Therefore there also is only one new()
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	825 constructor.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	826
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	827 With \|Vim9\| script it would be possible to support overloading, since
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	828 arguments are typed. However, this gets complicated very quickly. Looking at
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	829 a new() call one has to inspect the types of the arguments to know which of
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	830 several new() methods is actually being called. And that can require
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	831 inspecting quite a bit of code. For example, if one of the arguments is the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	832 return value of a method, you need to find that method to see what type it is
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	833 returning.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	834
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	835 Instead, every constructor has to have a different name, starting with "new".
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	836 That way multiple constructors with different arguments are possible, while it
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	837 is very easy to see which constructor is being used. And the type of
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	838 arguments can be properly checked.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	839
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	840
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	841 No overloading of methods ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	842
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	843 Same reasoning as for the constructor: It is often not obvious what type
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	844 arguments have, which would make it difficult to figure out what method is
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	845 actually being called. Better just give the methods a different name, then
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	846 type checking will make sure it works as you intended. This rules out
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	847 polymorphism, which we don't really need anyway.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	848
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	849
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	850 Single inheritance and interfaces ~
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	851
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	852 Some languages support multiple inheritance. Although that can be useful in
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	853 some cases, it makes the rules of how a class works quite complicated.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	854 Instead, using interfaces to declare what is supported is much simpler. The
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	855 very popular Java language does it this way, and it should be good enough for
31885 cc751d944b7e Update runtime files. Bram Moolenaar <Bram@vim.org> parents: 31671 diff changeset	856 Vim. The "keep it simple" rule applies here.
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	857
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	858 Explicitly declaring that a class supports an interface makes it easy to see
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	859 what a class is intended for. It also makes it possible to do proper type
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	860 checking. When an interface is changed any class that declares to implement
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	861 it will be checked if that change was also changed. The mechanism to assume a
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	862 class implements an interface just because the methods happen to match is
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	863 brittle and leads to obscure problems, let's not do that.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	864
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	865
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	866 Using "this.variable" everywhere ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	867
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	868 The object variables in various programming languages can often be accessed in
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	869 different ways, depending on the location. Sometimes "this." has to be
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	870 prepended to avoid ambiguity. They are usually declared without "this.".
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	871 That is quite inconsistent and sometimes confusing.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	872
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	873 A very common issue is that in the constructor the arguments use the same name
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	874 as the object variable. Then for these variables "this." needs to be prefixed
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	875 in the body, while for other variables this is not needed and often omitted.
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	876 This leads to a mix of variables with and without "this.", which is
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	877 inconsistent.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	878
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	879 For \|Vim9\| classes the "this." prefix is always used. Also for declaring the
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	880 variables. Simple and consistent. When looking at the code inside a class
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	881 it's also directly clear which variable references are object variables and
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	882 which aren't.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	883
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	884
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	885 Using class variables ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	886
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	887 Using "static variable" to declare a class variable is very common, nothing
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	888 new here. In \|Vim9\| script these can be accessed directly by their name.
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	889 Very much like how a script-local variable can be used in a method. Since
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	890 object variables are always accessed with "this." prepended, it's also quickly
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	891 clear what kind of variable it is.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	892
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	893 TypeScript prepends the class name before the class variable name, also inside
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	894 the class. This has two problems: The class name can be rather long, taking
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	895 up quite a bit of space, and when the class is renamed all these places need
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	896 to be changed too.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	897
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	898
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	899 Declaring object and class variables ~
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	900
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	901 The main choice is whether to use "var" as with variable declarations.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	902 TypeScript does not use it: >
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	903 class Point {
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	904 x: number;
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	905 y = 0;
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	906 }
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	907
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	908 Following that Vim object variables could be declared like this: >
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	909 class Point
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	910 this.x: number
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	911 this.y = 0
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	912 endclass
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	913
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	914 Some users pointed out that this looks more like an assignment than a
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	915 declaration. Adding "var" changes that: >
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	916 class Point
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	917 var this.x: number
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	918 var this.y = 0
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	919 endclass
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	920
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	921 We also need to be able to declare class variables using the "static" keyword.
31671 5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	922 There we can also choose to leave out "var": >
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	923 class Point
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	924 var this.x: number
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	925 static count = 0
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	926 endclass
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	927
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	928 Or do use it, before "static": >
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	929 class Point
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	930 var this.x: number
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	931 var static count = 0
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	932 endclass
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	933
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	934 Or after "static": >
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	935 class Point
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	936 var this.x: number
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	937 static var count = 0
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	938 endclass
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	939
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	940 This is more in line with "static def Func()".
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	941
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	942 There is no clear preference whether to use "var" or not. The two main
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	943 reasons to leave it out are:
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	944 1. TypeScript, Java and other popular languages do not use it.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	945 2. Less clutter.
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	946
5ed19049b1e8 Update runtime files Bram Moolenaar <Bram@vim.org> parents: 31579 diff changeset	947
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	948 Using "ClassName.new()" to construct an object ~
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	949
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	950 Many languages use the "new" operator to create an object, which is actually
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	951 kind of strange, since the constructor is defined as a method with arguments,
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	952 not a command. TypeScript also has the "new" keyword, but the method is
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	953 called "constructor()", it is hard to see the relation between the two.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	954
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	955 In \|Vim9\| script the constructor method is called new(), and it is invoked as
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	956 new(), simple and straightforward. Other languages use "new ClassName()",
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	957 while there is no ClassName() method, it's a method by another name in the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	958 class called ClassName. Quite confusing.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	959
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	960
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	961 Default read access to object variables ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	962
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	963 Some users will remark that the access rules for object variables are
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	964 asymmetric. Well, that is intentional. Changing a value is a very different
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	965 action than reading a value. The read operation has no side effects, it can
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	966 be done any number of times without affecting the object. Changing the value
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	967 can have many side effects, and even have a ripple effect, affecting other
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	968 objects.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	969
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	970 When adding object variables one usually doesn't think much about this, just
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	971 get the type right. And normally the values are set in the new() method.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	972 Therefore defaulting to read access only "just works" in most cases. And when
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	973 directly writing you get an error, which makes you wonder if you actually want
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	974 to allow that. This helps writing code with fewer mistakes.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	975
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	976
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	977 Making object variables private with an underscore ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	978
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	979 When an object variable is private, it can only be read and changed inside the
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	980 class (and in sub-classes), then it cannot be used outside of the class.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	981 Prepending an underscore is a simple way to make that visible. Various
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	982 programming languages have this as a recommendation.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	983
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	984 In case you change your mind and want to make the object variable accessible
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	985 outside of the class, you will have to remove the underscore everywhere.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	986 Since the name only appears in the class (and sub-classes) they will be easy
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	987 to find and change.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	988
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	989 The other way around is much harder: you can easily prepend an underscore to
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	990 the object variable inside the class to make it private, but any usage
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	991 elsewhere you will have to track down and change. You may have to make it a
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	992 "set" method call. This reflects the real world problem that taking away
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	993 access requires work to be done for all places where that access exists.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	994
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	995 An alternative would have been using the "private" keyword, just like "public"
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	996 changes the access in the other direction. Well, that's just to reduce the
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	997 number of keywords.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	998
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	999
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	1000 No protected object variables ~
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1001
33351 a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	1002 Some languages provide several ways to control access to object variables.
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	1003 The most known is "protected", and the meaning varies from language to
a3bbd065fb87 runtime(doc): Vim9: Consistenly use class/object variable and class/object method in help (#13149) Christian Brabandt <cb@256bit.org> parents: 33286 diff changeset	1004 language. Others are "shared", "private" and even "friend".
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1005
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1006 These rules make life more difficult. That can be justified in projects where
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1007 many people work on the same, complex code where it is easy to make mistakes.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1008 Especially when refactoring or other changes to the class model.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1009
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1010 The Vim scripts are expected to be used in a plugin, with just one person or a
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1011 small team working on it. Complex rules then only make it more complicated,
32294 b2e8663e6dcc Update runtime files Bram Moolenaar <Bram@vim.org> parents: 32061 diff changeset	1012 the extra safety provided by the rules isn't really needed. Let's just keep
b2e8663e6dcc Update runtime files Bram Moolenaar <Bram@vim.org> parents: 32061 diff changeset	1013 it simple and not specify access details.
31335 5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1014
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1015
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1016 ==============================================================================
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1017
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1018 10. To be done later
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1019
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1020 Can a newSomething() constructor invoke another constructor? If yes, what are
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1021 the restrictions?
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1022
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1023 Thoughts:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1024 - Generics for a class: `class <Tkey, Tentry>`
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1025 - Generics for a function: `def <Tkey> GetLast(key: Tkey)`
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1026 - Mixins: not sure if that is useful, leave out for simplicity.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1027
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1028 Some things that look like good additions:
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1029 - For testing: Mock mechanism
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1030
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1031 An important class to be provided is "Promise". Since Vim is single
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1032 threaded, connecting asynchronous operations is a natural way of allowing
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1033 plugins to do their work without blocking the user. It's a uniform way to
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1034 invoke callbacks and handle timeouts and errors.
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1035
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1036
5acc0d2cf4f7 patch 9.0.1001: classes are not documented or implemented yet Bram Moolenaar <Bram@vim.org> parents: diff changeset	1037 vim:tw=78:ts=8:noet:ft=help:norl:

Mercurial > vim

annotate runtime/doc/vim9class.txt @ 33678:7d9d2404a3d4 v9.0.2076