Что означает io.IOBase.readlines(подсказка) в python?

Question

Из документа:

readlines(hint=-1)
    Read and return a list of lines from the stream. 
    hint can be specified to control the number of lines read: 
      no more lines will be read if the total size (in bytes/characters) of all lines so far exceeds hint.

В чем реальный смысл подсказки?

В некоторых средах:

python3 -c 'from io import StringIO;print(StringIO(u"hello\n"*10).readlines(6));import sys;print(sys.version_info[0:3])'
['hello\n', 'hello\n']
(3, 3, 0)

python -c 'from io import StringIO;print(StringIO(u"hello\n"*10).readlines(6));import sys;print(sys.version_info[0:3])'
[u'hello\n', u'hello\n']
(2, 7, 2)

python -c 'from io import StringIO;print(StringIO(u"hello\n"*10).readlines(6));import sys;print(sys.version_info[0:3])'
[u'hello\n']
(2, 6, 6)

Почему более 6 символов?

Кто-то сказал, что это зависит от размера буфера.

Но на моей машине я не могу отменить буфер ввода / вывода текста.

>>> import sys
>>> sys.version
'3.3.0 (v3.3.0:bd8afb90ebf2, Sep 29 2012, 01:25:11) \n[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)]'
>>> open('/etc/hosts','r',3).readlines(3)
['##\n', '# Host Database\n']
>>> open('/etc/hosts','r',0).readlines(3)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: can't have unbuffered text I/O
>>> 

Или это ошибка в этом методе?

---

2013/02/25 Обновлено:

Я проверяю источник(из python 2.6 / 2.7 / 3.x), но не могу объяснить это:

def readlines(self, hint=None):
    """Return a list of lines from the stream.

    hint can be specified to control the number of lines read: no more
    lines will be read if the total size (in bytes/characters) of all
    lines so far exceeds hint.
    """
    if hint is None or hint <= 0:
        return list(self)
    n = 0
    lines = []
    for line in self:
        lines.append(line)
        n += len(line)
        if n >= hint:
            break
    return lines

Answer 1

Я нашел разницу от StringIO и BytesIO(но я понятия не имею, почему):

Сначала проверьте это (python 2.7/3.3):

Python 2.7.2 (default, Jun 20 2012, 16:23:33) 
[GCC 4.2.1 Compatible Apple Clang 4.0 (tags/Apple/clang-418.0.60)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> from io import BytesIO,StringIO
>>> print(BytesIO(b'hello\n'*10).readlines(6))
['hello\n']
>>> print(StringIO(u'hello\n'*10).readlines(6))
[u'hello\n', u'hello\n']
>>> 

Исходные коды C от StringIO и BytesIO можно найти здесь:

Модули / _io / iobase.C# l591

620     while (1) {
621         PyObject *line = PyIter_Next(self);
622         if (line == NULL) {
623             if (PyErr_Occurred()) {
624                 Py_DECREF(result);
625                 return NULL;
626             }
627             else
628                 break; /* StopIteration raised */
629         }
630 
631         if (PyList_Append(result, line) < 0) {
632             Py_DECREF(line);
633             Py_DECREF(result);
634             return NULL;
635         }
636         length += PyObject_Size(line);
637         Py_DECREF(line);
638 
639         if (length > hint)
640             break;
641     }

---

Модули / _io / bytesio.C# L380

413     while ((n = get_line(self, &output)) != 0) {
414         line = PyBytes_FromStringAndSize(output, n);
415         if (!line)
416             goto on_error;
417         if (PyList_Append(result, line) == -1) {
418             Py_DECREF(line);
419             goto on_error;
420         }
421         Py_DECREF(line);
422         size += n;
423         if (maxsize > 0 && size >= maxsize)
424             break;
425     }
426     return result;

Answer 2

Это задокументировано, следовательно, не ошибка:

buffering необязательное целое число, используемое для установки политики буферизации Проходить 0 отключить буферизацию (разрешено только в двоичном режиме), 1 выбрать буферизацию строки (используется только в текстовом режиме) и целое число> 1 указать размер куска буфера фиксированного размера.

Чтобы ответить на ваш вопрос: "Почему более 6 символов?"

Это также задокументировано: readlines всегда возвращает полные строки:

подсказка может быть указана для контроля количества прочитанных строк: больше строк не будет считываться, если общий размер (в байтах / символах) всех строк до сих пор превышает подсказку.

Это означает: прочитайте еще одну целую строку; если total read size > hintтогда перестань читать.

В вашем примере после прочтения первого "hello" размер еще не превышен, поэтому читается вторая строка.