forked from blender/blender
Sergey Sharybin
a12a8a71bb
The goal is to solve confusion of the "All rights reserved" for licensing
code under an open-source license.
The phrase "All rights reserved" comes from a historical convention that
required this phrase for the copyright protection to apply. This convention
is no longer relevant.
However, even though the phrase has no meaning in establishing the copyright
it has not lost meaning in terms of licensing.
This change makes it so code under the Blender Foundation copyright does
not use "all rights reserved". This is also how the GPL license itself
states how to apply it to the source code:
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software ...
This change does not change copyright notice in cases when the copyright
is dual (BF and an author), or just an author of the code. It also does
mot change copyright which is inherited from NaN Holding BV as it needs
some further investigation about what is the proper way to handle it.
97 lines
2.9 KiB
C++
97 lines
2.9 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
* Copyright 2012 Blender Foundation */
|
|
|
|
/** \file
|
|
* \ingroup intern_utf_conv
|
|
*/
|
|
|
|
#ifndef __UTFCONV_H__
|
|
#define __UTFCONV_H__
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <wchar.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Counts how many bytes is required for future utf-8 string using utf-16
|
|
* \param string16: pointer to working utf-16 string
|
|
* \return How many bytes must be allocated including NULL.
|
|
*/
|
|
size_t count_utf_8_from_16(const wchar_t *string16);
|
|
|
|
/**
|
|
* Counts how many wchar_t (two byte) is required for future utf-16 string using utf-8
|
|
* \param string8: pointer to working utf-8 string
|
|
* \return How many bytes must be allocated including NULL.
|
|
*/
|
|
size_t count_utf_16_from_8(const char *string8);
|
|
|
|
/*
|
|
* conv_utf_*** errors
|
|
*/
|
|
|
|
/** Error occurs when required parameter is missing. */
|
|
#define UTF_ERROR_NULL_IN (1 << 0)
|
|
/** Error if character is in illegal UTF range. */
|
|
#define UTF_ERROR_ILLCHAR (1 << 1)
|
|
/** Passed size is to small. It gives legal string with character missing at the end. */
|
|
#define UTF_ERROR_SMALL (1 << 2)
|
|
/** Error if sequence is broken and doesn't finish. */
|
|
#define UTF_ERROR_ILLSEQ (1 << 3)
|
|
|
|
/**
|
|
* Converts utf-16 string to allocated utf-8 string
|
|
* \param in16: utf-16 string to convert
|
|
* \param out8: utf-8 string to string the conversion
|
|
* \param size8: the allocated size in bytes of out8
|
|
* \return Returns any errors occurred during conversion. See the block above,
|
|
*/
|
|
int conv_utf_16_to_8(const wchar_t *in16, char *out8, size_t size8);
|
|
|
|
/**
|
|
* Converts utf-8 string to allocated utf-16 string
|
|
* \param in8: utf-8 string to convert
|
|
* \param out16: utf-16 string to string the conversion
|
|
* \param size16: the allocated size in wchar_t (two byte) of out16
|
|
* \return Returns any errors occurred during conversion. See the block above,
|
|
*/
|
|
int conv_utf_8_to_16(const char *in8, wchar_t *out16, size_t size16);
|
|
|
|
/**
|
|
* Allocates and converts the utf-8 string from utf-16
|
|
* \param in16: utf-16 string to convert
|
|
* \param add: any additional size which will be allocated for new utf-8 string in bytes
|
|
* \return New allocated and converted utf-8 string or NULL if in16 is 0.
|
|
*/
|
|
char *alloc_utf_8_from_16(const wchar_t *in16, size_t add);
|
|
|
|
/**
|
|
* Allocates and converts the utf-16 string from utf-8
|
|
* \param in8: utf-8 string to convert
|
|
* \param add: any additional size which will be allocated for new utf-16 string
|
|
* in wchar_t (two bytes)
|
|
* \return New allocated and converted utf-16 string or NULL if in8 is 0.
|
|
*/
|
|
wchar_t *alloc_utf16_from_8(const char *in8, size_t add);
|
|
|
|
/* Easy allocation and conversion of new utf-16 string. New string has _16 suffix.
|
|
* Must be deallocated with UTF16_UN_ENCODE in right order. */
|
|
#define UTF16_ENCODE(in8str) \
|
|
if (1) { \
|
|
wchar_t *in8str##_16 = alloc_utf16_from_8((const char *)in8str, 0)
|
|
|
|
#define UTF16_UN_ENCODE(in8str) \
|
|
free(in8str##_16); \
|
|
} \
|
|
(void)0
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __UTFCONV_H__ */
|