Add utility class for parsing NT IDs

src/Makefile

@@ -7,6 +7,7 @@ SRC_DIRS += $(SRC)/nt
 
 INC += nt.h
 INC += ntutils.h
+INC += ntid.h
 INC += ntfield.h
 INC += ntscalar.h
 INC += ntscalarArray.h

src/nt/ntid.h

@@ -0,0 +1,121 @@
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS JavaIOC is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+#ifndef NTID_H
+#define NTID_H
+
+
+namespace epics { 
+
+namespace nt {
+
+/**
+ * Utility class for parsing an ID following the NT type ID conventions
+ *
+ * An NT type ID will be of the from epics:nt/<type-name>:<Major>.<Minor>,
+ * e.g. epics:nt/NTNDArray:1.2
+ * @author dgh
+ */
+class NTID
+{
+public:
+    /**
+     * Creates an NTID from the specified type ID
+     *
+     * @param id The the id to be parsed.
+     * @return NTNDArray instance on success, null otherwise.
+     */
+    NTID(String id);
+    /**
+     * Get the full name of the id, i.e. the original ID
+     *
+     * For example above returns "epics:nt/NTNDArray:1.2"
+     * @return the full name
+     */
+    String getFullName();
+
+    /**
+     * Get the fully qualified name including namespaces, but excluding version numbers
+     *
+     * For example above return "epics:nt/NTNDArray"
+     * @return the fully qualified name
+     */ 
+    String getQualifiedName();
+
+    /**
+     * Get the namespace
+     *
+     * For example above return "epics:nt"
+     * @return the namespace
+     */
+    String getNamespace();
+
+    /**
+     * Get the unqualified name, without namespace or version
+     *
+     * For example above return "NTNDArray"
+     * @return the unqualified name
+     */
+    String getName();
+
+    /**
+     * Get the unqualified name, without namespace or version
+     *
+     * For example above return "NTNDArray"
+     * @return the unqualified name
+     */
+    String getVersion();
+
+    /**
+     * Get the Major version as a string
+     *
+     * For example above return "1"
+     * @return the Major string
+     */
+    String getMajorVersionString();
+
+    /**
+     * Does the ID contain a major version and is it a number
+     *
+     * @return true if it contains a major version number
+     */
+    boolean hasMajorVersion();
+
+    /**
+     * Get the Major version as an integer
+     *
+     * For example above return 1
+     * @return the Major string
+     */
+    int getMajorVersion();
+
+    /**
+     * Get the Major version as a string
+     *
+     * For example above return "1"
+     * @return the Major string
+     */
+    String getMinorVersionString();
+
+    /**
+     * Does the ID contain a minor version and is it a number
+     *
+     * @return true if it contains a minor version number
+     */
+    boolean hasMinorVersion();
+
+    /**
+     * Get the Minor version as an integer
+     *
+     * For example above return 1
+     * @return the Minor string
+     */
+    int getMinorVersion()
+};
+
+}}
+
+#endif
+