79 lines
2.0 KiB
C
79 lines
2.0 KiB
C
/*
|
|
* Copyright(c) 2006 to 2020 ZettaScale Technology and others
|
|
*
|
|
* This program and the accompanying materials are made available under the
|
|
* terms of the Eclipse Public License v. 2.0 which is available at
|
|
* http://www.eclipse.org/legal/epl-2.0, or the Eclipse Distribution License
|
|
* v. 1.0 which is available at
|
|
* http://www.eclipse.org/org/documents/edl-v10.php.
|
|
*
|
|
* SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause
|
|
*/
|
|
#ifndef DDSRT_EXPAND_VARS_H
|
|
#define DDSRT_EXPAND_VARS_H
|
|
|
|
#include "dds/export.h"
|
|
#include "dds/ddsrt/attributes.h"
|
|
#include "dds/ddsrt/retcode.h"
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef const char * (*expand_lookup_fn)(const char *name, void *data);
|
|
|
|
/**
|
|
* @brief Expand variables within string.
|
|
*
|
|
* Expands ${X}, ${X:-Y}, ${X:+Y}, ${X:?Y} forms, but not $X.
|
|
*
|
|
* The result string should be freed with ddsrt_free().
|
|
*
|
|
* @param[in] string String to expand.
|
|
* @param[in] lookup Lookup function to retrieve replacement value
|
|
* @param[in] data Data passed to lookup function
|
|
*
|
|
* @returns Allocated char*.
|
|
*
|
|
* @retval NULL
|
|
* Expansion failed.
|
|
* @retval Pointer
|
|
* Copy of the string argument with the variables expanded.
|
|
*/
|
|
DDS_EXPORT char*
|
|
ddsrt_expand_vars(
|
|
const char *string,
|
|
expand_lookup_fn lookup,
|
|
void * data);
|
|
|
|
/**
|
|
* @brief Expand variables within string.
|
|
*
|
|
* Expands $X, ${X}, ${X:-Y}, ${X:+Y}, ${X:?Y} forms, $ and \
|
|
* can be escaped with \.
|
|
*
|
|
* The result string should be freed with ddsrt_free().
|
|
*
|
|
* @param[in] string String to expand.
|
|
* @param[in] lookup Lookup function to retrieve replacement value
|
|
* @param[in] data Data passed to lookup function
|
|
*
|
|
* @returns Allocated char*.
|
|
*
|
|
* @retval NULL
|
|
* Expansion failed.
|
|
* @retval Pointer
|
|
* Copy of the string argument with the variables expanded.
|
|
*/
|
|
DDS_EXPORT char*
|
|
ddsrt_expand_vars_sh(
|
|
const char *string,
|
|
expand_lookup_fn lookup,
|
|
void * data);
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* DDSRT_EXPAND_VARS_H */
|