mirror of
https://github.com/viq/NewsBlur.git
synced 2025-08-05 16:49:45 +00:00
66 lines
No EOL
2.2 KiB
Objective-C
66 lines
No EOL
2.2 KiB
Objective-C
//
|
|
// GTMNSString+HTML.h
|
|
// Dealing with NSStrings that contain HTML
|
|
//
|
|
// Copyright 2006-2008 Google Inc.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License"); you may not
|
|
// use this file except in compliance with the License. You may obtain a copy
|
|
// of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
// License for the specific language governing permissions and limitations under
|
|
// the License.
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
/// Utilities for NSStrings containing HTML
|
|
@interface NSString (GTMNSStringHTMLAdditions)
|
|
|
|
/// Get a string where internal characters that need escaping for HTML are escaped
|
|
//
|
|
/// For example, '&' become '&'. This will only cover characters from table
|
|
/// A.2.2 of http://www.w3.org/TR/xhtml1/dtds.html#a_dtd_Special_characters
|
|
/// which is what you want for a unicode encoded webpage. If you have a ascii
|
|
/// or non-encoded webpage, please use stringByEscapingAsciiHTML which will
|
|
/// encode all characters.
|
|
///
|
|
/// For obvious reasons this call is only safe once.
|
|
//
|
|
// Returns:
|
|
// Autoreleased NSString
|
|
//
|
|
- (NSString *)gtm_stringByEscapingForHTML;
|
|
|
|
/// Get a string where internal characters that need escaping for HTML are escaped
|
|
//
|
|
/// For example, '&' become '&'
|
|
/// All non-mapped characters (unicode that don't have a &keyword; mapping)
|
|
/// will be converted to the appropriate &#xxx; value. If your webpage is
|
|
/// unicode encoded (UTF16 or UTF8) use stringByEscapingHTML instead as it is
|
|
/// faster, and produces less bloated and more readable HTML (as long as you
|
|
/// are using a unicode compliant HTML reader).
|
|
///
|
|
/// For obvious reasons this call is only safe once.
|
|
//
|
|
// Returns:
|
|
// Autoreleased NSString
|
|
//
|
|
- (NSString *)gtm_stringByEscapingForAsciiHTML;
|
|
|
|
/// Get a string where internal characters that are escaped for HTML are unescaped
|
|
//
|
|
/// For example, '&' becomes '&'
|
|
/// Handles   and 2 cases as well
|
|
///
|
|
// Returns:
|
|
// Autoreleased NSString
|
|
//
|
|
- (NSString *)gtm_stringByUnescapingFromHTML;
|
|
|
|
@end |