aboutsummaryrefslogtreecommitdiff
path: root/src/iso19111/c_api.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/iso19111/c_api.cpp')
-rw-r--r--src/iso19111/c_api.cpp117
1 files changed, 115 insertions, 2 deletions
diff --git a/src/iso19111/c_api.cpp b/src/iso19111/c_api.cpp
index 1e3a331c..7a77ccfb 100644
--- a/src/iso19111/c_api.cpp
+++ b/src/iso19111/c_api.cpp
@@ -1085,13 +1085,32 @@ const char *proj_get_name(const PJ *obj) {
if (!desc.has_value()) {
return nullptr;
}
- // The object will still be alived after the function call.
+ // The object will still be alive after the function call.
// cppcheck-suppress stlcstr
return desc->c_str();
}
// ---------------------------------------------------------------------------
+/** \brief Get the remarks of an object.
+ *
+ * The lifetime of the returned string is the same as the input obj parameter.
+ *
+ * @param obj Object (must not be NULL)
+ * @return a string, or NULL in case of error.
+ */
+const char *proj_get_remarks(const PJ *obj) {
+ assert(obj);
+ if (!obj->iso_obj) {
+ return nullptr;
+ }
+ // The object will still be alive after the function call.
+ // cppcheck-suppress stlcstr
+ return obj->iso_obj->remarks().c_str();
+}
+
+// ---------------------------------------------------------------------------
+
/** \brief Get the authority name / codespace of an identifier of an object.
*
* The lifetime of the returned string is the same as the input obj parameter.
@@ -1113,7 +1132,7 @@ const char *proj_get_id_auth_name(const PJ *obj, int index) {
if (!codeSpace.has_value()) {
return nullptr;
}
- // The object will still be alived after the function call.
+ // The object will still be alive after the function call.
// cppcheck-suppress stlcstr
return codeSpace->c_str();
}
@@ -1295,8 +1314,43 @@ const char *proj_as_proj_string(PJ_CONTEXT *ctx, const PJ *obj,
// ---------------------------------------------------------------------------
+/** \brief Get the scope of an object.
+ *
+ * In case of multiple usages, this will be the one of first usage.
+ *
+ * The lifetime of the returned string is the same as the input obj parameter.
+ *
+ * @param obj Object (must not be NULL)
+ * @return a string, or NULL in case of error or missing scope.
+ */
+const char *proj_get_scope(const PJ *obj) {
+ assert(obj);
+ if (!obj->iso_obj) {
+ return nullptr;
+ }
+ auto objectUsage = dynamic_cast<const ObjectUsage *>(obj->iso_obj.get());
+ if (!objectUsage) {
+ return nullptr;
+ }
+ const auto &domains = objectUsage->domains();
+ if (domains.empty()) {
+ return nullptr;
+ }
+ const auto &scope = domains[0]->scope();
+ if (!scope.has_value()) {
+ return nullptr;
+ }
+ // The object will still be alive after the function call.
+ // cppcheck-suppress stlcstr
+ return scope->c_str();
+}
+
+// ---------------------------------------------------------------------------
+
/** \brief Return the area of use of an object.
*
+ * In case of multiple usages, this will be the one of first usage.
+ *
* @param ctx PROJ context, or NULL for default context
* @param obj Object (must not be NULL)
* @param out_west_lon_degree Pointer to a double to receive the west longitude
@@ -6922,3 +6976,62 @@ PJ *proj_normalize_for_visualization(PJ_CONTEXT *ctx, const PJ *obj) {
return nullptr;
}
}
+
+// ---------------------------------------------------------------------------
+
+/** \brief Returns the number of steps of a concatenated operation.
+ *
+ * The input object must be a concatenated operation.
+ *
+ * @param ctx PROJ context, or NULL for default context
+ * @param concatoperation Concatenated operation (must not be NULL)
+ * @return the number of steps, or 0 in case of error.
+ */
+int proj_concatoperation_get_step_count(PJ_CONTEXT *ctx,
+ const PJ *concatoperation) {
+ SANITIZE_CTX(ctx);
+ assert(concatoperation);
+ auto l_co = dynamic_cast<const ConcatenatedOperation *>(
+ concatoperation->iso_obj.get());
+ if (!l_co) {
+ proj_log_error(ctx, __FUNCTION__,
+ "Object is not a ConcatenatedOperation");
+ return false;
+ }
+ return static_cast<int>(l_co->operations().size());
+}
+// ---------------------------------------------------------------------------
+
+/** \brief Returns a step of a concatenated operation.
+ *
+ * The input object must be a concatenated operation.
+ *
+ * The returned object must be unreferenced with proj_destroy() after
+ * use.
+ * It should be used by at most one thread at a time.
+ *
+ * @param ctx PROJ context, or NULL for default context
+ * @param concatoperation Concatenated operation (must not be NULL)
+ * @param i_step Index of the step to extract. Between 0 and
+ * proj_concatoperation_get_step_count()-1
+ * @return Object that must be unreferenced with proj_destroy(), or NULL
+ * in case of error.
+ */
+PJ *proj_concatoperation_get_step(PJ_CONTEXT *ctx, const PJ *concatoperation,
+ int i_step) {
+ SANITIZE_CTX(ctx);
+ assert(concatoperation);
+ auto l_co = dynamic_cast<const ConcatenatedOperation *>(
+ concatoperation->iso_obj.get());
+ if (!l_co) {
+ proj_log_error(ctx, __FUNCTION__,
+ "Object is not a ConcatenatedOperation");
+ return nullptr;
+ }
+ const auto &steps = l_co->operations();
+ if (i_step < 0 || static_cast<size_t>(i_step) >= steps.size()) {
+ proj_log_error(ctx, __FUNCTION__, "Invalid step index");
+ return nullptr;
+ }
+ return pj_obj_create(ctx, steps[i_step]);
+}