Vega strike Python Modules doc  0.5.1
Documentation of the " Modules " folder of Vega strike
 All Data Structures Namespaces Files Functions Variables
Functions | Variables
stringold Namespace Reference

Functions

def lower
 
def upper
 
def swapcase
 
def strip
 
def lstrip
 
def rstrip
 
def split
 
def join
 
def index
 
def rindex
 
def count
 
def find
 
def rfind
 
def atof
 
def atoi
 
def atol
 
def ljust
 
def rjust
 
def center
 
def zfill
 
def expandtabs
 
def translate
 
def capitalize
 
def capwords
 
def maketrans
 
def replace
 

Variables

string whitespace = ' \t\n\r\v\f'
 
string lowercase = 'abcdefghijklmnopqrstuvwxyz'
 
string uppercase = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
 
 letters = lowercase+uppercase
 
string digits = '0123456789'
 
string hexdigits = digits+'abcdef'
 
string octdigits = '01234567'
 
string _idmap = ''
 
 index_error = ValueError
 
 atoi_error = ValueError
 
 atof_error = ValueError
 
 atol_error = ValueError
 
 splitfields = split
 
 joinfields = join
 
 _apply = apply
 
 _float = float
 
 _int = int
 
 _long = long
 
tuple _StringType = type('')
 
 _idmapL = None
 

Function Documentation

def stringold.atof (   s) 
atof(s) -> float

Return the floating point number represented by the string s.

Definition at line 194 of file stringold.py.

References _float.

194 
195 def atof(s):
196  """atof(s) -> float
197 
198  Return the floating point number represented by the string s.
199 
200  """
201  if type(s) == _StringType:
202  return _float(s)
203  else:
204  raise TypeError('argument 1: expected string, %s found' %
205  type(s).__name__)
206 
# Convert string to integer
def stringold.atoi (   args) 
atoi(s [,base]) -> int

Return the integer represented by the string s in the given
base, which defaults to 10.  The string s must consist of one
or more digits, possibly preceded by a sign.  If base is 0, it
is chosen from the leading characters of s, 0 for octal, 0x or
0X for hexadecimal.  If base is 16, a preceding 0x or 0X is
accepted.

Definition at line 207 of file stringold.py.

References _apply.

207 
208 def atoi(*args):
209  """atoi(s [,base]) -> int
210 
211  Return the integer represented by the string s in the given
212  base, which defaults to 10. The string s must consist of one
213  or more digits, possibly preceded by a sign. If base is 0, it
214  is chosen from the leading characters of s, 0 for octal, 0x or
215  0X for hexadecimal. If base is 16, a preceding 0x or 0X is
216  accepted.
217 
218  """
219  try:
220  s = args[0]
221  except IndexError:
222  raise TypeError('function requires at least 1 argument: %d given' %
223  len(args))
224  # Don't catch type error resulting from too many arguments to int(). The
225  # error message isn't compatible but the error type is, and this function
226  # is complicated enough already.
227  if type(s) == _StringType:
228  return _apply(_int, args)
229  else:
230  raise TypeError('argument 1: expected string, %s found' %
231  type(s).__name__)
232 
233 
# Convert string to long integer
def stringold.atol (   args) 
atol(s [,base]) -> long

Return the long integer represented by the string s in the
given base, which defaults to 10.  The string s must consist
of one or more digits, possibly preceded by a sign.  If base
is 0, it is chosen from the leading characters of s, 0 for
octal, 0x or 0X for hexadecimal.  If base is 16, a preceding
0x or 0X is accepted.  A trailing L or l is not accepted,
unless base is 0.

Definition at line 234 of file stringold.py.

References _apply.

234 
235 def atol(*args):
236  """atol(s [,base]) -> long
237 
238  Return the long integer represented by the string s in the
239  given base, which defaults to 10. The string s must consist
240  of one or more digits, possibly preceded by a sign. If base
241  is 0, it is chosen from the leading characters of s, 0 for
242  octal, 0x or 0X for hexadecimal. If base is 16, a preceding
243  0x or 0X is accepted. A trailing L or l is not accepted,
244  unless base is 0.
245 
246  """
247  try:
248  s = args[0]
249  except IndexError:
250  raise TypeError('function requires at least 1 argument: %d given' %
251  len(args))
252  # Don't catch type error resulting from too many arguments to long(). The
253  # error message isn't compatible but the error type is, and this function
254  # is complicated enough already.
255  if type(s) == _StringType:
256  return _apply(_long, args)
257  else:
258  raise TypeError('argument 1: expected string, %s found' %
259  type(s).__name__)
260 
261 
# Left-justify a string
def stringold.capitalize (   s) 
capitalize(s) -> string

Return a copy of the string s with only its first character
capitalized.

Definition at line 356 of file stringold.py.

356 
357 def capitalize(s):
358  """capitalize(s) -> string
359 
360  Return a copy of the string s with only its first character
361  capitalized.
362 
363  """
364  return s.capitalize()
365 
366 # Capitalize the words in a string, e.g. " aBc dEf " -> "Abc Def".
# See also regsub.capwords().
def stringold.capwords (   s,
  sep = None 
) 
capwords(s, [sep]) -> string

Split the argument into words using split, capitalize each
word using capitalize, and join the capitalized words using
join. Note that this replaces runs of whitespace characters by
a single space.

Definition at line 367 of file stringold.py.

References join().

367 
368 def capwords(s, sep=None):
369  """capwords(s, [sep]) -> string
370 
371  Split the argument into words using split, capitalize each
372  word using capitalize, and join the capitalized words using
373  join. Note that this replaces runs of whitespace characters by
374  a single space.
375 
376  """
377  return join(map(capitalize, s.split(sep)), sep or ' ')
378 
# Construct a translation string
def stringold.center (   s,
  width 
) 
center(s, width) -> string

Return a center version of s, in a field of the specified
width. padded with spaces as needed.  The string is never
truncated.

Definition at line 288 of file stringold.py.

288 
289 def center(s, width):
290  """center(s, width) -> string
291 
292  Return a center version of s, in a field of the specified
293  width. padded with spaces as needed. The string is never
294  truncated.
295 
296  """
297  n = width - len(s)
298  if n <= 0: return s
299  half = n/2
300  if n%2 and width%2:
301  # This ensures that center(center(s, i), j) = center(s, j)
302  half = half+1
303  return ' '*half + s + ' '*(n-half)
304 
305 # Zero-fill a number, e.g., (12, 3) --> '012' and (-3, 3) --> '-03'
306 # Decadent feature: the argument may be a string or a number
# (Use of this is deprecated; it should be a string as with ljust c.s.)
def stringold.count (   s,
  args 
) 
count(s, sub[, start[,end]]) -> int

Return the number of occurrences of substring sub in string
s[start:end].  Optional arguments start and end are
interpreted as in slice notation.

Definition at line 151 of file stringold.py.

References _apply.

151 
152 def count(s, *args):
153  """count(s, sub[, start[,end]]) -> int
154 
155  Return the number of occurrences of substring sub in string
156  s[start:end]. Optional arguments start and end are
157  interpreted as in slice notation.
158 
159  """
160  return _apply(s.count, args)
161 
# Find substring, return -1 if not found
def stringold.expandtabs (   s,
  tabsize = 8 
) 
expandtabs(s [,tabsize]) -> string

Return a copy of the string s with all tab characters replaced
by the appropriate number of spaces, depending on the current
column, and the tabsize (default 8).

Definition at line 325 of file stringold.py.

325 
326 def expandtabs(s, tabsize=8):
327  """expandtabs(s [,tabsize]) -> string
328 
329  Return a copy of the string s with all tab characters replaced
330  by the appropriate number of spaces, depending on the current
331  column, and the tabsize (default 8).
332 
333  """
334  res = line = ''
335  for c in s:
336  if c == '\t':
337  c = ' '*(tabsize - len(line) % tabsize)
338  line = line + c
339  if c == '\n':
340  res = res + line
341  line = ''
342  return res + line
343 
# Character translation through look-up table.
def stringold.find (   s,
  args 
) 
find(s, sub [,start [,end]]) -> in

Return the lowest index in s where substring sub is found,
such that sub is contained within s[start,end].  Optional
arguments start and end are interpreted as in slice notation.

Return -1 on failure.

Definition at line 162 of file stringold.py.

References _apply.

162 
163 def find(s, *args):
164  """find(s, sub [,start [,end]]) -> in
165 
166  Return the lowest index in s where substring sub is found,
167  such that sub is contained within s[start,end]. Optional
168  arguments start and end are interpreted as in slice notation.
169 
170  Return -1 on failure.
171 
172  """
173  return _apply(s.find, args)
174 
# Find last substring, return -1 if not found
def stringold.index (   s,
  args 
) 
index(s, sub [,start [,end]]) -> int

Like find but raises ValueError when the substring is not found.

Definition at line 133 of file stringold.py.

References _apply.

133 
134 def index(s, *args):
135  """index(s, sub [,start [,end]]) -> int
136 
137  Like find but raises ValueError when the substring is not found.
138 
139  """
140  return _apply(s.index, args)
141 
# Find last substring, raise exception if not found
def stringold.join (   words,
  sep = ' ' 
) 
join(list [,sep]) -> string

Return a string composed of the words in list, with
intervening occurrences of sep.  The default separator is a
single space.

(joinfields and join are synonymous)

Definition at line 116 of file stringold.py.

116 
117 def join(words, sep = ' '):
118  """join(list [,sep]) -> string
119 
120  Return a string composed of the words in list, with
121  intervening occurrences of sep. The default separator is a
122  single space.
123 
124  (joinfields and join are synonymous)
125 
126  """
return sep.join(words)
def stringold.ljust (   s,
  width 
) 
ljust(s, width) -> string

Return a left-justified version of s, in a field of the
specified width, padded with spaces as needed.  The string is
never truncated.

Definition at line 262 of file stringold.py.

262 
263 def ljust(s, width):
264  """ljust(s, width) -> string
265 
266  Return a left-justified version of s, in a field of the
267  specified width, padded with spaces as needed. The string is
268  never truncated.
269 
270  """
271  n = width - len(s)
272  if n <= 0: return s
273  return s + ' '*n
274 
# Right-justify a string
def stringold.lower (   s) 
lower(s) -> string

Return a copy of the string s converted to lowercase.

Definition at line 43 of file stringold.py.

43 
44 def lower(s):
45  """lower(s) -> string
46 
47  Return a copy of the string s converted to lowercase.
48 
49  """
50  return s.lower()
51 
# Convert lower case letters to UPPER CASE
def stringold.lstrip (   s) 
lstrip(s) -> string

Return a copy of the string s with leading whitespace removed.

Definition at line 81 of file stringold.py.

81 
82 def lstrip(s):
83  """lstrip(s) -> string
84 
85  Return a copy of the string s with leading whitespace removed.
86 
87  """
88  return s.lstrip()
89 
# Strip trailing tabs and spaces
def stringold.maketrans (   fromstr,
  tostr 
) 
maketrans(frm, to) -> string

Return a translation table (a string of 256 bytes long)
suitable for use in string.translate.  The strings frm and to
must be of the same length.

Definition at line 380 of file stringold.py.

References join().

380 
381 def maketrans(fromstr, tostr):
382  """maketrans(frm, to) -> string
383 
384  Return a translation table (a string of 256 bytes long)
385  suitable for use in string.translate. The strings frm and to
386  must be of the same length.
387 
388  """
389  if len(fromstr) != len(tostr):
390  raise ValueError, "maketrans arguments must have same length"
391  global _idmapL
392  if not _idmapL:
393  _idmapL = map(None, _idmap)
394  L = _idmapL[:]
395  fromstr = map(ord, fromstr)
396  for i in range(len(fromstr)):
397  L[fromstr[i]] = tostr[i]
398  return join(L, "")
399 
# Substring replacement (global)
def stringold.replace (   s,
  old,
  new,
  maxsplit = 0 
) 
replace (str, old, new[, maxsplit]) -> string

Return a copy of string str with all occurrences of substring
old replaced by new. If the optional argument maxsplit is
given, only the first maxsplit occurrences are replaced.

Definition at line 400 of file stringold.py.

400 
401 def replace(s, old, new, maxsplit=0):
402  """replace (str, old, new[, maxsplit]) -> string
403 
404  Return a copy of string str with all occurrences of substring
405  old replaced by new. If the optional argument maxsplit is
406  given, only the first maxsplit occurrences are replaced.
407 
408  """
409  return s.replace(old, new, maxsplit)
410 
411 
412 # XXX: transitional
413 #
414 # If string objects do not have methods, then we need to use the old string.py
415 # library, which uses strop for many more things than just the few outlined
416 # below.
417 try:
''.upper
def stringold.rfind (   s,
  args 
) 
rfind(s, sub [,start [,end]]) -> int

Return the highest index in s where substring sub is found,
such that sub is contained within s[start,end].  Optional
arguments start and end are interpreted as in slice notation.

Return -1 on failure.

Definition at line 175 of file stringold.py.

References _apply.

175 
176 def rfind(s, *args):
177  """rfind(s, sub [,start [,end]]) -> int
178 
179  Return the highest index in s where substring sub is found,
180  such that sub is contained within s[start,end]. Optional
181  arguments start and end are interpreted as in slice notation.
182 
183  Return -1 on failure.
184 
185  """
186  return _apply(s.rfind, args)
187 
# for a bit of speed
def stringold.rindex (   s,
  args 
) 
rindex(s, sub [,start [,end]]) -> int

Like rfind but raises ValueError when the substring is not found.

Definition at line 142 of file stringold.py.

References _apply.

142 
143 def rindex(s, *args):
144  """rindex(s, sub [,start [,end]]) -> int
145 
146  Like rfind but raises ValueError when the substring is not found.
147 
148  """
149  return _apply(s.rindex, args)
150 
# Count non-overlapping occurrences of substring
def stringold.rjust (   s,
  width 
) 
rjust(s, width) -> string

Return a right-justified version of s, in a field of the
specified width, padded with spaces as needed.  The string is
never truncated.

Definition at line 275 of file stringold.py.

275 
276 def rjust(s, width):
277  """rjust(s, width) -> string
278 
279  Return a right-justified version of s, in a field of the
280  specified width, padded with spaces as needed. The string is
281  never truncated.
282 
283  """
284  n = width - len(s)
285  if n <= 0: return s
286  return ' '*n + s
287 
# Center a string
def stringold.rstrip (   s) 
rstrip(s) -> string

Return a copy of the string s with trailing whitespace
removed.

Definition at line 90 of file stringold.py.

90 
91 def rstrip(s):
92  """rstrip(s) -> string
93 
94  Return a copy of the string s with trailing whitespace
95  removed.
96 
97  """
98  return s.rstrip()
99 
100 
# Split a string into a list of space/tab-separated words
def stringold.split (   s,
  sep = None,
  maxsplit = 0 
) 
split(str [,sep [,maxsplit]]) -> list of strings

Return a list of the words in the string s, using sep as the
delimiter string.  If maxsplit is nonzero, splits into at most
maxsplit words If sep is not specified, any whitespace string
is a separator.  Maxsplit defaults to 0.

(split and splitfields are synonymous)

Definition at line 101 of file stringold.py.

101 
102 def split(s, sep=None, maxsplit=0):
103  """split(str [,sep [,maxsplit]]) -> list of strings
104 
105  Return a list of the words in the string s, using sep as the
106  delimiter string. If maxsplit is nonzero, splits into at most
107  maxsplit words If sep is not specified, any whitespace string
108  is a separator. Maxsplit defaults to 0.
109 
110  (split and splitfields are synonymous)
111 
112  """
return s.split(sep, maxsplit)
def stringold.strip (   s) 
strip(s) -> string

Return a copy of the string s with leading and trailing
whitespace removed.

Definition at line 71 of file stringold.py.

71 
72 def strip(s):
73  """strip(s) -> string
74 
75  Return a copy of the string s with leading and trailing
76  whitespace removed.
77 
78  """
79  return s.strip()
80 
# Strip leading tabs and spaces
def stringold.swapcase (   s) 
swapcase(s) -> string

Return a copy of the string s with upper case characters
converted to lowercase and vice versa.

Definition at line 61 of file stringold.py.

61 
62 def swapcase(s):
63  """swapcase(s) -> string
64 
65  Return a copy of the string s with upper case characters
66  converted to lowercase and vice versa.
67 
68  """
69  return s.swapcase()
70 
# Strip leading and trailing tabs and spaces
def stringold.translate (   s,
  table,
  deletions = "" 
) 
translate(s,table [,deletechars]) -> string

Return a copy of the string s, where all characters occurring
in the optional argument deletechars are removed, and the
remaining characters have been mapped through the given
translation table, which must be a string of length 256.

Definition at line 344 of file stringold.py.

344 
345 def translate(s, table, deletions=""):
346  """translate(s,table [,deletechars]) -> string
347 
348  Return a copy of the string s, where all characters occurring
349  in the optional argument deletechars are removed, and the
350  remaining characters have been mapped through the given
351  translation table, which must be a string of length 256.
352 
353  """
354  return s.translate(table, deletions)
355 
# Capitalize a string, e.g. "aBc dEf" -> "Abc def".
def stringold.upper (   s) 
upper(s) -> string

Return a copy of the string s converted to uppercase.

Definition at line 52 of file stringold.py.

52 
53 def upper(s):
54  """upper(s) -> string
55 
56  Return a copy of the string s converted to uppercase.
57 
58  """
59  return s.upper()
60 
# Swap lower case letters and UPPER CASE
def stringold.zfill (   x,
  width 
) 
zfill(x, width) -> string

Pad a numeric string x with zeros on the left, to fill a field
of the specified width.  The string x is never truncated.

Definition at line 307 of file stringold.py.

307 
308 def zfill(x, width):
309  """zfill(x, width) -> string
310 
311  Pad a numeric string x with zeros on the left, to fill a field
312  of the specified width. The string x is never truncated.
313 
314  """
315  if type(x) == type(''): s = x
316  else: s = `x`
317  n = len(s)
318  if n >= width: return s
319  sign = ''
320  if s[0] in ('-', '+'):
321  sign, s = s[0], s[1:]
322  return sign + '0'*(width-n) + s
323 
324 # Expand tabs in a string.
# Doesn't take non-printing chars into account, but does understand \n.

Variable Documentation

_apply = apply

Definition at line 130 of file stringold.py.

_float = float

Definition at line 188 of file stringold.py.

string _idmap = ''

Definition at line 32 of file stringold.py.

_idmapL = None

Definition at line 379 of file stringold.py.

_int = int

Definition at line 189 of file stringold.py.

_long = long

Definition at line 190 of file stringold.py.

tuple _StringType = type('')

Definition at line 191 of file stringold.py.

atof_error = ValueError

Definition at line 39 of file stringold.py.

atoi_error = ValueError

Definition at line 38 of file stringold.py.

atol_error = ValueError

Definition at line 40 of file stringold.py.

string digits = '0123456789'

Definition at line 27 of file stringold.py.

string hexdigits = digits+'abcdef'

Definition at line 28 of file stringold.py.

index_error = ValueError

Definition at line 37 of file stringold.py.

joinfields = join

Definition at line 127 of file stringold.py.

letters = lowercase+uppercase

Definition at line 26 of file stringold.py.

string lowercase = 'abcdefghijklmnopqrstuvwxyz'

Definition at line 24 of file stringold.py.

string octdigits = '01234567'

Definition at line 29 of file stringold.py.

splitfields = split

Definition at line 113 of file stringold.py.

string uppercase = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

Definition at line 25 of file stringold.py.

string whitespace = ' \t\n\r\v\f'

Definition at line 23 of file stringold.py.