/** * Sets the value of an option in a section, if the option exist, otherwise * adds the option to the section. Trims white space from the start and the * end of the value and deletes newline characters it might contain. * * @param section the section's name * @param option the option's name * @param value the option's value * @throws IniEditor.NoSuchSectionException no section with the given name exists * @throws IllegalArgumentException the option name is illegal, * ie contains a '=' character or consists only of white space * @throws NullPointerException section or option are <code>null</code> */ public void set(String section, String option, String value) { if (hasSection(section)) { getSection(section).set(option, value); } else { throw new NoSuchSectionException(section); } }
/** * Adds a comment line to the end of a section. A comment spanning * several lines (ie with line breaks) will be split up, one comment * line for each line. * * @param section the section's name * @param comment the comment * @throws IniEditor.NoSuchSectionException no section with the given name exists */ public void addComment(String section, String comment) { if (hasSection(section)) { getSection(section).addComment(comment); } else { throw new NoSuchSectionException(section); } }
/** * Returns all option names of a section, not including options from the * common section. * * @param section the section's name * @return list of option names * @throws IniEditor.NoSuchSectionException no section with the given name exists */ public List<String> optionNames(String section) { if (hasSection(section)) { return getSection(section).optionNames(); } else { throw new NoSuchSectionException(section); } }
/** * Removes an option from a section if it exists. Will not remove options * from the common section if it's not directly addressed. * * @param section the section's name * @param option the option's name * @return <code>true</code> if the option was actually removed * @throws IniEditor.NoSuchSectionException no section with the given name exists */ public boolean remove(String section, String option) { if (hasSection(section)) { return getSection(section).remove(option); } else { throw new NoSuchSectionException(section); } }
/** * Adds a blank line to the end of a section. * * @param section the section's name * @throws IniEditor.NoSuchSectionException no section with the given name exists */ public void addBlankLine(String section) { if (hasSection(section)) { getSection(section).addBlankLine(); } else { throw new NoSuchSectionException(section); } }