[avr-libc-dev] [bug #44520] time.h mentions a "best effort representation" but does not explain it

[Gregor Riepl]

URL:
  <http://savannah.nongnu.org/bugs/?44520>

                 Summary: time.h mentions a "best effort representation" but
does not explain it
                 Project: AVR C Runtime Library
            Submitted by: onitake
            Submitted on: Thu 12 Mar 2015 03:20:48 PM GMT
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Header files
                  Status: None
        Percent Complete: 0%
             Assigned to: None
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: Unknown
           Fixed Release: None

    _______________________________________________________

Details:

This bug report applies to avr-libc 1.8.1.

The documentation for time.h mentions the following:

  Section 7.23.2.3 mktime() The standard specifies that mktime() should return
(time_t) -1, if the time cannot be represented. This implementation always
returns a 'best effort' representation.

Please explain what "best effort" means in this context, and also add relevant
information to the documentation of mktime and gm_mktime.

I assume these two functions clamp the value of the returned time_t to
[0,UINT32_MAX], but is that the only limitation?




    _______________________________________________________

Reply to this item at:

  <http://savannah.nongnu.org/bugs/?44520>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.nongnu.org/