Writing Integer Values to Files in Python: Methods and Formatting Techniques

Problem Context and Error Analysis

In Python programming, when attempting to write integers to files using the outf.write(num) statement, developers frequently encounter the error: TypeError: argument 1 must be string or read-only character buffer, not int. The root cause of this error lies in the fact that Python's file object write() method only accepts string-type arguments, while integers are numerical types that require conversion before writing.

Basic Solutions: Integer to String Conversion

The core solution to this problem involves converting integers to strings. Python offers multiple implementation approaches:

The simplest and most direct method uses the str() function:

outf.write(str(num))

This approach is straightforward and suitable for most basic scenarios. However, in practical development, finer control over output formatting is often required.

Detailed Formatting Methods

Python's string formatting provides more powerful output control capabilities. Two main approaches are currently prevalent:

format() method (recommended): This is the preferred formatting approach in Python 3, featuring clear syntax and robust functionality:

outf.write('{}'.format(num))

% formatting operator: This traditional formatting method, while less recommended in new code, may still be encountered when maintaining legacy code:

outf.write('%d' % num)

It's important to note that the write() method does not automatically append newline characters. If line breaks are needed, they must be explicitly provided:

outf.write(str(num) + '\n')

Advanced Formatting Techniques

Through formatted strings, more complex output requirements can be achieved. For example, controlling number width and padding characters:

# Output 3-digit numbers with zero-padding and newline
outf.write('{:03d}\n'.format(num))

Or using traditional formatting:

outf.write('%03d\n' % num)

For numbers 7 and 12, the above code will output:

007
012

This formatting approach is particularly useful in scenarios such as generating log files with fixed formats or data reports.

Performance and Best Practices

In practical applications, beyond functional correctness, performance considerations are essential. For writing large volumes of data, it is recommended to:

1. Use string concatenation or the join() method for batch processing to reduce frequent write calls
2. Consider using context managers (with statements) to ensure proper file closure
3. Select appropriate encoding methods based on specific requirements

For example, batch writing multiple numbers:

numbers = [1, 2, 3, 4, 5]
formatted_lines = ['{}\n'.format(num) for num in numbers]
outf.writelines(formatted_lines)

Conclusion and Extensions

Mastering integer-to-string conversion is a fundamental skill in Python file operations. With the evolution of Python versions, the format() method has become the preferred choice due to its clear syntax and powerful functionality. Developers should select appropriate formatting methods based on specific requirements and pay attention to file writing details such as newline handling and encoding settings to ensure generated files meet expected formats.