Occurrence (query directive) - Revision history

Olli at 13:48, 29 November 2013

2013-11-29T13:48:16Z

Olli at 13:38, 29 November 2013

2013-11-29T13:38:39Z

Olli at 13:36, 29 November 2013

2013-11-29T13:36:24Z

Olli at 13:32, 29 November 2013

2013-11-29T13:32:45Z

Olli at 13:32, 29 November 2013

2013-11-29T13:32:15Z

Akivela: Occurrence (query directive moved to Occurrence (query directive)

2009-08-26T10:56:54Z

Occurrence (query directive moved to Occurrence (query directive)

Olli at 11:10, 21 August 2009

2009-08-21T11:10:15Z

Olli at 09:36, 21 August 2009

2009-08-21T09:36:29Z

New page

== Description ==

Gets the occurrence with specified type and version from the active column value of input.

== Constructor ==

Occurrence(String type,String version)

== Notes ==

The version is usually one of the standard language topics. You can get these using the ''getLang'' method in ''XTMPSI'' class. To use this you need to include ''org.wandora.topicmap package''. See examples on how to do this.

== Examples ==

Following example gets all instances of the input topic which have an occurrence with the value of a string literal "Test". Note the use of ''XTMPSI.getLang'' method to get the language topic subject identifier. This method can also be given ''null'' as a parameter to get the language independent topic.

importPackage(org.wandora.query2);
importPackage(org.wandora.topicmap);
new Occurrence("http://www.wandora.org/occurrence",XTMPSI.getLang("en"))
.as("#occ")
.from(new Instances())
.where("#occ","=","\"Test\"")

[[Category:Query directives]]

@@ Line 9: / Line 9: @@
 == Constructor ==
-Occurrence([TopicOperand type [,TopicOperand version] ])
+Occurrence([TopicOperand type][,TopicOperand version])
 == Notes ==

@@ Line 3: / Line 3: @@
 Gets the occurrence with specified type and version from the active column value of input. You can leave out the version to get all occurrences of a type or both parameters to get all occurrences in the topic.
-If you specify both the type and the version but such occurrence exists, will return null. If you leave out one or both of them, will return an empty result if no matching occurrences are found.
+If you specify both the type and the version but no such occurrence exists, will return null. If you leave out one or both of them, will return an empty result if no matching occurrences are found.
-If you don't specify both the version parameter, then the version will be added as a column in the result row. If you don't specify the type either then that also will be added to the result row.
+If you don't specify the version parameter, then the version will be added as a column in the result row. If you don't specify the type either then that also will be added to the result row.
 == Constructor ==

@@ Line 9: / Line 9: @@
 == Constructor ==
-Occurrence([ [TopicOperand type [,TopicOperand version] ])
+Occurrence([TopicOperand type [,TopicOperand version] ])
 == Notes ==

@@ Line 9: / Line 9: @@
 == Constructor ==
-Occurrence([ [String type [,String version] ])
+Occurrence([ [TopicOperand type [,TopicOperand version] ])
 == Notes ==

@@ Line 1: / Line 1: @@
 == Description ==
-Gets the occurrence with specified type and version from the active column value of input.
+Gets the occurrence with specified type and version from the active column value of input. Returns null if the input doesn't have the specified occurrence.
 == Constructor ==