Edit: /usr/include/proftpd/str.h (5729B)
/*
* ProFTPD - FTP server daemon
* Copyright (c) 2008-2023 The ProFTPD Project team
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA.
*
* As a special exemption, Public Flood Software/MacGyver aka Habeeb J. Dihu
* and other respective copyright holders give permission to link this program
* with OpenSSL, and distribute the resulting executable, without including
* the source code for OpenSSL in the source distribution.
*/
/* String manipulation functions */
#ifndef PR_STR_H
#define PR_STR_H
/* Default maximum number of replacements that will do in a given string. */
#define PR_STR_MAX_REPLACEMENTS 8
/* Per RFC959, directory responses for MKD and PWD should be "dir_name" (with
* quotes). For directories that CONTAIN quotes, the additional quotes must
* be duplicated.
*/
const char *quote_dir(pool *p, char *dir);
char *sstrcat(char *, const char *, size_t);
const char *sreplace(pool *, const char *, ...);
char *pdircat(pool *, ...)
#ifdef __GNUC__
__attribute__ ((sentinel));
#else
;
#endif
char *pstrcat(pool *, ...)
#ifdef __GNUC__
__attribute__ ((sentinel));
#else
;
#endif
char *pstrdup(pool *, const char *);
char *pstrndup(pool *, const char *, size_t);
/* Returns TRUE if the string `s' ends with given `suffix', FALSE if the string
* does not end with the given suffix, and -1 if there was an error (errno
* will be set appropriately).
*
* The `flags' value consisted of OR'ing the following:
*
* PR_STR_FL_IGNORE_CASE
* Request a case-insensitive comparison
*/
int pr_strnrstr(const char *s, size_t slen, const char *suffix,
size_t suffixlen, int flags);
/* Returns a quoted version of the given string. */
const char *pr_str_quote(pool *p, const char *str);
/* Newer version of sreplace(), with more control and better error reporting. */
const char *pr_str_replace(pool *, unsigned int, const char *, ...);
const char *pr_str_strip(pool *, const char *);
char *pr_str_strip_end(char *, const char *);
int pr_str_get_nbytes(const char *, const char *, off_t *);
char *pr_str_get_word(char **, int);
/* Parses a "time string" into its duration, in seconds. Returns the number
* of seconds obtained via the `duration' pointer, or -1 (with errno) if
* there was a problem parsing the provided string.
*
* A "time string" is formatted as "hh:mm:ss".
*/
int pr_str_get_duration(const char *str, int *duration);
/* Encode the given buffer of binary data as a hex string. The flags indicate
* whether to use uppercase or lowercase hex values; the default is to use
* lowercase values.
*
* Returns NULL on error, or the successfully encoded string, allocated out of
* the given pool, on success.
*/
char *pr_str_bin2hex(pool *p, const unsigned char *buf, size_t len, int flags);
#define PR_STR_FL_HEX_USE_UC 0x0001
#define PR_STR_FL_HEX_USE_LC 0x0002
/* Decodes the given buffer of hex-encoded data into binary data. */
unsigned char *pr_str_hex2bin(pool *p, const unsigned char *hex, size_t hex_len,
size_t *len);
/* Obtain the Levenshtein distance between the two strings. The various
* operations (swap, substitution, insertion, deletion) can be weighted.
*/
int pr_str_levenshtein(pool *p, const char *a, const char *b,
int swap_cost, int subst_cost, int insert_cost, int del_cost, int flags);
/* Given a string and a list of possibly similar candidates, return an
* array of the candidates, sorted in order of Levenshtein distance (ascending).
* A maximum edit distance can be used to return the most relevant subset of
* the candidates; if a max distance of zero is used, the default max distance
* value will be used.
*/
array_header *pr_str_get_similars(pool *p, const char *s,
array_header *candidates, int max_distance, int flags);
#define PR_STR_DEFAULT_MAX_EDIT_DISTANCE 7
/* Given a string delimited by a character (such as comma or pipe), return
* an array of each item.
*/
array_header *pr_str_text_to_array(pool *p, const char *text, char delimiter);
/* Given an array of strings, return a string delimited by a string (such
* as comma or pipe).
*/
char *pr_str_array_to_text(pool *p, const array_header *items,
const char *delimiter);
/* Converts a string to a uid_t/gid_t, respectively. */
int pr_str2uid(const char *, uid_t *);
int pr_str2gid(const char *, gid_t *);
/* Converts a uid_t/gid_t to a string, respectively */
const char *pr_uid2str(pool *, uid_t);
const char *pr_gid2str(pool *, gid_t);
#define PR_STR_FL_PRESERVE_COMMENTS 0x0001
#define PR_STR_FL_PRESERVE_WHITESPACE 0x0002
#define PR_STR_FL_IGNORE_CASE 0x0004
#define PR_STR_FL_IGNORE_QUOTES 0x0008
char *pr_str_get_token(char **, char *);
char *pr_str_get_token2(char **, char *, size_t *);
/* Returns TRUE if the given string is "on", "yes", "true", or "1"; returns
* FALSE if the string is "off", "false", "no", or "0". Otherwise, -1
* is returned, with errno set to EINVAL.
*/
int pr_str_is_boolean(const char *);
int pr_str_is_fnmatch(const char *);
#define CHOP(s) pr_str_strip_end((s), "\r\n")
#endif /* PR_STR_H */