Merge pull request #2209 from opensim-org/expose_object_get_document

Expose Object::getDocument() as a const public method.

Author: tkuchida

OpenSim/Common/Object.cpp

@@ -1241,13 +1241,18 @@ updateDefaultObjectsXMLNode(SimTK::Xml::Element& aParent)
  *
  * @return Document's filename for this object.
  */
-string Object::
-getDocumentFileName() const
+string Object::getDocumentFileName() const
 {
     return _document ? _document->getFileName() : "";
 }
 
 
+int Object::getDocumentFileVersion() const
+{ 
+    return _document ? _document->getDocumentVersion() : -1;
+}
+
+
 //-----------------------------------------------------------------------------
 // GENERATE XML DOCUMENT
 //-----------------------------------------------------------------------------

OpenSim/Common/Object.h

@@ -573,6 +573,13 @@ class OSIMCOMMON_API Object
     /** If there is a document associated with this object then return the
     file name maintained by the document. Otherwise return an empty string. **/
     std::string getDocumentFileName() const;
+
+    /** If there is a document associated with this object then return its
+        version number. For example this is 30000 for OpenSim 3.x documents 
+        and is 305xx for OpenSim 4.0 beta and above. If there is no document
+        associated with the object, the method returns -1.*/
+    int getDocumentFileVersion() const;
+
     void setAllPropertiesUseDefault(bool aUseDefault);
 
     /** Write this %Object into an XML file of the given name; conventionally