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

• Show log

  Commit

• Hash : cceae9a2
  Author :
  Date : 2014-12-01T13:09:58
  

  win32: use NT-prefixed "\\?\" paths When turning UTF-8 paths into UCS-2 paths for Windows, always use the \\?\-prefixed paths. Because this bypasses the system's path canonicalization, handle the canonicalization functions ourselves. We must: 1. always use a backslash as a directory separator 2. only use a single backslash between directories 3. not rely on the system to translate "." and ".." in paths 4. remove trailing backslashes, except at the drive root (C:\)

Download

• src/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_git_utfconv_h__
  #define INCLUDE_git_utfconv_h__
  
  #include <wchar.h>
  #include "common.h"
  
  /**
   * 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