source: mainline/boot/generic/include/str.h@ ce52c333

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since ce52c333 was 28a5ebd, checked in by Martin Decky <martin@…>, 5 years ago

Use char32_t instead of wchat_t to represent UTF-32 strings

The intention of the native HelenOS string API has been always to
support Unicode in the UTF-8 and UTF-32 encodings as the sole character
representations and ignore the obsolete mess of older single-byte and
multibyte character encodings. Before C11, the wchar_t type has been
slightly misused for the purpose of the UTF-32 strings. The newer
char32_t type is obviously a much more suitable option. The standard
defines char32_t as uint_least32_t, thus we can take the liberty to fix
it to uint32_t.

To maintain compatilibity with the C Standard, the putwchar(wchar_t)
functions has been replaced by our custom putuchar(char32_t) functions
where appropriate.

  • Property mode set to 100644
File size: 2.3 KB
RevLine 
[c785296]1/*
[d066259]2 * Copyright (c) 2001-2004 Jakub Jermar
3 * Copyright (c) 2005 Martin Decky
4 * Copyright (c) 2011 Oleg Romanenko
[c785296]5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 *
11 * - Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * - Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * - The name of the author may not be used to endorse or promote products
17 * derived from this software without specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 */
30
[4872160]31/** @file
32 */
33
34#ifndef BOOT_STR_H_
35#define BOOT_STR_H_
36
[d066259]37#include <errno.h>
[d735e2e]38#include <stdbool.h>
[de1712e]39#include <stddef.h>
[28a5ebd]40#include <uchar.h>
[4872160]41
[d066259]42/* Common Unicode characters */
[28a5ebd]43#define U_SPECIAL '?'
[c785296]44
[d066259]45/** No size limit constant */
[4872160]46#define STR_NO_LIMIT ((size_t) -1)
[c785296]47
[28a5ebd]48extern char32_t str_decode(const char *str, size_t *offset, size_t sz);
49extern errno_t chr_encode(char32_t ch, char *str, size_t *offset, size_t sz);
[c785296]50
[d066259]51extern size_t str_size(const char *str);
52extern size_t str_lsize(const char *str, size_t max_len);
53extern size_t str_length(const char *str);
[c785296]54
[28a5ebd]55extern bool ascii_check(char32_t ch);
56extern bool chr_check(char32_t ch);
[4872160]57
[d066259]58extern int str_cmp(const char *s1, const char *s2);
59extern void str_cpy(char *dest, size_t size, const char *src);
[c785296]60
61#endif
[4872160]62
63/** @}
64 */
Note: See TracBrowser for help on using the repository browser.