obj_import_string_utils.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2023 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
 
#pragma once
 
#include "BLI_string_ref.hh"
 
/*
 * Various text parsing utilities used by OBJ importer.
 *
 * Many of these functions take two pointers (p, end) indicating
 * which part of a string to operate on, and return a possibly
 * changed new start of the string. They could be taking a StringRef
 * as input and returning a new StringRef, but this is a hot path
 * in OBJ parsing, and the StringRef approach does lose performance
 * (mostly due to return of StringRef being two register-size values
 * instead of just one pointer).
 */
 
namespace blender::io::obj {
 
StringRef read_next_line(StringRef &buffer);
 
void fixup_line_continuations(char *p, char *end);
 
const char *drop_whitespace(const char *p, const char *end);
 
const char *drop_non_whitespace(const char *p, const char *end);
 
const char *parse_int(
    const char *p, const char *end, int fallback, int &dst, bool skip_space = true);
 
const char *parse_float(const char *p,
                        const char *end,
                        float fallback,
                        float &dst,
                        bool skip_space = true,
                        bool require_trailing_space = false);
 
const char *parse_floats(const char *p,
                         const char *end,
                         float fallback,
                         float *dst,
                         int count,
                         bool require_trailing_space = false);
 
}  // namespace blender::io::obj