RepoMirrors
/
ffmpeg
mirror of https://git.ffmpeg.org/ffmpeg.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
ffmpeg/libavutil/attributes.h

174 lines
4.7 KiB
C
Raw Normal View History

Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
/*
* copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
*
* This file is part of FFmpeg.
*
* FFmpeg 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 (at your option) any later version.
*
* FFmpeg 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.
*
* You should have received a copy of the GNU Lesser General Public
* License along with FFmpeg; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
/**
Remove explicit filename from Doxygen @file commands. Passing an explicit filename to this command is only necessary if the documentation in the @file block refers to a file different from the one the block resides in. Originally committed as revision 22921 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-04-20 14:45:34 +00:00
* @file
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
* Macro definitions for various function/variable attributes
*/
#ifndef AVUTIL_ATTRIBUTES_H
#define AVUTIL_ATTRIBUTES_H
#ifdef __GNUC__
avutil/attributes: Add () to protect the AV_GCC_VERSION_AT_LEAST() arguments Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2015-02-16 23:21:48 +00:00
# define AV_GCC_VERSION_AT_LEAST(x,y) (__GNUC__ > (x) || __GNUC__ == (x) && __GNUC_MINOR__ >= (y))
avutil/attributes: add AV_GCC_VERSION_AT_MOST Reviewed-by: Michael Niedermayer <michaelni@gmx.at> Signed-off-by: James Almer <jamrial@gmail.com>
2015-09-18 04:00:43 +00:00
# define AV_GCC_VERSION_AT_MOST(x,y) (__GNUC__ < (x) || __GNUC__ == (x) && __GNUC_MINOR__ <= (y))
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#else
# define AV_GCC_VERSION_AT_LEAST(x,y) 0
avutil/attributes: add AV_GCC_VERSION_AT_MOST Reviewed-by: Michael Niedermayer <michaelni@gmx.at> Signed-off-by: James Almer <jamrial@gmail.com>
2015-09-18 04:00:43 +00:00
# define AV_GCC_VERSION_AT_MOST(x,y) 0
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#endif
Use gcc/clang builtins for av_sat_(add|sub)_64_c if available. Signed-off-by: Dale Curtis <dalecurtis@chromium.org> Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
2020-05-01 17:20:43 +00:00
#ifdef __has_builtin
# define AV_HAS_BUILTIN(x) __has_builtin(x)
#else
avutil/attributes: Fix too many warning: false is not defined [-Wundef] Reviewed-by: James Almer <jamrial@gmail.com> Reviewed-by: Hendrik Leppkes <h.leppkes@gmail.com> Signed-off-by: Limin Wang <lance.lmwang@gmail.com>
2020-05-29 11:14:18 +00:00
# define AV_HAS_BUILTIN(x) 0
Use gcc/clang builtins for av_sat_(add|sub)_64_c if available. Signed-off-by: Dale Curtis <dalecurtis@chromium.org> Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
2020-05-01 17:20:43 +00:00
#endif
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#ifndef av_always_inline
#if AV_GCC_VERSION_AT_LEAST(3,1)
# define av_always_inline __attribute__((always_inline)) inline
attributes: Add a definition of av_always_inline for MSVC Signed-off-by: Martin Storsjö <martin@martin.st>
2012-06-24 17:57:14 +00:00
#elif defined(_MSC_VER)
# define av_always_inline __forceinline
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#else
# define av_always_inline inline
#endif
#endif
new attribute "extern inline" (fixing linker error with ff_get_mb_score and ff_get_mb_score) Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2012-06-14 21:09:52 +00:00
#ifndef av_extern_inline
enable C99-external_inline for icl Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2012-06-15 22:20:18 +00:00
#if defined(__ICL) && __ICL >= 1210 || defined(__GNUC_STDC_INLINE__)
# define av_extern_inline extern inline
#else
new attribute "extern inline" (fixing linker error with ff_get_mb_score and ff_get_mb_score) Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2012-06-14 21:09:52 +00:00
# define av_extern_inline inline
#endif
enable C99-external_inline for icl Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2012-06-15 22:20:18 +00:00
#endif
new attribute "extern inline" (fixing linker error with ff_get_mb_score and ff_get_mb_score) Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2012-06-14 21:09:52 +00:00
avutil/attributes: add av_warn_unused_result GCC 3.4 introduced an attribute warn_unused_result to warn when a programmer discards the return value. Applying this judiciously across the codebase can help in fixing a lot of problems. At a high level, functions which return error codes should always be checked. More concretely, consider the functions ff_add_format and the like in avfilter/formats.h. A quick examination shows that a large portion of libavfilter fails to handle the associated errors, usually AVERROR(ENOMEM). The above example was where I observed the utility of this, but it should be useful in many places across the code base. Signed-off-by: Ganesh Ajjanagadde <gajjanagadde@gmail.com> Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
2015-10-05 05:45:12 +00:00
#if AV_GCC_VERSION_AT_LEAST(3,4)
# define av_warn_unused_result __attribute__((warn_unused_result))
#else
# define av_warn_unused_result
#endif
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#if AV_GCC_VERSION_AT_LEAST(3,1)
# define av_noinline __attribute__((noinline))
msvc/icl: Use __declspec(noinline) Signed-off-by: Martin Storsjö <martin@martin.st>
2013-09-19 21:33:23 +00:00
#elif defined(_MSC_VER)
# define av_noinline __declspec(noinline)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#else
# define av_noinline
#endif
libavutil: Hook up the rest of the gcc specific attributes to clang as well Hook up all attributes that don't have a MSVC specific version at the moment. See f637046d313 for details. These don't seem to be critical for building with clang in MSVC mode though, and thus haven't been hooked up until now. These seem to build fine with as old clang as 3.3 at least. (clang 3.3 disguises itself as gcc 4.2 normally, so all of these have been used for clang before, except for av_cold.) The clang version numbers themselves are useless for detecting what attributes are available, since Apple's clang builds use a completely different versioning (presenting itself as e.g. clang 8.0 instead of 3.8). Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:36:33 +00:00
#if AV_GCC_VERSION_AT_LEAST(3,1) || defined(__clang__)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_pure __attribute__((pure))
#else
# define av_pure
#endif
libavutil: Hook up the rest of the gcc specific attributes to clang as well Hook up all attributes that don't have a MSVC specific version at the moment. See f637046d313 for details. These don't seem to be critical for building with clang in MSVC mode though, and thus haven't been hooked up until now. These seem to build fine with as old clang as 3.3 at least. (clang 3.3 disguises itself as gcc 4.2 normally, so all of these have been used for clang before, except for av_cold.) The clang version numbers themselves are useless for detecting what attributes are available, since Apple's clang builds use a completely different versioning (presenting itself as e.g. clang 8.0 instead of 3.8). Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:36:33 +00:00
#if AV_GCC_VERSION_AT_LEAST(2,6) || defined(__clang__)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_const __attribute__((const))
#else
# define av_const
#endif
libavutil: Hook up the rest of the gcc specific attributes to clang as well Hook up all attributes that don't have a MSVC specific version at the moment. See f637046d313 for details. These don't seem to be critical for building with clang in MSVC mode though, and thus haven't been hooked up until now. These seem to build fine with as old clang as 3.3 at least. (clang 3.3 disguises itself as gcc 4.2 normally, so all of these have been used for clang before, except for av_cold.) The clang version numbers themselves are useless for detecting what attributes are available, since Apple's clang builds use a completely different versioning (presenting itself as e.g. clang 8.0 instead of 3.8). Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:36:33 +00:00
#if AV_GCC_VERSION_AT_LEAST(4,3) || defined(__clang__)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_cold __attribute__((cold))
#else
# define av_cold
#endif
attributes: disable flatten on llvm/clang
2013-10-26 23:45:18 +00:00
#if AV_GCC_VERSION_AT_LEAST(4,1) && !defined(__llvm__)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_flatten __attribute__((flatten))
#else
# define av_flatten
#endif
#if AV_GCC_VERSION_AT_LEAST(3,1)
# define attribute_deprecated __attribute__((deprecated))
lavu: provide msvc implementation of attribute_deprecated Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-09-06 17:32:31 +00:00
#elif defined(_MSC_VER)
# define attribute_deprecated __declspec(deprecated)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#else
# define attribute_deprecated
#endif
lavu/attributes: introduce AV_NOWARN_DEPRECATED.
2011-09-14 17:47:38 +00:00
/**
* Disable warnings about deprecated features
* This is useful for sections of code kept for backward compatibility and
* scheduled for removal.
*/
#ifndef AV_NOWARN_DEPRECATED
avutil/attributes: add support for clang in AV_NOWARN_DEPRECATED Reviewed-by: Martin Storsjö <martin@martin.st> Signed-off-by: James Almer <jamrial@gmail.com>
2022-03-16 14:03:50 +00:00
#if AV_GCC_VERSION_AT_LEAST(4,6) || defined(__clang__)
lavu/attributes: introduce AV_NOWARN_DEPRECATED.
2011-09-14 17:47:38 +00:00
# define AV_NOWARN_DEPRECATED(code) \
_Pragma("GCC diagnostic push") \
_Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"") \
code \
_Pragma("GCC diagnostic pop")
lavu: provide msvc implementation of attribute_deprecated Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-09-06 17:32:31 +00:00
#elif defined(_MSC_VER)
# define AV_NOWARN_DEPRECATED(code) \
__pragma(warning(push)) \
__pragma(warning(disable : 4996)) \
code; \
__pragma(warning(pop))
lavu/attributes: introduce AV_NOWARN_DEPRECATED.
2011-09-14 17:47:38 +00:00
#else
# define AV_NOWARN_DEPRECATED(code) code
#endif
#endif
libavutil: Always use some GCC style attributes on clang Clang normally disguises as GCC (defining __GNUC__), and thus get all the normal GCC specific attributes. Clang can also work as a drop-in replacement for MSVC, and in these cases, it doesn't define __GNUC__, but defines _MSC_VER instead. Even in these setups, it still supports the GCC style attributes, thus use them, especially where there isn't any MSVC specific version, or where the MSVC specific version doesn't work on clang (for DECLARE_ASM_CONST). Signed-off-by: Martin Storsjö <martin@martin.st>
2016-07-18 20:25:11 +00:00
#if defined(__GNUC__) || defined(__clang__)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_unused __attribute__((unused))
#else
# define av_unused
#endif
Rename attribute_used to av_used and move it to attributes.h This is consistent with most of the other attribute macros. Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 365e3c7878e4e821d5dec922d2d51f92ce13f926)
2011-01-31 02:19:30 +00:00
/**
* Mark a variable as used and prevent the compiler from optimizing it
* away. This is useful for variables accessed only from inline
* assembler without the compiler being aware.
*/
libavutil: Always use some GCC style attributes on clang Clang normally disguises as GCC (defining __GNUC__), and thus get all the normal GCC specific attributes. Clang can also work as a drop-in replacement for MSVC, and in these cases, it doesn't define __GNUC__, but defines _MSC_VER instead. Even in these setups, it still supports the GCC style attributes, thus use them, especially where there isn't any MSVC specific version, or where the MSVC specific version doesn't work on clang (for DECLARE_ASM_CONST). Signed-off-by: Martin Storsjö <martin@martin.st>
2016-07-18 20:25:11 +00:00
#if AV_GCC_VERSION_AT_LEAST(3,1) || defined(__clang__)
Rename attribute_used to av_used and move it to attributes.h This is consistent with most of the other attribute macros. Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 365e3c7878e4e821d5dec922d2d51f92ce13f926)
2011-01-31 02:19:30 +00:00
# define av_used __attribute__((used))
#else
# define av_used
#endif
libavutil: Hook up the rest of the gcc specific attributes to clang as well Hook up all attributes that don't have a MSVC specific version at the moment. See f637046d313 for details. These don't seem to be critical for building with clang in MSVC mode though, and thus haven't been hooked up until now. These seem to build fine with as old clang as 3.3 at least. (clang 3.3 disguises itself as gcc 4.2 normally, so all of these have been used for clang before, except for av_cold.) The clang version numbers themselves are useless for detecting what attributes are available, since Apple's clang builds use a completely different versioning (presenting itself as e.g. clang 8.0 instead of 3.8). Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:36:33 +00:00
#if AV_GCC_VERSION_AT_LEAST(3,3) || defined(__clang__)
av_alias is an attribute and belongs to attributes.h also attributes.h is public and external api and can thus not depend on configure tested compiler support thus this part is removed. A different solution must be found if this breaks for some compiler which i hope it does not. Originally committed as revision 23115 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-05-13 16:30:58 +00:00
# define av_alias __attribute__((may_alias))
#else
# define av_alias
#endif
Merge commit '8e2346154e6d58b733fd20326ce706f82fd91b3e' * commit '8e2346154e6d58b733fd20326ce706f82fd91b3e': libavutil: Hook up the rest of the gcc specific attributes to clang as well Merged-by: James Almer <jamrial@gmail.com>
2017-10-21 17:25:55 +00:00
#if (defined(__GNUC__) || defined(__clang__)) && !defined(__INTEL_COMPILER)
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
# define av_uninit(x) x=x
#else
# define av_uninit(x) x
#endif
libavutil: Hook up the rest of the gcc specific attributes to clang as well Hook up all attributes that don't have a MSVC specific version at the moment. See f637046d313 for details. These don't seem to be critical for building with clang in MSVC mode though, and thus haven't been hooked up until now. These seem to build fine with as old clang as 3.3 at least. (clang 3.3 disguises itself as gcc 4.2 normally, so all of these have been used for clang before, except for av_cold.) The clang version numbers themselves are useless for detecting what attributes are available, since Apple's clang builds use a completely different versioning (presenting itself as e.g. clang 8.0 instead of 3.8). Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:36:33 +00:00
#if defined(__GNUC__) || defined(__clang__)
av_builtin_constant_p() Originally committed as revision 22770 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-04-02 01:03:27 +00:00
# define av_builtin_constant_p __builtin_constant_p
Add av_printf_format, for marking printf style format strings and their parameters Signed-off-by: Martin Storsjö <martin@martin.st>
2011-06-17 07:30:15 +00:00
# define av_printf_format(fmtpos, attrpos) __attribute__((__format__(__printf__, fmtpos, attrpos)))
av_builtin_constant_p() Originally committed as revision 22770 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-04-02 01:03:27 +00:00
#else
# define av_builtin_constant_p(x) 0
Add av_printf_format, for marking printf style format strings and their parameters Signed-off-by: Martin Storsjö <martin@martin.st>
2011-06-17 07:30:15 +00:00
# define av_printf_format(fmtpos, attrpos)
av_builtin_constant_p() Originally committed as revision 22770 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-04-02 01:03:27 +00:00
#endif
libavutil: Define the noreturn attribute for clang in MSVC mode as well This is a follow-up to f637046d313. Without the noreturn attribute set, avconv_opt.c fails to build after d2e6dd32a44 with the error "control may reach end of non-void function". By making sure the noreturn attribute is set properly, this compiles as intended. Signed-off-by: Martin Storsjö <martin@martin.st>
2017-03-21 12:26:27 +00:00
#if AV_GCC_VERSION_AT_LEAST(2,5) || defined(__clang__)
attributes: add av_noreturn Also use it in the declaration of the various exit_program implementations in avtools. inspired by a clang-scan report.
2012-07-01 17:38:40 +00:00
# define av_noreturn __attribute__((noreturn))
#else
# define av_noreturn
#endif
Move gcc attribute macros to new header libavutil/attributes.h Originally committed as revision 22346 to svn://svn.ffmpeg.org/ffmpeg/trunk
2010-03-08 21:28:56 +00:00
#endif /* AVUTIL_ATTRIBUTES_H */