thodg/libgit2/src/util/win32/utf-conv.h

• Show log

  Commit

• Hash : c3b7ace9
  Author :
  Date : 2021-11-14T16:43:53
  

  refactor: make util an object library Instead of simply including the utility files directly, make them a cmake object library for easy reusability between other projects within libgit2. Now the top-level `src` is responsible for platform selection, while the next-level `libgit2` and `util` configurations are responsible for identifying what objects they include.

Download

• src/util/win32/utf-conv.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_win32_utf_conv_h__
  #define INCLUDE_win32_utf_conv_h__
  
  #include "git2_util.h"
  
  #include <wchar.h>
  
  #ifndef WC_ERR_INVALID_CHARS
  # define WC_ERR_INVALID_CHARS	0x80
  #endif
  
  /**
   * Converts a UTF-8 string to wide characters.
   *
   * @param dest The buffer to receive the wide string.
   * @param dest_size The size of the buffer, in characters.
   * @param src The UTF-8 string to convert.
   * @return The length of the wide string, in characters (not counting the NULL terminator), or < 0 for failure
   */
  int git__utf8_to_16(wchar_t *dest, size_t dest_size, const char *src);
  
  /**
   * Converts a wide string to UTF-8.
   *
   * @param dest The buffer to receive the UTF-8 string.
   * @param dest_size The size of the buffer, in bytes.
   * @param src The wide string to convert.
   * @return The length of the UTF-8 string, in bytes (not counting the NULL terminator), or < 0 for failure
   */
  int git__utf16_to_8(char *dest, size_t dest_size, const wchar_t *src);
  
  /**
   * Converts a UTF-8 string to wide characters.
   * Memory is allocated to hold the converted string.
   * The caller is responsible for freeing the string with git__free.
   *
   * @param dest Receives a pointer to the wide string.
   * @param src The UTF-8 string to convert.
   * @return The length of the wide string, in characters (not counting the NULL terminator), or < 0 for failure
   */
  int git__utf8_to_16_alloc(wchar_t **dest, const char *src);
  
  /**
   * Converts a wide string to UTF-8.
   * Memory is allocated to hold the converted string.
   * The caller is responsible for freeing the string with git__free.
   *
   * @param dest Receives a pointer to the UTF-8 string.
   * @param src The wide string to convert.
   * @return The length of the UTF-8 string, in bytes (not counting the NULL terminator), or < 0 for failure
   */
  int git__utf16_to_8_alloc(char **dest, const wchar_t *src);
  
  #endif
  

Download