source: mainline/uspace/lib/c/include/str.h@ 2e839dda

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 2e839dda was 2e839dda, checked in by Oleg Romanenko <romanenko.oleg@…>, 14 years ago

New functions for string library:

  1. Lookup for character in wide string

wstr_chr
wstr_rchr

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