diff --git a/groups/bdl/bdlb/bdlb_nullablevalueref.h b/groups/bdl/bdlb/bdlb_nullablevalueref.h index ced4352c13..0e374bf45e 100644 --- a/groups/bdl/bdlb/bdlb_nullablevalueref.h +++ b/groups/bdl/bdlb/bdlb_nullablevalueref.h @@ -329,19 +329,19 @@ class NullableValueRef { TYPE& makeValueInplace(ARGS&&... args); #endif - BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOr", - "Use 'value_or' instead") /// Return the value of the underlying object of a (template parameter) /// `TYPE` if this object is non-null, and the specified `otherValue` /// otherwise. Note that this method returns *by* *value*, so may be /// inefficient in some contexts. + BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOr", + "Use 'value_or' instead") TYPE valueOr(const TYPE& otherValue) const; - BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOrNull", - "Use 'has_value() ? &value() : NULL' instead") /// Return an address providing non-modifiable access to the underlying /// object of a (template parameter) `TYPE` if this object is non-null, /// and 0 otherwise. + BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOrNull", + "Use 'has_value() ? &value() : NULL' instead") const TYPE *valueOrNull() const; }; diff --git a/groups/bdl/bdlb/bdlb_nullablevalueref_cpp03.h b/groups/bdl/bdlb/bdlb_nullablevalueref_cpp03.h index 9423c615d4..f40d0918cb 100644 --- a/groups/bdl/bdlb/bdlb_nullablevalueref_cpp03.h +++ b/groups/bdl/bdlb/bdlb_nullablevalueref_cpp03.h @@ -21,7 +21,7 @@ // regions of C++11 code, then this header contains no code and is not // '#include'd in the original header. // -// Generated on Wed Sep 4 19:02:35 2024 +// Generated on Wed Nov 6 15:09:19 2024 // Command line: sim_cpp11_features.pl bdlb_nullablevalueref.h #ifdef COMPILING_BDLB_NULLABLEVALUEREF_H @@ -368,19 +368,19 @@ class NullableValueRef { // }}} END GENERATED CODE #endif - BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOr", - "Use 'value_or' instead") /// Return the value of the underlying object of a (template parameter) /// `TYPE` if this object is non-null, and the specified `otherValue` /// otherwise. Note that this method returns *by* *value*, so may be /// inefficient in some contexts. + BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOr", + "Use 'value_or' instead") TYPE valueOr(const TYPE& otherValue) const; - BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOrNull", - "Use 'has_value() ? &value() : NULL' instead") /// Return an address providing non-modifiable access to the underlying /// object of a (template parameter) `TYPE` if this object is non-null, /// and 0 otherwise. + BSLS_DEPRECATE_FEATURE("bdl", "NullableValueRef::valueOrNull", + "Use 'has_value() ? &value() : NULL' instead") const TYPE *valueOrNull() const; }; diff --git a/groups/bdl/bdlcc/bdlcc_objectcatalog.h b/groups/bdl/bdlcc/bdlcc_objectcatalog.h index d9cec2e4e0..d150ac676f 100644 --- a/groups/bdl/bdlcc/bdlcc_objectcatalog.h +++ b/groups/bdl/bdlcc/bdlcc_objectcatalog.h @@ -11,8 +11,6 @@ BSLS_IDENT("$Id: $") // bdlcc::ObjectCatalog: templatized, thread-safe, indexed object container // bdlcc::ObjectCatalogIter: thread-safe iterator for `bdlcc::ObjectCatalog` // -//@SEE_ALSO: -// //@DESCRIPTION: This component provides a thread-safe and efficient templatized // catalog of objects. A `bdlcc::ObjectCatalog` supports efficient insertion // of objects through the `add` method, which returns a handle that can be used @@ -515,14 +513,14 @@ class ObjectCatalog { /// this catalog. int length() const; - BSLS_DEPRECATE_FEATURE("bde", "ObjectCataloog::value(handle)", - "use 'ObjectCatalogIter::value()' instead") /// Return a `const` reference to the object having the specified /// `handle`. The behavior is undefined unless `handle` is contained in /// this catalog. /// /// This method is *DEPRECATED* because it is not thread-safe. Use /// `find`, `isMember`, or access the object through an iterator. + BSLS_DEPRECATE_FEATURE("bde", "ObjectCataloog::value(handle)", + "use 'ObjectCatalogIter::value()' instead") const TYPE& value(int handle) const; // FOR TESTING PURPOSES ONLY diff --git a/groups/bdl/bdlde/bdlde_base64decoder.h b/groups/bdl/bdlde/bdlde_base64decoder.h index 2280cb7657..951b726f4a 100644 --- a/groups/bdl/bdlde/bdlde_base64decoder.h +++ b/groups/bdl/bdlde/bdlde_base64decoder.h @@ -547,7 +547,6 @@ class Base64Decoder { explicit Base64Decoder(const Base64DecoderOptions& options); - BSLS_DEPRECATE_FEATURE("bdl", "Base64Decoder", "use options c'tor") /// Create a Base64 decoder in the initial state. Unrecognized /// characters (i.e., non-base64 characters other than whitespace) will /// be treated as errors if the specified @@ -557,6 +556,7 @@ class Base64Decoder { /// alphabet, "base64", is used. Padded input is assumed. /// /// @DEPRECATED: Use the overload that takes `options` instead. + BSLS_DEPRECATE_FEATURE("bdl", "Base64Decoder", "use options c'tor") explicit Base64Decoder(bool unrecognizedNonWhitespaceIsErrorFlag, Alphabet alphabet = e_BASIC); @@ -661,13 +661,13 @@ class Base64Decoder { /// `false` otherwise. bool isPadded() const; - BSLS_DEPRECATE_FEATURE("bdl", "isUnrecognizedAnError", "use ignoreMode") /// Return `true` if this mechanism is currently configured to report an /// error when an unrecognized character (i.e., a character other than /// one of the 64 "numeric" base-64 characters, `=`, or whitespace) is /// encountered, and `false` otherwise. /// /// @DEPRECATED: use the `ignoreMode` accessor instead. + BSLS_DEPRECATE_FEATURE("bdl", "isUnrecognizedAnError", "use ignoreMode") bool isUnrecognizedAnError() const; /// Return a `Base64DecoderOptions` object representing the diff --git a/groups/bdl/bdlde/bdlde_base64encoder.h b/groups/bdl/bdlde/bdlde_base64encoder.h index 4ef0b59982..acdbec7054 100644 --- a/groups/bdl/bdlde/bdlde_base64encoder.h +++ b/groups/bdl/bdlde/bdlde_base64encoder.h @@ -538,9 +538,6 @@ class Base64Encoder { static bsl::size_t encodedLength(const EncoderOptions& options, bsl::size_t inputLength); - BSLS_DEPRECATE_FEATURE("bdl", - "encodedLength", - "use overload with 'options'") /// Return the exact number of encoded bytes that would result from an /// input byte sequence of the specified `inputLength` provided to the /// `convert` method of an encoder with the maximum allowable @@ -549,12 +546,12 @@ class Base64Encoder { /// `0 <= inputLength`. /// /// @DEPRECATED: use the overload with `options` instead. - static - int encodedLength(int inputLength); - BSLS_DEPRECATE_FEATURE("bdl", "encodedLength", "use overload with 'options'") + static + int encodedLength(int inputLength); + /// Return the exact number of encoded bytes that would result from an /// input byte sequence of the specified `inputLength` provided to the /// `convert` method of an encoder configured with the specified @@ -565,6 +562,9 @@ class Base64Encoder { /// *output* bytes. /// /// @DEPRECATED: use the overload with `options` instead. + BSLS_DEPRECATE_FEATURE("bdl", + "encodedLength", + "use overload with 'options'") static int encodedLength(int inputLength, int maxLineLength); @@ -576,9 +576,6 @@ class Base64Encoder { static bsl::size_t encodedLines(const EncoderOptions& options, bsl::size_t inputLength); - BSLS_DEPRECATE_FEATURE("bdl", - "encodedLines", - "use overload with 'options'") /// Return the exact number of encoded lines that would result from an /// input byte sequence of the specified `inputLength` provided to the /// `convert` method of an encoder with the maximum allowable @@ -588,12 +585,12 @@ class Base64Encoder { /// not be the number of *output* bytes. /// /// @DEPRECATED: use the overload with `options` instead. - static - int encodedLines(int inputLength); - BSLS_DEPRECATE_FEATURE("bdl", "encodedLines", "use overload with 'options'") + static + int encodedLines(int inputLength); + /// Return the exact number of encoded lines that would result from an /// input byte sequence of the specified `inputLength` provided to the /// `convert` method of an encoder configured with the specified @@ -604,6 +601,9 @@ class Base64Encoder { /// *output* bytes. /// /// @DEPRECATED: use the overload with `options` instead. + BSLS_DEPRECATE_FEATURE("bdl", + "encodedLines", + "use overload with 'options'") static int encodedLines(int inputLength, int maxLineLength); @@ -615,9 +615,6 @@ class Base64Encoder { explicit Base64Encoder(const EncoderOptions& options = EncoderOptions::mime()); - BSLS_DEPRECATE_FEATURE("bdl", - "Base64Encoder", - "use overload with 'options'") /// Create a Base64 encoder in the initial state, defaulting the maximum /// allowable line-length of the output to 76 (as recommended by the /// MIME standard). Optionally specify an alphabet used to encode @@ -627,12 +624,12 @@ class Base64Encoder { /// each line of the output from exceeding 76 characters. /// /// @DEPRECATED: Create and pass an `options` object instead. - explicit - Base64Encoder(Alphabet alphabet); - BSLS_DEPRECATE_FEATURE("bdl", "Base64Encoder", "use overload with 'options'") + explicit + Base64Encoder(Alphabet alphabet); + /// Create a Base64 encoder in the initial state, setting the maximum /// allowable line-length of the output to the specified /// `maxLineLength`. Specifying 0 for `maxLineLength` will result in a @@ -645,6 +642,9 @@ class Base64Encoder { /// output from exceeding `maxLineLength`. /// /// @DEPRECATED: Create and pass an `options` object instead. + BSLS_DEPRECATE_FEATURE("bdl", + "Base64Encoder", + "use overload with 'options'") explicit Base64Encoder(int maxLineLength, Alphabet alphabet = e_BASIC); diff --git a/groups/bdl/bdlt/bdlt_iso8601util.h b/groups/bdl/bdlt/bdlt_iso8601util.h index 1f7a7c8470..6103e648c7 100644 --- a/groups/bdl/bdlt/bdlt_iso8601util.h +++ b/groups/bdl/bdlt/bdlt_iso8601util.h @@ -1617,10 +1617,7 @@ struct Iso8601Util { #ifndef BDE_OMIT_INTERNAL_DEPRECATED // DEPRECATED METHODS - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// + /// Parse the specified initial `length` characters of the specified /// "relaxed" ISO 8601 `string` as a `Datetime` value, and load the /// value into the specified `result`. Return 0 on success, and a @@ -1646,14 +1643,14 @@ struct Iso8601Util { /// "24:00:00", then the fractional second must be absent or 0, and the /// zone designator must be absent or indicate UTC. The behavior is /// undefined unless `0 <= length`. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(Datetime *result, const char *string, ssize_t length); - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// /// Parse the specified initial `length` characters of the specified /// "relaxed" ISO 8601 `string` as a `DatetimeTz` value, and load the /// value into the specified `result`. Return 0 on success, and a @@ -1677,14 +1674,14 @@ struct Iso8601Util { /// "hh:mm:ss" portion of `string` is "24:00:00", then the fractional /// second must be absent or 0, and the zone designator must be absent /// or indicate UTC. The behavior is undefined unless `0 <= length`. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(DatetimeTz *result, const char *string, ssize_t length); - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// /// Parse the specified initial `length` characters of the specified /// "relaxed" ISO 8601 `string` as a `Datetime` or `DatetimeTz` value, /// depending on the presence of a zone designator, and load the value @@ -1710,14 +1707,14 @@ struct Iso8601Util { /// "hh:mm:ss" portion of `string` is "24:00:00", then the fractional /// second must be absent or 0, and the zone designator must be absent /// or indicate UTC. The behavior is undefined unless `0 <= length`. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(DatetimeOrDatetimeTz *result, const char *string, ssize_t length); - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// /// Parse the specified "relaxed" ISO 8601 `string` as a `Datetime` /// value, and load the value into the specified `result`. Return 0 on /// success, and a non-zero value (with no effect) otherwise. `string` @@ -1743,12 +1740,12 @@ struct Iso8601Util { /// second must be absent or 0, and the zone designator must be absent /// or indicate UTC. The behavior is undefined unless `string.data()` /// is non-null. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(Datetime *result, const bsl::string_view& string); - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// /// Parse the specified "relaxed" ISO 8601 `string` as a `DatetimeTz` /// value, and load the value into the specified `result`. Return 0 on /// success, and a non-zero value (with no effect) otherwise. `string` @@ -1772,13 +1769,13 @@ struct Iso8601Util { /// "24:00:00", then the fractional second must be absent or 0, and the /// zone designator must be absent or indicate UTC. The behavior is /// undefined unless `string.data()` is non-null. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(DatetimeTz *result, const bsl::string_view& string); - BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED - /// **DEPRECATED**: Use `parse` with `configuration.relaxed() == true` - /// instead. - /// /// Parse the specified "relaxed" ISO 8601 `string` as a `Datetime` or /// `DatetimeTz` value, depending on the presence of a zone designator, /// and load the value into the specified `result`. Return 0 on @@ -1804,9 +1801,15 @@ struct Iso8601Util { /// "24:00:00", then the fractional second must be absent or 0, and the /// zone designator must be absent or indicate UTC. The behavior is /// undefined unless `string.data()` is non-null. + /// + /// @DEPRECATED: Use `parse` with `configuration.relaxed() == true` + /// instead. + BDLT_ISO8601UTIL_DEPRECATE_PARSERELAXED static int parseRelaxed(DatetimeOrDatetimeTz *result, const bsl::string_view& string); + /// @DEPRECATED: Use the overloads taking the `bufferLength` argument + /// *before* the `object` argument instead. BDLT_ISO8601UTIL_DEPRECATE_GENERATE_ORDER static int generate(char *buffer, const Date& object, @@ -1828,12 +1831,12 @@ struct Iso8601Util { const TimeTz& object, ssize_t bufferLength); BDLT_ISO8601UTIL_DEPRECATE_GENERATE_ORDER - /// **DEPRECATED**: Use the overloads taking the `bufferLength` argument - /// *before* the `object` argument instead. static int generate(char *buffer, const DatetimeTz& object, ssize_t bufferLength); + /// @DEPRECATED: Use the overloads taking an `Iso8601UtilConfiguration` + /// object instead. BDLT_ISO8601UTIL_DEPRECATE_GENERATE static int generate(char *buffer, const DateTz& object, @@ -1845,13 +1848,13 @@ struct Iso8601Util { ssize_t bufferLength, bool useZAbbreviationForUtc); BDLT_ISO8601UTIL_DEPRECATE_GENERATE - /// **DEPRECATED**: Use the overloads taking an `Iso8601UtilConfiguration` - /// object instead. static int generate(char *buffer, const DatetimeTz& object, ssize_t bufferLength, bool useZAbbreviationForUtc); + /// @DEPRECATED: Use the overloads taking an `Iso8601UtilConfiguration` + /// object instead. BDLT_ISO8601UTIL_DEPRECATE_GENERATE static bsl::ostream& generate(bsl::ostream& stream, const DateTz& object, @@ -1861,12 +1864,12 @@ struct Iso8601Util { const TimeTz& object, bool useZAbbreviationForUtc); BDLT_ISO8601UTIL_DEPRECATE_GENERATE - /// **DEPRECATED**: Use the overloads taking an `Iso8601UtilConfiguration` - /// object instead. static bsl::ostream& generate(bsl::ostream& stream, const DatetimeTz& object, bool useZAbbreviationForUtc); + /// @DEPRECATED: Use the overloads taking an `Iso8601UtilConfiguration` + /// object instead. BDLT_ISO8601UTIL_DEPRECATE_GENERATERAW static int generateRaw(char *buffer, const DateTz& object, @@ -1876,8 +1879,6 @@ struct Iso8601Util { const TimeTz& object, bool useZAbbreviationForUtc); BDLT_ISO8601UTIL_DEPRECATE_GENERATERAW - /// **DEPRECATED**: Use the overloads taking an `Iso8601UtilConfiguration` - /// object instead. static int generateRaw(char *buffer, const DatetimeTz& object, bool useZAbbreviationForUtc); diff --git a/groups/bsl/bslstl/bslstl_function.h b/groups/bsl/bslstl/bslstl_function.h index a29ad2112a..5f15164a20 100644 --- a/groups/bsl/bslstl/bslstl_function.h +++ b/groups/bsl/bslstl/bslstl_function.h @@ -712,11 +712,12 @@ template struct Function_ArgTypes { // PUBLIC TYPES + + /// @DEPRECATED: This typedef is deprecated in C++17, for details see + /// https://isocpp.org/files/papers/p0005r4.html. BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see - /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG argument_type; }; @@ -727,17 +728,18 @@ template struct Function_ArgTypes { // PUBLIC TYPES + + /// @DEPRECATED: This typedef is deprecated in C++17, for details see + /// https://isocpp.org/files/papers/p0005r4.html. BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see - /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG1 first_argument_type; BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see + /// @DEPRECATED: This typedef is deprecated in C++17, for details see /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG2 second_argument_type; }; @@ -1360,35 +1362,34 @@ class function : public BloombergLP::bslstl::Function_Variadic { #ifndef BDE_OMIT_INTERNAL_DEPRECATED // LEGACY METHODS - /// **DEPRECATED**: Use `bsl::function` instead of `bdef_Function`. - /// /// Return `*this`, converted to a mutable `bdef_Function` reference by /// downcasting. The behavior is undefined unless `bdef_Function` /// is derived from `bsl::function` and adds no new data members. + /// + /// @DEPRECATED: Use `bsl::function` instead of `bdef_Function`. operator BloombergLP::bdef_Function&() BSLS_KEYWORD_NOEXCEPT; - /// **DEPRECATED**: Use `bsl::function` instead of `bdef_Function`. - /// /// Return `*this` converted to a const `bdef_Function` reference by /// downcasting. The behavior is undefined unless `bdef_Function` /// is derived from `bsl::function` and adds no new data members. + /// + /// @DEPRECATED: Use `bsl::function` instead of `bdef_Function`. operator const BloombergLP::bdef_Function&() const BSLS_KEYWORD_NOEXCEPT; // LEGACY ACCESSORS - /// **DEPRECATED**: Use `get_allocator()` instead. + /// Return `get_allocator().mechanism()`. Note that this function exists + /// for BDE compatibility and is not part of the C++ Standard Library. /// - /// Return `get_allocator().mechanism()`. Note that this function - /// exists for BDE compatibility and is not part of the C++ Standard - /// Library. + /// @DEPRECATED: Use `get_allocator()` instead. BloombergLP::bslma::Allocator *allocator() const BSLS_KEYWORD_NOEXCEPT; - /// **DEPRECATED**: Runtime checking of this optimization is discouraged. - /// /// Return `true` if this `function` is empty or if it is non-empty and /// its target qualifies for the small-object optimization (and is thus /// allocated within this object's footprint); otherwise, return false. + /// + /// @DEPRECATED: Runtime checking of this optimization is discouraged. bool isInplace() const BSLS_KEYWORD_NOEXCEPT; #endif }; diff --git a/groups/bsl/bslstl/bslstl_function_cpp03.h b/groups/bsl/bslstl/bslstl_function_cpp03.h index bff2cb7079..48f7154b82 100644 --- a/groups/bsl/bslstl/bslstl_function_cpp03.h +++ b/groups/bsl/bslstl/bslstl_function_cpp03.h @@ -21,7 +21,7 @@ // regions of C++11 code, then this header contains no code and is not // '#include'd in the original header. // -// Generated on Fri Nov 1 20:56:35 2024 +// Generated on Wed Nov 6 15:08:55 2024 // Command line: sim_cpp11_features.pl bslstl_function.h #ifdef COMPILING_BSLSTL_FUNCTION_H @@ -89,11 +89,12 @@ template struct Function_ArgTypes { // PUBLIC TYPES + + /// @DEPRECATED: This typedef is deprecated in C++17, for details see + /// https://isocpp.org/files/papers/p0005r4.html. BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see - /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG argument_type; }; @@ -104,17 +105,18 @@ template struct Function_ArgTypes { // PUBLIC TYPES + + /// @DEPRECATED: This typedef is deprecated in C++17, for details see + /// https://isocpp.org/files/papers/p0005r4.html. BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see - /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG1 first_argument_type; BSLS_DEPRECATE_FEATURE("bsl", "deprecated_cpp17_standard_library_features", "do not use") - /// **DEPRECATED**: This typedef is deprecated in C++17, for details see + /// @DEPRECATED: This typedef is deprecated in C++17, for details see /// https://isocpp.org/files/papers/p0005r4.html. typedef ARG2 second_argument_type; }; @@ -1660,35 +1662,34 @@ class function : public BloombergLP::bslstl::Function_Variadic { #ifndef BDE_OMIT_INTERNAL_DEPRECATED // LEGACY METHODS - /// **DEPRECATED**: Use `bsl::function` instead of `bdef_Function`. - /// /// Return `*this`, converted to a mutable `bdef_Function` reference by /// downcasting. The behavior is undefined unless `bdef_Function` /// is derived from `bsl::function` and adds no new data members. + /// + /// @DEPRECATED: Use `bsl::function` instead of `bdef_Function`. operator BloombergLP::bdef_Function&() BSLS_KEYWORD_NOEXCEPT; - /// **DEPRECATED**: Use `bsl::function` instead of `bdef_Function`. - /// /// Return `*this` converted to a const `bdef_Function` reference by /// downcasting. The behavior is undefined unless `bdef_Function` /// is derived from `bsl::function` and adds no new data members. + /// + /// @DEPRECATED: Use `bsl::function` instead of `bdef_Function`. operator const BloombergLP::bdef_Function&() const BSLS_KEYWORD_NOEXCEPT; // LEGACY ACCESSORS - /// **DEPRECATED**: Use `get_allocator()` instead. + /// Return `get_allocator().mechanism()`. Note that this function exists + /// for BDE compatibility and is not part of the C++ Standard Library. /// - /// Return `get_allocator().mechanism()`. Note that this function - /// exists for BDE compatibility and is not part of the C++ Standard - /// Library. + /// @DEPRECATED: Use `get_allocator()` instead. BloombergLP::bslma::Allocator *allocator() const BSLS_KEYWORD_NOEXCEPT; - /// **DEPRECATED**: Runtime checking of this optimization is discouraged. - /// /// Return `true` if this `function` is empty or if it is non-empty and /// its target qualifies for the small-object optimization (and is thus /// allocated within this object's footprint); otherwise, return false. + /// + /// @DEPRECATED: Runtime checking of this optimization is discouraged. bool isInplace() const BSLS_KEYWORD_NOEXCEPT; #endif };