2006-03-12 00:19:59 +01:00
|
|
|
/*****************************************************************************
|
|
|
|
* vlc_strings.h: String functions
|
|
|
|
*****************************************************************************
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* Copyright (C) 2006 VLC authors and VideoLAN
|
2006-03-12 00:19:59 +01:00
|
|
|
*
|
|
|
|
* Authors: Antoine Cellerier <dionoea at videolan dot org>
|
|
|
|
*
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* This program 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.1 of the License, or
|
2006-03-12 00:19:59 +01:00
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Lesser General Public License for more details.
|
2006-03-12 00:19:59 +01:00
|
|
|
*
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
2006-03-12 00:19:59 +01:00
|
|
|
*****************************************************************************/
|
|
|
|
|
2008-08-11 18:13:10 +02:00
|
|
|
#ifndef VLC_STRINGS_H
|
|
|
|
#define VLC_STRINGS_H 1
|
2006-03-12 00:19:59 +01:00
|
|
|
|
2008-08-11 17:31:57 +02:00
|
|
|
/**
|
2015-06-14 18:00:16 +02:00
|
|
|
* \defgroup strings String helpers
|
2018-02-11 20:55:42 +01:00
|
|
|
* \ingroup cext
|
2006-03-12 00:19:59 +01:00
|
|
|
* @{
|
2015-06-14 18:00:16 +02:00
|
|
|
* \file
|
|
|
|
* Helper functions for nul-terminated strings
|
2006-03-12 00:19:59 +01:00
|
|
|
*/
|
|
|
|
|
2019-06-03 09:21:14 +02:00
|
|
|
typedef struct vlc_player_t vlc_player_t;
|
|
|
|
|
2014-07-25 11:05:00 +02:00
|
|
|
static inline int vlc_ascii_toupper( int c )
|
|
|
|
{
|
|
|
|
if ( c >= 'a' && c <= 'z' )
|
|
|
|
return c + ( 'A' - 'a' );
|
|
|
|
else
|
|
|
|
return c;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline int vlc_ascii_tolower( int c )
|
|
|
|
{
|
|
|
|
if ( c >= 'A' && c <= 'Z' )
|
|
|
|
return c + ( 'a' - 'A' );
|
|
|
|
else
|
|
|
|
return c;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Compare two ASCII strings ignoring case.
|
|
|
|
*
|
|
|
|
* The result is independent of the locale. If there are non-ASCII
|
|
|
|
* characters in the strings, their cases are NOT ignored in the
|
|
|
|
* comparison.
|
|
|
|
*/
|
|
|
|
static inline int vlc_ascii_strcasecmp( const char *psz1, const char *psz2 )
|
|
|
|
{
|
|
|
|
const char *s1 = psz1;
|
|
|
|
const char *s2 = psz2;
|
|
|
|
int d = vlc_ascii_tolower( *s1 ) - vlc_ascii_tolower( *s2 );
|
|
|
|
while ( *s1 && d == 0)
|
|
|
|
{
|
|
|
|
s1++;
|
|
|
|
s2++;
|
|
|
|
d = vlc_ascii_tolower( *s1 ) - vlc_ascii_tolower( *s2 );
|
|
|
|
}
|
|
|
|
|
|
|
|
return d;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline int vlc_ascii_strncasecmp( const char *psz1, const char *psz2, size_t n )
|
|
|
|
{
|
|
|
|
const char *s1 = psz1;
|
|
|
|
const char *s2 = psz2;
|
|
|
|
const char *s1end = psz1 + n;
|
|
|
|
int d = vlc_ascii_tolower( *s1 ) - vlc_ascii_tolower( *s2 );
|
|
|
|
while ( *s1 && s1 < s1end && d == 0)
|
|
|
|
{
|
|
|
|
s1++;
|
|
|
|
s2++;
|
|
|
|
d = vlc_ascii_tolower( *s1 ) - vlc_ascii_tolower( *s2 );
|
|
|
|
}
|
|
|
|
|
|
|
|
if (s1 == s1end)
|
|
|
|
return 0;
|
|
|
|
else
|
|
|
|
return d;
|
|
|
|
}
|
|
|
|
|
2015-11-29 13:05:15 +01:00
|
|
|
/**
|
|
|
|
* Decodes XML entities.
|
|
|
|
*
|
|
|
|
* Decodes a null-terminated UTF-8 string of XML character data into a regular
|
|
|
|
* nul-terminated UTF-8 string. In other words, replaces XML entities and
|
|
|
|
* numerical character references with the corresponding characters.
|
|
|
|
*
|
|
|
|
* This function operates in place (the output is always of smaller or equal
|
|
|
|
* length than the input) and always succeeds.
|
|
|
|
*
|
|
|
|
* \param str null-terminated string [IN/OUT]
|
|
|
|
*/
|
|
|
|
VLC_API void vlc_xml_decode(char *st);
|
|
|
|
|
|
|
|
/**
|
2021-12-15 15:34:26 +01:00
|
|
|
* Encodes XML entities.
|
2015-11-29 13:05:15 +01:00
|
|
|
*
|
|
|
|
* Substitutes unsafe characters in a null-terminated UTF-8 strings with an
|
|
|
|
* XML entity or numerical character reference.
|
|
|
|
*
|
|
|
|
* \param str null terminated UTF-8 string
|
|
|
|
* \return On success, a heap-allocated null-terminated string is returned.
|
|
|
|
* If the input string was not a valid UTF-8 sequence, NULL is returned and
|
|
|
|
* errno is set to EILSEQ.
|
|
|
|
* If there was not enough memory, NULL is returned and errno is to ENOMEM.
|
|
|
|
*/
|
|
|
|
VLC_API char *vlc_xml_encode(const char *str) VLC_MALLOC;
|
2006-03-12 00:19:59 +01:00
|
|
|
|
2020-04-07 23:49:59 +02:00
|
|
|
/**
|
|
|
|
* Encode binary data as hex string
|
|
|
|
*
|
|
|
|
* Writes a given data buffer to the output buffer as a null terminated
|
|
|
|
* string in hexadecimal representation.
|
|
|
|
*
|
|
|
|
* \param input Input buffer
|
|
|
|
* \param size Input buffer size
|
|
|
|
* \param[out] output Output buffer to write the string to
|
|
|
|
*/
|
|
|
|
VLC_API void vlc_hex_encode_binary(const void *input, size_t size, char *output);
|
|
|
|
|
2019-03-28 16:16:35 +01:00
|
|
|
/**
|
|
|
|
* Base64 encoding.
|
|
|
|
*
|
|
|
|
* Encodes a buffer into base64 as a (nul-terminated) string.
|
|
|
|
*
|
|
|
|
* \param base start address of buffer to encode
|
|
|
|
* \param length length in bytes of buffer to encode
|
|
|
|
* \return a heap-allocated nul-terminated string
|
|
|
|
* (or NULL on allocation error).
|
|
|
|
*/
|
|
|
|
VLC_API char *vlc_b64_encode_binary(const void *base, size_t length)
|
|
|
|
VLC_USED VLC_MALLOC;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Base64 encoding (string).
|
|
|
|
*
|
|
|
|
* Encodes a nul-terminated string into Base64.
|
|
|
|
*
|
|
|
|
* \param str nul-terminated string to encode
|
|
|
|
* \return a heap-allocated nul-terminated string
|
|
|
|
* (or NULL on allocation error).
|
|
|
|
*/
|
|
|
|
VLC_API char *vlc_b64_encode(const char *str) VLC_USED VLC_MALLOC;
|
2007-02-10 10:49:15 +01:00
|
|
|
|
2019-03-28 16:47:53 +01:00
|
|
|
VLC_API size_t vlc_b64_decode_binary_to_buffer(void *p_dst, size_t i_dst_max, const char *psz_src );
|
2011-05-07 13:06:21 +02:00
|
|
|
VLC_API size_t vlc_b64_decode_binary( uint8_t **pp_dst, const char *psz_src );
|
|
|
|
VLC_API char * vlc_b64_decode( const char *psz_src );
|
2007-02-27 21:04:01 +01:00
|
|
|
|
2016-05-17 20:12:23 +02:00
|
|
|
/**
|
|
|
|
* Convenience wrapper for strftime().
|
|
|
|
*
|
|
|
|
* Formats the current time into a heap-allocated string.
|
|
|
|
*
|
2020-04-14 19:11:40 +02:00
|
|
|
* \param tformat time format (as with C strftime())
|
|
|
|
* \return an allocated string (must be free()'d), or NULL on memory error.
|
2016-05-17 20:12:23 +02:00
|
|
|
*/
|
|
|
|
VLC_API char *vlc_strftime( const char * );
|
2016-05-17 20:17:10 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Formats input meta-data.
|
|
|
|
*
|
2020-04-14 19:11:39 +02:00
|
|
|
* Formats input and input item meta-informations into a heap-allocated string
|
|
|
|
* according to the given player format string.
|
|
|
|
*
|
|
|
|
* The player format string contains of replacement specifiers, each specifier begins
|
|
|
|
* with the dollar character (`$`) followed by one of the following letters:
|
|
|
|
*
|
|
|
|
* Char | Replacement
|
|
|
|
* ----- | -------------------------------
|
|
|
|
* `a` | Artist metadata
|
|
|
|
* `b` | Album title metadata
|
2021-12-15 15:34:26 +01:00
|
|
|
* `c` | Copyright information metadata
|
2020-04-14 19:11:39 +02:00
|
|
|
* `d` | Description metadata
|
|
|
|
* `e` | 'Encoded by' metadata
|
|
|
|
* `f` | Displayed output frame (`-` if not available)
|
|
|
|
* `g` | Genre metadata
|
|
|
|
* `l` | Language metadata
|
|
|
|
* `n` | Current Track number metadata
|
|
|
|
* `o` | Total Track number metadata
|
|
|
|
* `p` | Now playing metadata (i.e. currently playing title for livestreams)
|
|
|
|
* `r` | Rating metadata
|
|
|
|
* `s` | Selected subtitle language (`-` if not available)
|
|
|
|
* `t` | Title metadata
|
|
|
|
* `u` | URL metadata
|
|
|
|
* `A` | Date metadata
|
|
|
|
* `B` | Selected audio track bitrate (`-` if not available)
|
|
|
|
* `C` | Current chapter index (`-` if not available)
|
|
|
|
* `D` | Item duration (`--:--:--` if not available)
|
|
|
|
* `F` | Item URI
|
|
|
|
* `I` | Current title index (`-` if not available)
|
|
|
|
* `L` | Item remaining time (`--:--:--` if not available)
|
|
|
|
* `N` | Item name
|
|
|
|
* `O` | Current audio track language (`-` if not available)
|
|
|
|
* `P` | Current playback position (0.0 to 1.0, `--.-%` if not available)
|
|
|
|
* `R` | Current playback speed (1.0 is normal speed, `-` if not available)
|
|
|
|
* `S` | Current audio track samplerate (`-` if not available)
|
|
|
|
* `T` | Current playback time (`--:--:--` if not available)
|
|
|
|
* `U` | Publisher metadata
|
|
|
|
* `V` | Volume (0 to 256, `---` if not available)
|
|
|
|
* `Z` | Now playing or Artist/Title metadata depending what is available
|
|
|
|
* `_` | Newline (`\n`)
|
|
|
|
*
|
|
|
|
* Additionally characters can be prepended with a whitespace (e.g. `$ T`), which will
|
|
|
|
* cause a replacement with nothing, when not available, instead of the placeholders
|
|
|
|
* documented above.
|
2019-06-03 09:21:14 +02:00
|
|
|
*
|
2020-04-14 19:11:40 +02:00
|
|
|
* \param player a locked player instance or NULL (player and item can't be
|
2019-06-03 09:21:14 +02:00
|
|
|
* both NULL)
|
2020-04-14 19:11:40 +02:00
|
|
|
* \param item a valid item or NULL (player and item can't be both NULL)
|
|
|
|
* \param fmt format string
|
|
|
|
* \return an allocated formatted string (must be free()'d), or NULL in case of error
|
2016-05-17 20:17:10 +02:00
|
|
|
*/
|
2019-06-07 10:25:58 +02:00
|
|
|
VLC_API char *vlc_strfplayer( vlc_player_t *player, input_item_t *item,
|
|
|
|
const char *fmt );
|
2012-08-21 20:30:05 +02:00
|
|
|
|
2019-06-03 09:21:14 +02:00
|
|
|
static inline char *str_format( vlc_player_t *player, input_item_t *item,
|
2018-07-19 14:01:58 +02:00
|
|
|
const char *fmt )
|
2012-08-21 20:30:05 +02:00
|
|
|
{
|
2016-05-17 20:12:23 +02:00
|
|
|
char *s1 = vlc_strftime( fmt );
|
2019-06-07 10:25:58 +02:00
|
|
|
char *s2 = vlc_strfplayer( player, item, s1 );
|
2012-08-21 20:30:05 +02:00
|
|
|
free( s1 );
|
|
|
|
return s2;
|
|
|
|
}
|
2007-01-26 23:37:28 +01:00
|
|
|
|
2017-07-23 10:43:14 +02:00
|
|
|
VLC_API int vlc_filenamecmp(const char *, const char *);
|
|
|
|
|
2015-11-29 14:42:23 +01:00
|
|
|
void filename_sanitize(char *);
|
2015-11-29 14:48:41 +01:00
|
|
|
|
2006-03-12 00:19:59 +01:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|
|
|
|
|
|
|
|
#endif
|