mirror of
https://github.com/jart/cosmopolitan.git
synced 2025-01-31 03:27:39 +00:00
128 lines
4.7 KiB
C
128 lines
4.7 KiB
C
/*
|
|
* kmp_str.h -- String manipulation routines.
|
|
*/
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef KMP_STR_H
|
|
#define KMP_STR_H
|
|
|
|
#include <stdarg.h>
|
|
#include <string.h>
|
|
|
|
#include "kmp_os.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif // __cplusplus
|
|
|
|
#if KMP_OS_WINDOWS
|
|
#define strdup _strdup
|
|
#endif
|
|
|
|
/* some macros to replace ctype.h functions */
|
|
#define TOLOWER(c) ((((c) >= 'A') && ((c) <= 'Z')) ? ((c) + 'a' - 'A') : (c))
|
|
|
|
struct kmp_str_buf {
|
|
char *str; // Pointer to buffer content, read only.
|
|
unsigned int size; // Do not change this field!
|
|
int used; // Number of characters printed to buffer, read only.
|
|
char bulk[512]; // Do not use this field!
|
|
}; // struct kmp_str_buf
|
|
typedef struct kmp_str_buf kmp_str_buf_t;
|
|
|
|
#define __kmp_str_buf_init(b) \
|
|
{ \
|
|
(b)->str = (b)->bulk; \
|
|
(b)->size = sizeof((b)->bulk); \
|
|
(b)->used = 0; \
|
|
(b)->bulk[0] = 0; \
|
|
}
|
|
|
|
void __kmp_str_buf_clear(kmp_str_buf_t *buffer);
|
|
void __kmp_str_buf_reserve(kmp_str_buf_t *buffer, size_t size);
|
|
void __kmp_str_buf_detach(kmp_str_buf_t *buffer);
|
|
void __kmp_str_buf_free(kmp_str_buf_t *buffer);
|
|
void __kmp_str_buf_cat(kmp_str_buf_t *buffer, char const *str, size_t len);
|
|
void __kmp_str_buf_catbuf(kmp_str_buf_t *dest, const kmp_str_buf_t *src);
|
|
int __kmp_str_buf_vprint(kmp_str_buf_t *buffer, char const *format,
|
|
va_list args);
|
|
int __kmp_str_buf_print(kmp_str_buf_t *buffer, char const *format, ...);
|
|
void __kmp_str_buf_print_size(kmp_str_buf_t *buffer, size_t size);
|
|
|
|
/* File name parser.
|
|
Usage:
|
|
|
|
kmp_str_fname_t fname = __kmp_str_fname_init( path );
|
|
// Use fname.path (copy of original path ), fname.dir, fname.base.
|
|
// Note fname.dir concatenated with fname.base gives exact copy of path.
|
|
__kmp_str_fname_free( & fname );
|
|
*/
|
|
struct kmp_str_fname {
|
|
char *path;
|
|
char *dir;
|
|
char *base;
|
|
}; // struct kmp_str_fname
|
|
typedef struct kmp_str_fname kmp_str_fname_t;
|
|
void __kmp_str_fname_init(kmp_str_fname_t *fname, char const *path);
|
|
void __kmp_str_fname_free(kmp_str_fname_t *fname);
|
|
// Compares file name with specified pattern. If pattern is NULL, any fname
|
|
// matched.
|
|
int __kmp_str_fname_match(kmp_str_fname_t const *fname, char const *pattern);
|
|
|
|
/* The compiler provides source locations in string form
|
|
";file;func;line;col;;". It is not convenient for manipulation. This
|
|
structure keeps source location in more convenient form.
|
|
Usage:
|
|
|
|
kmp_str_loc_t loc = __kmp_str_loc_init(ident->psource, false);
|
|
// use loc.file, loc.func, loc.line, loc.col.
|
|
// loc.fname is available if second argument of __kmp_str_loc_init is true.
|
|
__kmp_str_loc_free( & loc );
|
|
|
|
If psource is NULL or does not follow format above, file and/or func may be
|
|
NULL pointers.
|
|
*/
|
|
struct kmp_str_loc {
|
|
char *_bulk; // Do not use thid field.
|
|
kmp_str_fname_t fname; // Will be initialized if init_fname is true.
|
|
char *file;
|
|
char *func;
|
|
int line;
|
|
int col;
|
|
}; // struct kmp_str_loc
|
|
typedef struct kmp_str_loc kmp_str_loc_t;
|
|
kmp_str_loc_t __kmp_str_loc_init(char const *psource, bool init_fname);
|
|
void __kmp_str_loc_numbers(char const *Psource, int *Line, int *Col);
|
|
void __kmp_str_loc_free(kmp_str_loc_t *loc);
|
|
|
|
int __kmp_str_eqf(char const *lhs, char const *rhs);
|
|
char *__kmp_str_format(char const *format, ...);
|
|
void __kmp_str_free(char **str);
|
|
int __kmp_str_match(char const *target, int len, char const *data);
|
|
bool __kmp_str_contains(char const *target, int len, char const *data);
|
|
int __kmp_str_match_false(char const *data);
|
|
int __kmp_str_match_true(char const *data);
|
|
void __kmp_str_replace(char *str, char search_for, char replace_with);
|
|
void __kmp_str_split(char *str, char delim, char **head, char **tail);
|
|
char *__kmp_str_token(char *str, char const *delim, char **buf);
|
|
int __kmp_basic_str_to_int(char const *str);
|
|
int __kmp_str_to_int(char const *str, char sentinel);
|
|
|
|
void __kmp_str_to_size(char const *str, size_t *out, size_t dfactor,
|
|
char const **error);
|
|
void __kmp_str_to_uint(char const *str, kmp_uint64 *out, char const **error);
|
|
|
|
#ifdef __cplusplus
|
|
} // extern "C"
|
|
#endif // __cplusplus
|
|
|
|
#endif // KMP_STR_H
|
|
|
|
// end of file //
|