If the stream begins with a BOM (byte order marker), consumes the BOM and sets the external encoding accordingly; returns the result encoding if found, or nil otherwise:
File.write('t.tmp', "\u{FEFF}abc") io = File.open('t.tmp', 'rb') io.set_encoding_by_bom # => #<Encoding:UTF-8> io.close File.write('t.tmp', 'abc') io = File.open('t.tmp', 'rb') io.set_encoding_by_bom # => nil io.close
Raises an exception if the stream is not binmode or its encoding has already been set.
Open the specified filename (either in read-only mode or in read-write mode) and lock it for reading or writing.
The opened File object will be returned. If read_only is true, and the file does not exist, then nil will be returned.
All exceptions are propagated.
Returns the last win32 socket Error of the current executing Thread or nil if none
Sets the last win32 socket Error of the current executing Thread to error
Add a list of paths to the $LOAD_PATH at the proper place.
Returns a URL-encoded string derived from the given string str.
The returned string:
Preserves:
Characters '*', '.', '-', and '_'.
Character in ranges 'a'..'z', 'A'..'Z', and '0'..'9'.
Example:
URI.encode_www_form_component('*.-_azAZ09') # => "*.-_azAZ09"
Converts:
Character ' ' to character '+'.
Any other character to “percent notation”; the percent notation for character c is '%%%X' % c.ord.
Example:
URI.encode_www_form_component('Here are some punctuation characters: ,;?:') # => "Here+are+some+punctuation+characters%3A+%2C%3B%3F%3A"
Encoding:
If str has encoding Encoding::ASCII_8BIT, argument enc is ignored.
Otherwise str is converted first to Encoding::UTF_8 (with suitable character replacements), and then to encoding enc.
In either case, the returned string has forced encoding Encoding::US_ASCII.
Related: URI.encode_uri_component (encodes ' ' as '%20').
Returns a string decoded from the given URL-encoded string str.
The given string is first encoded as Encoding::ASCII-8BIT (using String#b), then decoded (as below), and finally force-encoded to the given encoding enc.
The returned string:
Preserves:
Characters '*', '.', '-', and '_'.
Character in ranges 'a'..'z', 'A'..'Z', and '0'..'9'.
Example:
URI.decode_www_form_component('*.-_azAZ09') # => "*.-_azAZ09"
Converts:
Character '+' to character ' '.
Each “percent notation” to an ASCII character.
Example:
URI.decode_www_form_component('Here+are+some+punctuation+characters%3A+%2C%3B%3F%3A') # => "Here are some punctuation characters: ,;?:"
Related: URI.decode_uri_component (preserves '+').
Returns the string that is used to insert a space before the ‘:’ in JSON objects.
Sets the string that is used to insert a space before the ‘:’ in JSON objects.
This string is put at the end of a line that holds a JSON array.
This string is put at the end of a line that holds a JSON array.
This integer returns the maximum level of data structure nesting in the generated JSON, max_nesting = 0 if no maximum is checked.
This sets the maximum level of data structure nesting in the generated JSON to the integer depth, max_nesting = 0 if no maximum should be checked.
If this boolean is true, the forward slashes will be escaped in the json output.
If this boolean is true, the forward slashes will be escaped in the json output.
This sets whether or not the forward slashes will be escaped in the json output.
Returns true, if circular data structures should be checked, otherwise returns false.
Returns true, if only ASCII characters should be generated. Otherwise returns false.
See the OpenSSL documentation for i2d_ECPKParameters_bio()