OFUTF8String.h

/*
 * Copyright (c) 2008-2024 Jonathan Schleifer <js@nil.im>
 *
 * All rights reserved.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License version 3.0 only,
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
 * version 3.0 for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 3.0 along with this program. If not, see
 * <https://www.gnu.org/licenses/>.
 */
 
#import "OFString.h"
 
OF_ASSUME_NONNULL_BEGIN
 
@interface OFUTF8String: OFString
{
    /*
     * A pointer to the actual data.
     *
     * Since constant strings don't have `_storage`, they have to allocate
     * it on the first access. Strings created at runtime just set the
     * pointer to `&_storage`.
     */
    struct OFUTF8StringIvars {
        char          *cString;
        size_t        cStringLength;
        bool          isUTF8;
        size_t        length;
        bool          hasHash;
        unsigned long hash;
        bool          freeWhenDone;
    } *restrict _s;
    struct OFUTF8StringIvars _storage;
}
@end
 
#ifdef __cplusplus
extern "C" {
#endif
extern int OFUTF8StringCheck(const char *, size_t, size_t *);
extern size_t OFUTF8StringIndexToPosition(const char *, size_t, size_t);
#ifdef __cplusplus
}
#endif
 
OF_ASSUME_NONNULL_END