Datatype Editor/en - Versionsgeschichte

Sv: Änderung übernommen aus altem Wiki von cg, 16.2.26

2026-02-23T10:40:42Z

Änderung übernommen aus altem Wiki von cg, 16.2.26

← Nächstältere Version		Version vom 23. Februar 2026, 10:40 Uhr
Zeile 34:		Zeile 34:

	===Primary Types===		===Primary Types===
	These are builtin types (classes) of the underlying Smalltalk execution framework. For example, "<code>String</code>", "<code>Array</code>", "<code>Set</code>", "<code>Btree</code>", "<code>Dictionary</code>" or "<code>Number</code>" to name a few. There are thousands of classes available, but you will usually get along happily with only a few - if at all. However, you might need to know some, when referring to a framework inside expecco's underlying Smalltalk environment.<br>For example, there are packages and classes to support protocols like FTP, HTTP, etc. or to process data, parse special file formats or provide cryptographic operations. Also, some expecco plugins and extensions come bundled with additional useful classes.		These are builtin types (classes) of the underlying Smalltalk execution framework. For example, "<code>String</code>", "<code>Array</code>", "<code>Set</code>", "<code>Btree</code>", "<code>Dictionary</code>" or "<code>Number</code>" to name a few. There are thousands of classes available, but you will usually get along happily with only a few - if at all. However, you might need to know some, when referring to a framework inside expecco's underlying Smalltalk environment.<br>For example, there are packages and classes to support protocols like FTP, HTTP, etc. or to process data, parse special file formats or provide cryptographic operations. Also, some expecco plugins and extensions come bundled with additional useful classes.<br>These classes usually provide many additional API functions than provided in the standard library (it would be immensly big otherwise).<br>And sometimes you can use these additional functions, so its good to know a little more.

	The most common primary types are shortly listed in the [[Datatype Element \| "Datatype documentation" ]].		The most common primary types are shortly listed in the [[Datatype Element \| "Datatype documentation" ]].
	For more details, please refer to the Smalltalk documentation, especially the [http://live.exept.de/doc/online/english/overview/basicClasses/TOP.html "Basic Classes Introduction"] and the [http://live.exept.de/ClassDoc "Online Class Documentation"] (containing full lists and documentation of all classes~~). You can also open a class browser (found in "''Extras''" → "''Tools''"~~).		For more details, please refer to the Smalltalk documentation, especially the [http://live.exept.de/doc/online/english/overview/basicClasses/TOP.html "Basic Classes Introduction"] and the [http://live.exept.de/ClassDoc "Online Class Documentation"] (containing full lists and documentation of all classes).

			Even better: you can also open a class browser (found in "''Extras''" → "''Tools''") and look at the source code which often includes examples in their method comment.<br>Another useful tool is the "MethodFinder" which lets you find functions which generate a particulal output (i.e. if you know what input you have, and what output you want, but you don't know where to search, this is the tool for you).

	A number of primary types is available directly via the datatype menus, and there is no need to define them as a user type.		A number of primary types is available directly via the datatype menus, and there is no need to define them as a user type.
Zeile 93:		Zeile 95:
	Be aware that enum-typed datums are always string-like objects (actually: instances of Smalltalk's <code>Symbol</code> class). Thus, although the elements look like integers in a definition like "<code>(1 \| 2 \| 3)</code>", they are actually string like with an associated integer. Consider using a subrange or subset type, as described below, if you need integer datums.		Be aware that enum-typed datums are always string-like objects (actually: instances of Smalltalk's <code>Symbol</code> class). Thus, although the elements look like integers in a definition like "<code>(1 \| 2 \| 3)</code>", they are actually string like with an associated integer. Consider using a subrange or subset type, as described below, if you need integer datums.

	Although not recommended, the same numeric value can be assigned to more than one symbol. However, a reverse mapping from numeric value to symbolic is no longer possible.		Although not recommended, the same numeric value can be assigned to more than one symbol. However, a reverse mapping from numeric value to symbolic is then no longer possible.

	===== Enum Definition pasted from a C-Header File =====		===== Enum Definition pasted from a C-Header File =====
Zeile 109:		Zeile 111:
	range( <Character> : $a .. $z )		range( <Character> : $a .. $z )
	</PRE>		</PRE>
	[[Datei:point_right.png\|20px]] Notice the dollar prefix, which designates a character constant.		[[Datei:point_right.png\|20px]] Notice the dollar prefix, which designates a character constant in the Smalltalk language.

	===Subset Types===		===Subset Types===
Zeile 124:		Zeile 126:
	</PRE>		</PRE>

	[[Datei:point_right.png\|20px]] ~~Notice~~ the dollar prefix, which designates a character constant.		[[Datei:point_right.png\|20px]] Again, notice the dollar prefix, which designates a character constant.

	===Pattern Types===		===Pattern Types===
Zeile 161:		Zeile 163:
	Are defined as a homogeneous collection of elements, which are all of the same baseType. The number of elements is variable among instances.		Are defined as a homogeneous collection of elements, which are all of the same baseType. The number of elements is variable among instances.
	The elements are accessible by a numeric index which is 1 based (both for Smalltalk and JavaScript elementary blocks). The standard library also provides 0-based indexing blocks, which is sometimes more convenient for C/Java programmers.		The elements are accessible by a numeric index which is 1 based (both for Smalltalk and JavaScript elementary blocks). The standard library also provides 0-based indexing blocks, which is sometimes more convenient for C/Java programmers.
			<!-- thisis no longer the case
	<br>For compatibility to other JavaScript systems, a few builtin functions behave differently, depending on the language context inside an elementary block's code; most notably, these are the indexOf/lastIndexOf functions.		<br>For compatibility to other JavaScript systems, a few builtin functions behave differently, depending on the language context inside an elementary block's code; most notably, these are the indexOf/lastIndexOf functions.
			-->

	In a textual definition, array types consist of a basetype followed by "[]", as in:		In a textual definition, array types consist of a basetype followed by "[]", as in:
Zeile 171:		Zeile 175:
	<Number>[] -- an array of Numbers		<Number>[] -- an array of Numbers
	</PRE>		</PRE>
			Notice that these are type Arrays, in contrast to the Smalltalk primary Array type, which allows any object as element. Event mixed within one array.

	===Tuple Types===		===Tuple Types===
	Are defined as a non-homogeneous, fixed size vector of elements. Each element has a predefined type. The types may be different among elements, but all instances of the tuple type have the same number of elements and the same type of element at corresponding positions.		Are defined as a non-homogeneous, fixed size vector of elements. Each element has a predefined type. The types may be different among elements, but all instances of the tuple type have the same number of elements and the same type of element at corresponding positions.

	The elements are accessible by index (1..). Tuples are similar to compound types as described below. The difference is that tuples address the elements by index, whereas compounds address them by name. Tuples are also similar to array types, however, the number of elements is fixed in a tuple, whereas arrays can have an arbitrary number of elements, and the element types may be different, ~~whereas~~ in an array, all elements are of the same type.		The elements are accessible by index (1..). Tuples are similar to compound types as described below. The difference is that tuples address the elements by index, whereas compounds address them by name. Tuples are also similar to array types, however, the number of elements is fixed in a tuple, whereas arrays can have an arbitrary number of elements, and the element types may be different if its a primary array or an array of Any), Otherwise in a typed array, all elements are of the same type.

	In a textual description, a tuple is defined by listing the individual element types in parentheses.		In a textual description, a tuple is defined by listing the individual element types in parentheses.

Cg: /* Constraint Datatype Type */

2025-02-18T11:14:21Z

Constraint Datatype Type

← Nächstältere Version		Version vom 18. Februar 2025, 11:14 Uhr
Zeile 328:		Zeile 328:

	Examples:		Examples:
	datatype ( <Integer> ) -- a type whose instances are all datatypes which are compatible with the Integer class		datatype ( Integer ) -- a type whose instances are all datatypes which are compatible with the Integer class
	datatype ( isCTypeType ) -- a type whose instances are all known C-types		datatype ( isCTypeType ) -- a type whose instances are all known C-types
	datatype ( isCStructType ) -- a type representing all known C struct types		datatype ( isCStructType ) -- a type representing all known C struct types

Cg: /* Constraint Datatype Type */

2025-02-18T11:13:35Z

Constraint Datatype Type

← Nächstältere Version		Version vom 18. Februar 2025, 11:13 Uhr
Zeile 328:		Zeile 328:

	Examples:		Examples:
	datatype ( Integer ) -- a type whose instances are all datatypes which are compatible with the Integer class		datatype ( <Integer> ) -- a type whose instances are all datatypes which are compatible with the Integer class
	datatype ( isCTypeType ) -- a type whose instances are all known C-types		datatype ( isCTypeType ) -- a type whose instances are all known C-types
	datatype ( isCStructType ) -- a type representing all known C struct types		datatype ( isCStructType ) -- a type representing all known C struct types

Cg: /* Generating Action Blocks to Access Fields and Create Instances */

2025-02-18T11:12:35Z

Generating Action Blocks to Access Fields and Create Instances

← Nächstältere Version		Version vom 18. Februar 2025, 11:12 Uhr
Zeile 270:		Zeile 270:
	After that, you'll find actions to create an instance, to extract and to set fields.		After that, you'll find actions to create an instance, to extract and to set fields.

	These are elementary actions, which use the above listed getter/setter calls. They can of course be further modified if additional checks or processing is needed. Notice that to access fields of a compound object, you can also use the "Collection [elementAt]" and "Collection [elementAtPut]" actions, using the field names as index.		These are elementary actions, which use the above listed getter/setter calls. They can of course be further modified if additional checks or processing is needed. Notice that to access fields of a compound object, you can also use the "''Collection [elementAt]''" and "''Collection [elementAtPut]''" actions, using the field names as index.

	===Union Types===		===Union Types===

Cg: /* Generating Action Blocks to Access Fields and Create Instances */

2025-02-18T11:12:09Z

Generating Action Blocks to Access Fields and Create Instances

← Nächstältere Version		Version vom 18. Februar 2025, 11:12 Uhr
Zeile 268:		Zeile 268:


	After that, you'll find actions to create an instance, to extract ~~fields~~ and to set fields.		After that, you'll find actions to create an instance, to extract and to set fields.

	These are elementary actions, which use the above listed getter/setter calls. They can of course be further modified if additional checks or processing is needed.		These are elementary actions, which use the above listed getter/setter calls. They can of course be further modified if additional checks or processing is needed. Notice that to access fields of a compound object, you can also use the "Collection [elementAt]" and "Collection [elementAtPut]" actions, using the field names as index.

	===Union Types===		===Union Types===

Cg: /* Setters */

2025-02-18T11:10:28Z

Setters

← Nächstältere Version		Version vom 18. Februar 2025, 11:10 Uhr
Zeile 254:		Zeile 254:
	c.lastName(<I>newValue</I>)		c.lastName(<I>newValue</I>)
	c['lastName'] := <I>newValue</i>		c['lastName'] := <I>newValue</i>
			c["lastName"] := <I>newValue</i>

	==== Generating Action Blocks to Access Fields and Create Instances ====		==== Generating Action Blocks to Access Fields and Create Instances ====

Cg: /* Getters */

2025-02-18T11:10:08Z

Getters

← Nächstältere Version		Version vom 18. Februar 2025, 11:10 Uhr
Zeile 243:		Zeile 243:
	c['lastName'] // using collection protocol		c['lastName'] // using collection protocol
	c["lastName"] // using collection protocol		c["lastName"] // using collection protocol
			Notice, that double quotes in Smalltalk are comment delimiters, whereas in JavaScript they are also string delimiters.

	==== Setters ====		==== Setters ====

Cg: /* Compound Types */

2025-02-18T11:07:38Z

Compound Types

← Nächstältere Version		Version vom 18. Februar 2025, 11:07 Uhr
Zeile 211:		Zeile 211:
	<PRE>		<PRE>
	{		{
	firstame : String		firstame : <String>
	lastName : String		lastName : <String>
	age : Integer		age : <Integer>
	gender : enum(M \| F)		gender : enum(M \| F)
	}		}
Zeile 222:		Zeile 222:
	<PRE>		<PRE>
	{		{
	firstame : String;		firstame : <String>;
	lastName : String;		lastName : <String>;
	age : Integer;		age : <Integer>;
	gender : enum(M \| F);		gender : enum(M \| F);
	}		}

Cg: /* Numeric Value of an Enum */

2025-01-27T15:00:34Z

Numeric Value of an Enum

← Nächstältere Version		Version vom 27. Januar 2025, 15:00 Uhr
Zeile 81:		Zeile 81:

	Elementary code can retrieve this integer value via "<code><type> integerValueOf: x</code>" in Smalltalk,		Elementary code can retrieve this integer value via "<code><type> integerValueOf: x</code>" in Smalltalk,
	or "<code><type>.integerValueOf(x)</code>" in Javascript. There is also a standard library action to retrieve the numeric value ("Convert [Enum-to-Integer]").		or "<code><type>.integerValueOf(x)</code>" in Javascript. There is also a standard library action to retrieve the numeric value ("<code>Convert [Enum-to-Integer]</code>").
	These will return the following integer values:		These will return the following integer values:
	0 (for x = 'foo'), 20 (for x = 'bar'), 21 for (x = 'baz') and 30 (for x = 'bla')		0 (for x = 'foo'), 20 (for x = 'bar'), 21 for (x = 'baz') and 30 (for x = 'bla')
Zeile 88:		Zeile 88:
	"<code><type> symbolicValueOf: x</code>" (Smalltalk),		"<code><type> symbolicValueOf: x</code>" (Smalltalk),
	"<code><type>.symbolicValueOf(x)</code>" (Javascript), or the library action		"<code><type>.symbolicValueOf(x)</code>" (Javascript), or the library action
	"Convert [Integer-to-Enum]".		"<code>Convert [Integer-to-Enum]</code>".

Cg: /* Numeric Value of an Enum */

2025-01-27T14:59:10Z

Numeric Value of an Enum

← Nächstältere Version		Version vom 27. Januar 2025, 14:59 Uhr
Zeile 73:		Zeile 73:

	===== Numeric Value of an Enum =====		===== Numeric Value of an Enum =====
	Enum values can have an associated integer value, which is useful, if the type is actually a mapping of a corresponding C or Java type.<br>For this, add an "<code>= <integerValue></code>" after the element's name to the above definition. ~~I.e~~.:		Enum values can have an associated integer value, which is useful, if the type is actually a mapping of a corresponding C or Java type.<br>For this, add an "<code>= <integerValue></code>" after the element's name to the above definition. Eg.:
	<PRE>		<PRE>
	enum ( foo \| bar = 20 \| baz \| bla = 30 )		enum ( foo \| bar = 20 \| baz \| bla = 30 )