<p dir="ltr"></p>
<p dir="ltr">Il 26/ago/2016 16:28, "Yong Bakos" <<a href="mailto:junk@humanoriented.com">junk@humanoriented.com</a>> ha scritto:<br>
><br>
> On Aug 26, 2016, at 2:12 AM, Giulio Camuffo <<a href="mailto:giuliocamuffo@gmail.com">giuliocamuffo@gmail.com</a>> wrote:<br>
> ><br>
> > Hi,<br>
> ><br>
> ><br>
> >><br>
> >> +/**<br>
> >> + * Removes an element from the list.<br>
> >> + *<br>
> >> + * \param elm element to remove from the list<br>
> >> + */<br>
> > I think this should mention that elm is left in an invalid state, and<br>
> > the user should call wl_list_init on it before using it again.<br>
> ><br>
> > Cheers,<br>
> > Giulio<br>
><br>
> Thanks Giulio. Or, should wl_list_remove be modified to ensure that<br>
> next and prev point to elm? (Either way, I'll add the details to<br>
> the dox.)</p>
<p dir="ltr">This has been discussed in the past but there wasn't a consensus about changing the behavior so I think it's best to just add a note in the docs. </p>
<p dir="ltr">Cheers, <br>
Giulio </p>
<p dir="ltr">><br>
> yong<br>
><br>
><br>
> >> void<br>
> >> wl_list_remove(struct wl_list *elm);<br>
> >><br>
> >> +/**<br>
> >> + * Determines the length of the list.<br>
> >> + *<br>
> >> + * \note This is an O(n) operation.<br>
> >> + *<br>
> >> + * \param list list whose length is to be determined<br>
> >> + *<br>
> >> + * \return number of elements in the list<br>
> >> + */<br>
> >> int<br>
> >> wl_list_length(const struct wl_list *list);<br>
> >><br>
> >> +/**<br>
> >> + * Determines if the list is empty.<br>
> >> + *<br>
> >> + * \param list list whose emptiness is to be determined<br>
> >> + *<br>
> >> + * \return 1 if empty, or 0 if not empty<br>
> >> + */<br>
> >> int<br>
> >> wl_list_empty(const struct wl_list *list);<br>
> >><br>
> >> +/**<br>
> >> + * Inserts all of the elements of one list into another, after the element<br>
> >> + * represented by `list`.<br>
> >> + *<br>
> >> + * \param list list element after which the other list elements will be inserted<br>
> >> + * \param other list of elements to insert<br>
> >> + *<br>
> >> + */<br>
> >> void<br>
> >> wl_list_insert_list(struct wl_list *list, struct wl_list *other);<br>
> >><br>
> >> --<br>
> >> 2.7.2<br>
> >><br>
> >> _______________________________________________<br>
> >> wayland-devel mailing list<br>
> >> <a href="mailto:wayland-devel@lists.freedesktop.org">wayland-devel@lists.freedesktop.org</a><br>
> >> <a href="https://lists.freedesktop.org/mailman/listinfo/wayland-devel">https://lists.freedesktop.org/mailman/listinfo/wayland-devel</a><br>
> > _______________________________________________<br>
> > wayland-devel mailing list<br>
> > <a href="mailto:wayland-devel@lists.freedesktop.org">wayland-devel@lists.freedesktop.org</a><br>
> > <a href="https://lists.freedesktop.org/mailman/listinfo/wayland-devel">https://lists.freedesktop.org/mailman/listinfo/wayland-devel</a><br>
></p>