llvm-project/flang/runtime/tools.h

//===-- runtime/tools.h -----------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#ifndef FORTRAN_RUNTIME_TOOLS_H_
#define FORTRAN_RUNTIME_TOOLS_H_

#include "memory.h"
#include <functional>
#include <map>
#include <type_traits>

namespace Fortran::runtime {

class Terminator;

OwningPtr<char> SaveDefaultCharacter(const char *, std::size_t, Terminator &);

// For validating and recognizing default CHARACTER values in a
// case-insensitive manner.  Returns the zero-based index into the
// null-terminated array of upper-case possibilities when the value is valid,
// or -1 when it has no match.
int IdentifyValue(
    const char *value, std::size_t length, const char *possibilities[]);

// A std::map<> customized to use the runtime's memory allocator
template<typename KEY, typename VALUE>
using MapAllocator = Allocator<std::pair<std::add_const_t<KEY>, VALUE>>;
template<typename KEY, typename VALUE, typename COMPARE = std::less<KEY>>
using Map = std::map<KEY, VALUE, COMPARE, MapAllocator<KEY, VALUE>>;
}
#endif  // FORTRAN_RUNTIME_TOOLS_H_