source: mainline/uspace/lib/c/include/str.h@ 8d2dd7f2

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 8d2dd7f2 was 8d2dd7f2, checked in by Jakub Jermar <jakub@…>, 8 years ago

Reduce the number of files that include <sys/types.h>
  • Property mode set to 100644
File size: 5.1 KB
Line 
1/*
2 * Copyright (c) 2005 Martin Decky
3 * Copyright (c) 2011 Oleg Romanenko
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30/** @addtogroup libc
31 * @{
32 */
33/** @file
34 */
35
36#ifndef LIBC_STR_H_
37#define LIBC_STR_H_
38
39#include <mem.h>
40#include <stddef.h>
41#include <stdint.h>
42#include <stdbool.h>
43
44#define U_SPECIAL '?'
45
46/** No size limit constant */
47#define STR_NO_LIMIT ((size_t) -1)
48
49/** Maximum size of a string containing @c length characters */
50#define STR_BOUNDS(length) ((length) << 2)
51
52/**
53 * Maximum size of a buffer needed to a string converted from space-padded
54 * ASCII of size @a spa_size using spascii_to_str().
55 */
56#define SPASCII_STR_BUFSIZE(spa_size) ((spa_size) + 1)
57
58extern wchar_t str_decode(const char *str, size_t *offset, size_t sz);
59extern wchar_t str_decode_reverse(const char *str, size_t *offset, size_t sz);
60extern int chr_encode(const wchar_t ch, char *str, size_t *offset, size_t sz);
61
62extern size_t str_size(const char *str);
63extern size_t wstr_size(const wchar_t *str);
64
65extern size_t str_nsize(const char *str, size_t max_size);
66extern size_t wstr_nsize(const wchar_t *str, size_t max_size);
67
68extern size_t str_lsize(const char *str, size_t max_len);
69extern size_t wstr_lsize(const wchar_t *str, size_t max_len);
70
71extern size_t str_length(const char *str);
72extern size_t wstr_length(const wchar_t *wstr);
73
74extern size_t str_nlength(const char *str, size_t size);
75extern size_t wstr_nlength(const wchar_t *str, size_t size);
76
77extern size_t chr_width(wchar_t ch);
78extern size_t str_width(const char *str);
79
80extern bool ascii_check(wchar_t ch);
81extern bool chr_check(wchar_t ch);
82
83extern int str_cmp(const char *s1, const char *s2);
84extern int str_lcmp(const char *s1, const char *s2, size_t max_len);
85extern int str_casecmp(const char *s1, const char *s2);
86extern int str_lcasecmp(const char *s1, const char *s2, size_t max_len);
87
88extern bool str_test_prefix(const char *s, const char *p);
89
90extern void str_cpy(char *dest, size_t size, const char *src);
91extern void str_ncpy(char *dest, size_t size, const char *src, size_t n);
92extern void str_append(char *dest, size_t size, const char *src);
93
94extern int spascii_to_str(char *dest, size_t size, const uint8_t *src, size_t n);
95extern void wstr_to_str(char *dest, size_t size, const wchar_t *src);
96extern char *wstr_to_astr(const wchar_t *src);
97extern void str_to_wstr(wchar_t *dest, size_t dlen, const char *src);
98extern wchar_t *str_to_awstr(const char *src);
99extern int utf16_to_str(char *dest, size_t size, const uint16_t *src);
100extern int str_to_utf16(uint16_t *dest, size_t size, const char *src);
101
102extern char *str_chr(const char *str, wchar_t ch);
103extern char *str_rchr(const char *str, wchar_t ch);
104
105extern void str_rtrim(char *str, wchar_t ch);
106extern void str_ltrim(char *str, wchar_t ch);
107
108extern bool wstr_linsert(wchar_t *str, wchar_t ch, size_t pos, size_t max_pos);
109extern bool wstr_remove(wchar_t *str, size_t pos);
110
111extern char *str_dup(const char *);
112extern char *str_ndup(const char *, size_t max_size);
113
114extern char *str_tok(char *, const char *, char **);
115
116extern int str_uint8_t(const char *, const char **, unsigned int, bool,
117 uint8_t *);
118extern int str_uint16_t(const char *, const char **, unsigned int, bool,
119 uint16_t *);
120extern int str_uint32_t(const char *, const char **, unsigned int, bool,
121 uint32_t *);
122extern int str_uint64_t(const char *, const char **, unsigned int, bool,
123 uint64_t *);
124extern int str_size_t(const char *, const char **, unsigned int, bool,
125 size_t *);
126
127extern void order_suffix(const uint64_t, uint64_t *, char *);
128extern void bin_order_suffix(const uint64_t, uint64_t *, const char **, bool);
129
130/*
131 * TODO: Get rid of this.
132 */
133
134extern int stricmp(const char *, const char *);
135
136extern long int strtol(const char *, char **, int);
137extern unsigned long strtoul(const char *, char **, int);
138
139#endif
140
141/** @}
142 */
Note: See TracBrowser for help on using the repository browser.