Class: NSString

Inherits:
Object show all
Defined in:
lib/ios/sugarcube-ui/nsstring.rb,
lib/osx/sugarcube-ui/nsstring.rb,
lib/all/sugarcube-unholy/ivar.rb,
lib/osx/sugarcube-color/nsstring.rb,
lib/ios/sugarcube-color/nsstring.rb,
lib/cocoa/sugarcube-files/nsstring.rb,
lib/cocoa/sugarcube-nsdata/nsstring.rb,
lib/cocoa/sugarcube-nsdate/nsstring.rb,
lib/cocoa/sugarcube-numbers/nsstring.rb,
lib/cocoa/sugarcube-localized/nsstring.rb,
lib/cocoa/sugarcube-foundation/nsstring.rb,
lib/cocoa/sugarcube-files/nsstring_deprecated.rb,
lib/cocoa/sugarcube-notifications/notifications.rb,
lib/ios/sugarcube-attributedstring/nsattributedstring.rb,
lib/osx/sugarcube-attributedstring/nsattributedstring.rb,
lib/cocoa/sugarcube-attributedstring/nsattributedstring.rb

Instance Method Summary collapse

Instance Method Details

#add_observer(target, action, object = nil) ⇒ Object



24
25
26
27
28
29
# File 'lib/cocoa/sugarcube-notifications/notifications.rb', line 24

def add_observer(target, action, object=nil)
  NSNotificationCenter.defaultCenter.addObserver(target,
    selector: action,
    name: self,
    object: object)
end

#app_supportObject

This method will be removed in iOS 9



16
17
18
19
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 16

def app_support
  SugarCube.log('Warning: SugarCube\'s String#app_support method has been deprecated in favor of String#app_support_path')
  self.app_support_path
end

#app_support_pathObject



17
18
19
20
21
22
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 17

def app_support_path
  @@sugarcube_app_suppert ||= NSSearchPathForDirectoriesInDomains(NSApplicationSupportDirectory, NSUserDomainMask, true)[0]
  return self if self.hasPrefix(@@sugarcube_app_suppert)

  @@sugarcube_app_suppert.stringByAppendingPathComponent(self)
end

#attrd(attributes = {}) ⇒ Object



7
8
9
# File 'lib/cocoa/sugarcube-attributedstring/nsattributedstring.rb', line 7

def attrd(attributes={})
  self.nsattributedstring(attributes)
end

#attributed_htmlObject



11
12
13
14
# File 'lib/cocoa/sugarcube-attributedstring/nsattributedstring.rb', line 11

def attributed_html
  options = {NSDocumentTypeDocumentAttribute => NSHTMLTextDocumentType}
  NSAttributedString.alloc.initWithData(self.dataUsingEncoding(NSUTF8StringEncoding), options:options, documentAttributes:nil, error:nil)
end

#bold(size = nil) ⇒ Object



3
4
5
6
# File 'lib/ios/sugarcube-attributedstring/nsattributedstring.rb', line 3

def bold(size=nil)
  font = :bold.uifont(size)
  nsattributedstring({ NSFontAttributeName => font })
end

#cacheObject

This method will be removed in iOS 9



10
11
12
13
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 10

def cache
  SugarCube.log('Warning: SugarCube\'s String#cache method has been deprecated in favor of String#cache_path')
  self.cache_path
end

#cache_pathObject



10
11
12
13
14
15
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 10

def cache_path
  @@sugarcube_caches ||= NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, true)[0]
  return self if self.hasPrefix(@@sugarcube_caches)

  @@sugarcube_caches.stringByAppendingPathComponent(self)
end

#cgcolor(alpha = nil) ⇒ Object



16
17
18
# File 'lib/osx/sugarcube-color/nsstring.rb', line 16

def cgcolor(alpha=nil)
  nscolor(alpha).CGColor
end

#cvarObject



29
30
31
# File 'lib/all/sugarcube-unholy/ivar.rb', line 29

def cvar
  "@@#{self}"
end

#documentObject

This method will be removed in iOS 9



4
5
6
7
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 4

def document
  SugarCube.log('Warning: SugarCube\'s String#document method has been deprecated in favor of String#document_path')
  self.document_path
end

#document_pathObject



3
4
5
6
7
8
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 3

def document_path
  @@sugarcube_docs ||= NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0]
  return self if self.hasPrefix(@@sugarcube_docs)

  @@sugarcube_docs.stringByAppendingPathComponent(self)
end

#escape_urlObject



13
14
15
16
17
18
19
20
21
# File 'lib/cocoa/sugarcube-foundation/nsstring.rb', line 13

def escape_url
  CFURLCreateStringByAddingPercentEscapes(
          nil,
          self,
          nil,
          "!*'();:@&=+$,/?%#[]",
          CFStringConvertNSStringEncodingToEncoding(NSUTF8StringEncoding)
          )
end

#exists?Boolean

This method will be removed in iOS 9

Returns:

  • (Boolean)


28
29
30
31
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 28

def exists?
  SugarCube.log('Warning: SugarCube\'s String#exists? method has been deprecated in favor of String#file_exists?')
  self.file_exists?
end

#file_exists?Boolean

Returns:

  • (Boolean)


31
32
33
34
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 31

def file_exists?
  path = self.hasPrefix('/') ? self : self.document_path
  NSFileManager.defaultManager.fileExistsAtPath(path)
end

#file_urlObject



60
61
62
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 60

def file_url
  NSURL.fileURLWithPath(self)
end

#fileurlNSURL

Returns:



9
10
11
# File 'lib/cocoa/sugarcube-foundation/nsstring.rb', line 9

def fileurl
  @fileurl ||= NSURL.fileURLWithPath(self)
end

#info_plistObject

It's convenient to store a property which is dependent on an environment to Info.plist. For instance, to use a different server between development and release versions.

In Rakefile app.release do app.info_plist['VerifyURL'] = "https://buy.itunes.apple.com/verifyReceipt" end app.development do app.info_plist['VerifyURL'] = "https://sandbox.itunes.apple.com/verifyReceipt" end

You can easily get this value at run time like this: 'VerifyURL'.info_plist



82
83
84
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 82

def info_plist
  NSBundle.mainBundle.infoDictionary.valueForKey self
end

#italic(size = nil) ⇒ Object



8
9
10
11
# File 'lib/ios/sugarcube-attributedstring/nsattributedstring.rb', line 8

def italic(size=nil)
  font = :italic.uifont(size)
  nsattributedstring({ NSFontAttributeName => font })
end

#ivarObject



21
22
23
# File 'lib/all/sugarcube-unholy/ivar.rb', line 21

def ivar
  "@#{self}"
end

#localized(value = nil, table = nil) ⇒ Object Also known as: _

This can be called as "Hello".localized or "Hello"._. The str._ syntax is meant to be reminiscent of gettext-style _(str).



5
6
7
# File 'lib/cocoa/sugarcube-localized/nsstring.rb', line 5

def localized(value=nil, table=nil)
  NSBundle.mainBundle.localizedStringForKey(self, value: value, table: table)
end

#monospace(size = nil) ⇒ Object



13
14
15
16
# File 'lib/ios/sugarcube-attributedstring/nsattributedstring.rb', line 13

def monospace(size=nil)
  font = :monospace.uifont(size)
  nsattributedstring({ NSFontAttributeName => font })
end

#nan?(style = NSNumberFormatterDecimalStyle) ⇒ Boolean

Returns boolean

Returns:

  • (Boolean)

    boolean



4
5
6
# File 'lib/cocoa/sugarcube-numbers/nsstring.rb', line 4

def nan?(style=NSNumberFormatterDecimalStyle)
  self.to_number(style).nil?
end

#nsattributedstring(attributes = {}) ⇒ Object



3
4
5
# File 'lib/cocoa/sugarcube-attributedstring/nsattributedstring.rb', line 3

def nsattributedstring(attributes={})
  NSAttributedString.alloc.initWithString(self, attributes: attributes)
end

#nscolor(alpha = nil) ⇒ NSColor

Returns:



4
5
6
7
8
9
10
11
12
13
14
# File 'lib/osx/sugarcube-color/nsstring.rb', line 4

def nscolor(alpha=nil)
  if self[0,1] == '#'
    if self.length == 4
      return (self[1] * 2 + self[2] * 2 + self[3] * 2).to_i(16).nscolor(alpha)
    end
    return self[1..-1].to_i(16).nscolor(alpha)
  end

  img = NSImage.imageNamed(self)
  img && img.nscolor(alpha)
end

#nsdata(encoding = NSUTF8StringEncoding) ⇒ NSData

Returns NSData representation encoded using UTF8, or a specified encoding

Returns:

  • (NSData)

    NSData representation encoded using UTF8, or a specified encoding



5
6
7
# File 'lib/cocoa/sugarcube-nsdata/nsstring.rb', line 5

def nsdata(encoding=NSUTF8StringEncoding)
  dataUsingEncoding(encoding)
end

#nsdateObject

checks ISO8601 formats before falling back on natural language detection



4
5
6
# File 'lib/cocoa/sugarcube-nsdate/nsstring.rb', line 4

def nsdate
  SugarCube::DateParser.iso8601(self) || SugarCube::DateParser.parse_date(self)
end

#nsfont(size = nil) ⇒ NSFont

Returns:



11
12
13
14
# File 'lib/osx/sugarcube-ui/nsstring.rb', line 11

def nsfont(size=nil)
  size ||= NSFont.systemFontSize
  NSFont.fontWithName(self, size: size)
end

#nsimageNSImage

Returns:



4
5
6
7
8
# File 'lib/osx/sugarcube-ui/nsstring.rb', line 4

def nsimage
  NSImage.imageNamed(self).tap do |retval|
    NSLog("No image named #{self}") unless retval
  end
end

#nsimageviewNSImageView

Returns:

  • (NSImageView)


32
33
34
35
36
37
38
39
# File 'lib/osx/sugarcube-ui/nsstring.rb', line 32

def nsimageview
  image_view = NSImageView.alloc.init
  image_view.image = self.nsimage
  frame = image_view.frame
  frame.size = image_view.intrinsicContentSize
  image_view.frame = frame
  return image_view
end

#nslabel(font = nil) ⇒ NSLabel

Parameters:

  • font (NSFont) (defaults to: nil)

    Optional, defaults to NSFont.systemFontOfSize(NSFont.systemFontSize)

Returns:

  • (NSLabel)


18
19
20
21
22
23
24
25
26
27
28
29
# File 'lib/osx/sugarcube-ui/nsstring.rb', line 18

def nslabel(font=nil)
  font ||= :system.nsfont(NSFont.labelFontSize)
  size = self.sizeWithAttributes({ NSFontAttributeName => font })
  label = NSTextField.alloc.initWithFrame([[0, 0], size])
  label.bezeled = false
  label.drawsBackground = false
  label.editable = false
  label.selectable = false
  label.stringValue = self
  label.font = font
  return label
end

#nstimezoneObject



8
9
10
11
12
13
14
15
16
17
18
19
# File 'lib/cocoa/sugarcube-nsdate/nsstring.rb', line 8

def nstimezone
  case self
  when /([+-]?\d{4})/
    sec = $1[-4,2].to_i * 3600
    NSTimeZone.timeZoneForSecondsFromGMT(sec)
  when /(GMT|UTC)([+-]\d{1,2})?/
    sec = $2 ? $2.to_i * 3600 : 0
    NSTimeZone.timeZoneForSecondsFromGMT(sec)
  else
    NSTimeZone.timeZoneWithName(self)
  end
end

#nsurlNSURL

Returns:



4
5
6
# File 'lib/cocoa/sugarcube-foundation/nsstring.rb', line 4

def nsurl
  @url ||= NSURL.alloc.initWithString(self)
end

#post_notification(object = nil, user_info = nil) ⇒ Object



12
13
14
15
16
17
18
19
20
21
22
# File 'lib/cocoa/sugarcube-notifications/notifications.rb', line 12

def post_notification(object=nil, =nil)
  if  && ! .is_a?(Hash)
    raise TypeError("Invalid argument #{.class.to_s} sent to String.post_notification")
  end

  if 
    NSNotificationCenter.defaultCenter.postNotificationName(self, object: object, userInfo: )
  else
    NSNotificationCenter.defaultCenter.postNotificationName(self, object: object)
  end
end

#remove!Object

This method will be removed in iOS 9



34
35
36
37
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 34

def remove!
  SugarCube.log('Warning: SugarCube\'s String#remove! method has been deprecated in favor of String#remove_file!')
  self.remove_file!
end

#remove_accentsObject



31
32
33
34
35
36
37
# File 'lib/cocoa/sugarcube-foundation/nsstring.rb', line 31

def remove_accents
  # removes diacritics by using a lossy conversion
  ascii = self.dataUsingEncoding(NSASCIIStringEncoding, allowLossyConversion: true)

  # turn it back into a string
  return NSString.alloc.initWithData(ascii, encoding: NSASCIIStringEncoding)
end

#remove_file!Object



36
37
38
39
40
41
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 36

def remove_file!
  ptr = Pointer.new(:id)
  path = self.hasPrefix('/') ? self : self.document_path
  NSFileManager.defaultManager.removeItemAtPath(path, error:ptr)
  ptr[0]
end

#remove_observer(target, object = nil) ⇒ Object



31
32
33
# File 'lib/cocoa/sugarcube-notifications/notifications.rb', line 31

def remove_observer(target, object=nil)
  NSNotificationCenter.defaultCenter.removeObserver(target, name: self, object: object)
end

#resourceObject

This method will be removed in iOS 9



40
41
42
43
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 40

def resource
  SugarCube.log('Warning: SugarCube\'s String#resource method has been deprecated in favor of String#resource_path')
  self.resource_path
end

#resource_exists?Boolean

Returns:

  • (Boolean)


50
51
52
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 50

def resource_exists?
  self.resource_path.file_exists?
end

#resource_pathObject



43
44
45
46
47
48
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 43

def resource_path
  @@sugarcube_resources ||= NSBundle.mainBundle.resourcePath
  return self if self.hasPrefix(@@sugarcube_resources)

  @@sugarcube_resources.stringByAppendingPathComponent(self)
end

#resource_urlObject



54
55
56
57
58
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 54

def resource_url
  a = self.split('.')
  ext = a.pop if a.size >= 2
  NSBundle.mainBundle.URLForResource(a.join("."), withExtension:ext)
end

#setterObject



25
26
27
# File 'lib/all/sugarcube-unholy/ivar.rb', line 25

def setter
  "#{self}="
end

#skcolor(alpha = nil) ⇒ Object



20
21
22
# File 'lib/osx/sugarcube-color/nsstring.rb', line 20

def skcolor(alpha=nil)
  nscolor(alpha)
end

#temporaryObject

This method will be removed in iOS 9



22
23
24
25
# File 'lib/cocoa/sugarcube-files/nsstring_deprecated.rb', line 22

def temporary
  SugarCube.log('Warning: SugarCube\'s String#temporary method has been deprecated in favor of String#temporary_path')
  self.temporary_path
end

#temporary_pathObject



24
25
26
27
28
29
# File 'lib/cocoa/sugarcube-files/nsstring.rb', line 24

def temporary_path
  @@sugarcube_temporary ||= NSTemporaryDirectory()
  return self if self.hasPrefix(@@sugarcube_temporary)

  @@sugarcube_temporary.stringByAppendingPathComponent(self)
end

#to_number(style = NSNumberFormatterDecimalStyle) ⇒ Object



8
9
10
11
12
13
14
15
# File 'lib/cocoa/sugarcube-numbers/nsstring.rb', line 8

def to_number(style=NSNumberFormatterDecimalStyle)
  if style.respond_to?(:nsnumberstyle)
    style = style.nsnumberstyle
  end
  number_formatter = NSNumberFormatter.new
  number_formatter.numberStyle = style
  number_formatter.numberFromString(self)
end

#uicolor(alpha = nil) ⇒ UIColor

Returns:



4
5
6
7
8
9
10
11
12
13
14
# File 'lib/ios/sugarcube-color/nsstring.rb', line 4

def uicolor(alpha=nil)
  if self[0,1] == '#'
    if self.length == 4
      return (self[1] * 2 + self[2] * 2 + self[3] * 2).to_i(16).uicolor(alpha)
    end
    return self[1..-1].to_i(16).uicolor(alpha)
  end

  img = UIImage.imageNamed(self)
  img && img.uicolor(alpha)
end

#uifont(size = nil) ⇒ UIFont

Returns:



11
12
13
14
# File 'lib/ios/sugarcube-ui/nsstring.rb', line 11

def uifont(size=nil)
  size ||= UIFont.systemFontSize
  UIFont.fontWithName(self, size:size)
end

#uiimageUIImage

Returns:



4
5
6
7
8
# File 'lib/ios/sugarcube-ui/nsstring.rb', line 4

def uiimage
  UIImage.imageNamed(self).tap do |retval|
    NSLog("No image named #{self}") unless retval
  end
end

#uiimageviewUIImageView

Returns:

  • (UIImageView)


30
31
32
# File 'lib/ios/sugarcube-ui/nsstring.rb', line 30

def uiimageview
  self.uiimage.uiimageview
end

#uilabel(font = nil) ⇒ UILabel

Parameters:

  • font (UIFont) (defaults to: nil)

    Optional, defaults to UIFont.systemFontOfSize(UIFont.systemFontSize)

Returns:



18
19
20
21
22
23
24
25
26
27
# File 'lib/ios/sugarcube-ui/nsstring.rb', line 18

def uilabel(font=nil)
  font ||= :system.uifont(UIFont.labelFontSize)
  size = self.sizeWithFont(font)
  label = UILabel.alloc.initWithFrame([[0, 0], size])
  label.text = self
  label.font = font
  # why isn't this just the default!?
  label.backgroundColor = :clear.uicolor
  return label
end

#underline(underline_style = nil) ⇒ Object



18
19
20
21
# File 'lib/ios/sugarcube-attributedstring/nsattributedstring.rb', line 18

def underline(underline_style=nil)
  underline_style ||= NSUnderlineStyleSingle
  nsattributedstring({ NSUnderlineStyleAttributeName => underline_style })
end

#unescape_urlObject



23
24
25
26
27
28
29
# File 'lib/cocoa/sugarcube-foundation/nsstring.rb', line 23

def unescape_url
  CFURLCreateStringByReplacingPercentEscapes(
          nil,
          self,
          ""
          )
end