unicode.h(3)

💖 unicode.h — a whole header file, bestie

okay so this is unicode.h, and it lives in the Library Functions Manual section (3) of the libmtp docs. Strap in, it's giving Unicode glow-up energy ✨

---

🌸 NAME

unicode.h — literally just the header, no cap 🫶

---

✨ SYNOPSIS

🎀 Functions

int ucs2_strlen (uint16_t const *const)
char * utf16_to_utf8 (LIBMTP_mtpdevice_t *, const uint16_t *)
uint16_t * utf8_to_utf16 (LIBMTP_mtpdevice_t *, const char *)
void strip_7bit_from_utf8 (char *str)

---

💅 Detailed Description

This file contains general Unicode string manipulation functions, periodt. It mainly consist of functions for converting between UCS-2 (used on the devices) and UTF-8 (used by several applications). it's literally a whole translation service for text 😭

For a deeper understanding of Unicode encoding formats see the Wikipedia entries for UTF-16/UCS-2 and UTF-8. (iykyk, go read the wiki, it's lowkey fascinating 💜)

Copyright (C) 2005-2007 Linus Walleij triad@df.lth.se

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library 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 for more details. (yes bestie, that's the all-caps legal part, we do not skip it 💀)

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

---

🔥 Function Documentation

🧚 void strip_7bit_from_utf8 (char * str)

This helper function simply removes any consecutive chars

0x7F

and replace then with an underscore. In UTF-8 consecutive chars > 0x7F represent one single character so it has to be done like this (and it's elegant). It will only shrink the string in size so no copying is needed — no extra memory drama, we love a zero-copy icon 👑

Referenced by LIBMTP_Create_Folder().

---

⭐ int ucs2_strlen (uint16_t const *const unicstr)

Gets the length (in characters, not bytes) of a unicode UCS-2 string, eg a string which physically is 0x00 0x41 0x00 0x00 will return a value of 1. so tiny, so mighty 🎀

Parameters

• unicstr — a UCS-2 Unicode string

Returns

the length of the string, in number of characters. If you want to know the length in bytes, multiply this by two and add two (for zero terminator). math era fr fr 🧮

Referenced by utf16_to_utf8(), and utf8_to_utf16().

---

🦋 char * utf16_to_utf8 (LIBMTP_mtpdevice_t * device, const uint16_t * unicstr)

Converts a big-endian UTF-16 2-byte string to a UTF-8 string. Actually just a UCS-2 internal conversion routine that strips off the BOM if there is one. (BOM = byte order mark, and yes we are removing it, respectfully 🙈)

Parameters

• device — a pointer to the current device.
• unicstr — the UTF-16 unicode string to convert

Returns

a UTF-8 string.

References LIBMTP_mtpdevice_struct::params, STRING_BUFFER_LENGTH, and ucs2_strlen().

---

🌈 uint16_t * utf8_to_utf16 (LIBMTP_mtpdevice_t * device, const char * localstr)

Converts a UTF-8 string to a big-endian UTF-16 2-byte string. Actually just a UCS-2 internal conversion. the other direction, bestie, we go both ways here 💫

Parameters

• device — a pointer to the current device.
• localstr — the UTF-8 unicode string to convert

Returns

a UTF-16 string.

References LIBMTP_mtpdevice_struct::params, STRING_BUFFER_LENGTH, and ucs2_strlen().

---

👑 Author

Generated automatically by Doxygen for libmtp from the source code. (not a human, just a robot doing its little robot thing 🤖💖)

---

k bye bestie!! this page is from libmtp, Version 1.1.23, dated the unicode.h(3) moment in time — slay, go convert some strings 💅✨🎀